环境变量

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

• PI_OFFLINE 等变量配置 Pi 进程。
• Pi 设置进程标记，以便子进程将 Pi 识别为启动它们的 Agent。
• 由 LLM 可调用的 Bash 工具运行的命令，会接收描述当前会话的 PI_* 变量。

Provider API Key 变量单独记录在 Providers 中。

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

• AI_AGENT=pi 是通用标记，让工具可以将 Pi 识别为启动该进程的 Agent。
• PI_CODING_AGENT=true 是 Pi 专用标记，让子进程可以检测自身是否在 Pi 内运行。

子进程会继承这两个标记。它们都不是会话级标记，并且通过 SDK 嵌入 Pi 时不会自动设置。

由 Bash 工具运行的命令会接收当前 Pi 会话状态：

每个命令启动时都会解析这些值。因此，切换模型或更改推理级别会影响下一个 Bash 命令，而无需重新启动 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 工具中。它们不会注入到用户输入的 ! 或 !! 命令中。

使用 createBashTool() 创建的 Bash 工具在使用 Pi 注册时默认公开会话环境。注入发生在 spawnHook 之前，因此钩子接收 ctx.env 中的变量：

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

可以独立于 spawn hook 禁用会话元数据：

const bashTool = createBashTool(cwd, {
  exposeSessionEnvironment: false,
  spawnHook: (ctx) => ctx,
});

禁用后，Pi 会删除这些变量的继承值，因此嵌套的 Pi 进程不会公开过时的父会话元数据。

这些变量由 Pi 本身读取：

Providers 中列出了 ANTHROPIC_API_KEY、OPENAI_API_KEY 等 Provider 凭据和云 Provider 配置。