环境变量

Pi 使用环境变量的方式有三种：

• PI_OFFLINE 等变量用于配置 Pi 进程。
• Pi 会设置进程标记，让子进程能够识别启动它们的 agent。
• LLM 可调用的 shell 工具执行的命令，会收到描述当前会话的 PI_* 变量。

Provider（模型提供方）的 API key 相关变量单独记录在 Providers 中。

进程标记

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

• AI_AGENT=pi 是通用标记，用于让工具识别启动当前进程的 agent 是 Pi。
• PI_CODING_AGENT=true 是 Pi 专用标记，用于让子进程识别自己运行在 Pi 内部。

子进程会继承这两个标记。它们与具体会话无关；通过 SDK 嵌入 Pi 时，也不会自动设置这些标记。

Shell 工具的会话环境

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

这些值会在每条命令启动时解析。因此，切换模型或修改思考级别后，下一条 shell 命令就会使用新值，无需重启 Pi。PI_PROVIDER 和 PI_MODEL 表示 Pi 选中的模型，而不是路由器可能在内部选择的其他上游模型。

如果有人询问当前运行的是哪个模型或 Provider，应检查这些变量，而不是根据系统提示词推断：

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 之前，因此 hook 可以在 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 等 Provider 凭据，以及云 Provider 配置，参见 Providers。