跳轉到主要內容
oh-my-pi（指令 omp，也稱為 pi-mono——同一個專案）是一個極簡且可擴充的終端編碼代理。
協定：OpenAI 相容
  • Base URL： https://api.orcarouter.ai/v1（包含 /v1 後綴）

​
安裝

bun install -g @oh-my-pi/pi-coding-agent
需要 bun >= 1.3.14。安裝後的指令為 omp。

​
設定

首先將你的 API 密鑰匯出為環境變量： 
export ORCA_KEY="sk-orca-..."
設定檔：~/.omp/agent/models.yml。 
providers:
  orcarouter:
    baseUrl: https://api.orcarouter.ai/v1
    api: openai-completions
    apiKey: ORCA_KEY
    authHeader: true
    models:
      - id: orcarouter/auto
        name: OrcaRouter Auto
        reasoning: false
        input: [text]
        contextWindow: 200000
        maxTokens: 8192
        compat:
          supportsDeveloperRole: false
          maxTokensField: max_tokens
若你偏好，可將 orcarouter/auto 換成特定模型，例如 anthropic/claude-opus-4.8 或 google/gemini-2.5-flash。模型 ID 一律使用 vendor/model 格式。

​
執行

omp -p --model "orcarouter/orcarouter/auto" "Reply with exactly: OK"
預期輸出：OK。

​
注意事項

  • 需要 bun >= 1.3.14。
  • base_url 必須包含 /v1。
  • apiKey 欄位接受的是環境變量的名稱，而非密鑰本身；搭配 authHeader: true 時會以 Authorization: Bearer <value> 發送。
  • 模型引用使用 provider/model 格式——此處為 orcarouter/orcarouter/auto（provider orcarouter + 模型 ID orcarouter/auto）。
  • 非互動執行請使用 -p。
  • oh-my-pi 與 pi-mono 是同一個專案；兩者的指令都是 omp。

​
啟用思考／推理

上述的預設模型條目帶有 reasoning: false。若要啟用推理並允許 effort 選擇，請在模型上宣告一個 thinking 區塊以及 compat.reasoningEffortMap： 
models:
  - id: anthropic/claude-sonnet-4.6
    name: Claude Sonnet 4.6
    reasoning: true
    thinking:
      minLevel: low
      maxLevel: xhigh
      mode: effort
    input: [text]
    contextWindow: 200000
    maxTokens: 8192
    compat:
      supportsDeveloperRole: false
      supportsReasoningEffort: true
      maxTokensField: max_tokens
      thinkingFormat: openai
      reasoningEffortMap: { low: low, medium: medium, high: high, xhigh: high }
接著在執行時以 model:level 後綴挑選 effort 等級（在 minLevel..maxLevel 範圍內）： 
omp -p --model "orcarouter/anthropic/claude-sonnet-4.6:high" "What is 17*23?"
已驗證：:high 後綴會選定 effort 等級，並對 OrcaRouter 有效。