環境變數

Pi以三種方式使用環境變數：

• PI_OFFLINE 等變數配置Pi 進程。
• Pi 設定PI_CODING_AGENT，以便子進程可以偵測到它們在Pi 內運行。
• 由 LLM 可呼叫 bash 工具運行的指令接收描述目前會話的 PI_* 變數。

提供者API-關鍵變數單獨記錄在Providers中。

CLI和RPC入口點設定為PI_CODING_AGENT=true。子進程繼承它並且可以使用它來檢測它們是否在Pi內運行。它不是特定於會話的，並且當透過 SDK 嵌入 Pi 時不會自動設定。

由 bash 工具運行的指令接收目前 Pi 會話狀態：

每個命令啟動時都會解析這些值。因此，切換模型或更改推理等級會影響下一個bash指令，而無需重新啟動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 工具中。它們不會注入到使用者輸入的 ! 或 !! 指令中。

使用 createBashTool() 建立的 Bash 工具在使用 Pi 註冊時預設為公開會話環境。注入發生在spawnHook之前，因此鉤子接收ctx.env中的變數：

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

獨立於生成鉤子禁用會話元資料：

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

停用後，Pi 會刪除這些變數的繼承值，因此嵌套的 Pi 進程不會公開過時的父會話元資料。

這些變數由 Pi 本身讀取：

Providers 中列出了ANTHROPIC_API_KEY、OPENAI_API_KEY 等供應商憑證和雲端供應商配置。