# Codex + 你的供應商

為 Codex 啟動設定指定專屬的模型供應商，或沿用你現有的原生 profile。

## 取得供應商資訊

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

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

已經有 Codex profile 了嗎？可以直接跳到[沿用現有的 Codex profile](https://facadecode.com/zh-tw/docs/providers/codex/#profile)。

## 1. 定義供應商

將這組設定加入 facade.json（參見[Agent 設定](https://facadecode.com/zh-tw/docs/settings/)）。把範例中的 base URL、金鑰與模型 ID 換成你的值：

```json
{
  "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. 檢查供應商設定

| 設定 | 作用 |
| --- | --- |
| `model_provider=work` | 選用由 work 設定所定義的供應商。 |
| `model_providers.work.name` | 為該供應商設定顯示名稱。 |
| `model_providers.work.base_url` | 設定 API base URL。 |
| `model_providers.work.wire_api=responses` | 使用 Responses API 格式。 |
| `model_providers.work.env_key=WORK_API_KEY` | 告訴 Codex 哪個環境變數存放金鑰。 |
| `env.WORK_API_KEY` | 將該金鑰提供給 Codex 程序。 |

每個 `-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 會如何以你目前的設定啟動。

遇到請求錯誤，請看[疑難排解](https://facadecode.com/zh-tw/docs/troubleshooting/)。

## 範例：QwenCloud

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

[QwenCloud 目前的 Codex 設定 ↗](https://docs.qwencloud.com/developer-guides/clients-and-developer-tools/codex)

## 沿用現有的 Codex profile

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

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

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