本文为社区中文翻译（依据 MIT 协议），阅读英文原文 →。译文可能滞后于上游更新。

环境变量

• PI_OFFLINE 之类的变量用于配置 Pi 进程本身。
• Pi 会设置进程标记，让子进程能识别出"启动者"是 Pi。
• LLM 可调用的 shell 工具运行的命令会收到描述当前会话的 PI_* 变量。

提供商 API Key 相关变量在提供商中单独说明。

进程标记

CLI 与 RPC 入口会设置两个进程标记：

• AI_AGENT=pi 是通用标记，让工具链识别出启动本进程的智能体是 Pi。
• PI_CODING_AGENT=true 是 Pi 专属标记，让子进程检测到自己运行在 Pi 内部。

子进程继承这两个标记。它们不携带会话信息；通过 SDK 嵌入 Pi 时不会自动设置。

Shell 工具的会话环境

bash 和 powershell 工具运行的命令会收到当前 Pi 会话状态：

这些值在每条命令启动时解析。因此切换模型或推理等级会影响下一条 shell 命令，无需重启 Pi。PI_PROVIDER 和 PI_MODEL 标识 Pi 中选中的模型，而不是路由器内部可能选择的某个上游模型。

被问到当前运行的是哪个模型或提供商时，检查这些变量，而不是从系统提示里推断：

printf '%s/%s\n' "$PI_PROVIDER" "$PI_MODEL"
printf 'reasoning=%s session=%s\n' "$PI_REASONING_LEVEL" "$PI_SESSION_ID"

会话为持久会话时，可以直接查看会话文件：

if [ -n "$PI_SESSION_FILE" ]; then
  tail -n 1 "$PI_SESSION_FILE"
fi

这些变量注入的是 LLM 可调用的 bash 和 powershell 工具；用户输入的 ! 或 !! 命令不会注入。

自定义 Shell 工具

用 createBashTool() 或 createPowerShellTool() 创建的工具注册到 Pi 后，默认会暴露会话环境。注入发生在 spawnHook 之前，钩子里通过 ctx.env 拿到这些变量：

const bashTool = createBashTool(cwd, {
  spawnHook: (ctx) => ({
    ...ctx,
    env: { ...ctx.env, CI: "1" },
  }),
});

独立于 spawn hook 关闭会话元数据：

const powershellTool = createPowerShellTool(cwd, {
  exposeSessionEnvironment: false,
  spawnHook: (ctx) => ctx,
});

关闭后，Pi 会移除继承来的这些变量值，避免嵌套的 Pi 进程暴露过期的父会话元数据。

Pi 进程配置

这些变量由 Pi 自身读取：

ANTHROPIC_API_KEY、OPENAI_API_KEY 等提供商凭据及云提供商配置见提供商。

PI_SERVER_DIR 和 PI_SERVER_ID 只用于仅源码提供的实验性远程外壳，分发的构建中不适用。