Codex + 你的供應商

取得供應商資訊#

安裝 Codex，並取得供應商提供的 base URL、API 金鑰與模型 ID。端點必須支援 OpenAI Responses API；只相容 Chat Completions 並不足夠。

這個範例會新增 Codex · work，不會更動其他 Codex 項目，也不會修改 Codex 的全域設定。

已經有 Codex profile 了嗎？可以直接跳到沿用現有的 Codex profile。

1. 定義供應商#

將這組設定加入 facade.json（參見Agent 設定）。把範例中的 base URL、金鑰與模型 ID 換成你的值：

{
  "clis": {
    "Codex · work": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "args": [
        "-c",
        "model_provider=work",
        "-c",
        "model_providers.work.name=Work",
        "-c",
        "model_providers.work.base_url=https://api.example.com/v1",
        "-c",
        "model_providers.work.wire_api=responses",
        "-c",
        "model_providers.work.env_key=WORK_API_KEY"
      ],
      "env": {
        "WORK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

model_provider=work 與所有 model_providers.work.… 設定都要使用同一個供應商 ID work。存放金鑰的變數名稱 WORK_API_KEY 必須與 env_key 一致。

2. 檢查供應商設定#

每個 -c 都會為使用這個項目啟動的 Agent 設定一個 Codex 選項。

範例把金鑰直接存進 facade.json。如果金鑰原本就放在環境變數裡，請把 env.WORK_API_KEY 設為 ${env:WORK_API_KEY}。Agent 啟動前，編輯器必須已經具備這個變數。

3. 以這組設定啟動 Codex#

儲存 facade.json，選擇 New Agent，然後選擇 Codex · work。用 /model 確認目前選用的模型，再送出一個簡短的專案任務。

如果你的供應商提供用量記錄，請確認請求出現在正確的帳號底下。要檢查啟動設定，請執行 Show Agent Launch 並選擇工作位置。在報告中找到這個項目，就能看到下一個 Agent 會如何以你目前的設定啟動。

遇到請求錯誤，請看疑難排解。

範例：QwenCloud#

若使用 QwenCloud Token Plan 金鑰，base URL 請填 https://token-plan.maas.qwencloudapi.com/compatible-mode/v1，並保留 wire_api=responses。請使用你的方案可用的模型。隨用隨付金鑰則使用對應區域的端點。

QwenCloud 目前的 Codex 設定 ↗

沿用現有的 Codex profile#

如果你已經在用 Codex 的原生 profile，可以透過項目的參數選用它：

{
  "clis": {
    "Codex · profile": {
      "type": "codex",
      "args": [
        "--profile",
        "work"
      ]
    }
  }
}

把 work 換成你使用的 profile。供應商設定請留在該 profile 裡，不要在 Facade 項目中重複填寫。儲存後選擇 New Agent，再選 Codex · profile。送出一個簡短任務，並在供應商有提供的情況下，於用量記錄中確認該請求。