# Codex 接入其他模型服务

给一套 Codex 启动配置单独指定模型服务，或者直接用你已经有的原生 profile。

## 先拿到服务商的信息

安装 Codex，准备服务商的基础地址、API 密钥和模型 ID。接口要支持 OpenAI Responses API，只兼容 Chat Completions 不够。

下面的例子新增 `Codex · work`，不改其他 Codex 条目，也不动 Codex 的全局配置。

已经在用 Codex profile，可以跳到 [使用已有的 Codex profile](https://facadecode.com/zh-cn/docs/providers/codex/#profile)。

## 1. 定义模型服务

把这段加到 facade.json（见[Agent 配置](https://facadecode.com/zh-cn/docs/settings/)）。基础地址、密钥和模型 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"
      }
    }
  }
}
```

服务 ID 统一写 `work`：`model_provider=work` 和每一处 `model_providers.work.…` 都要一致。密钥的变量名 `WORK_API_KEY` 要和 `env_key` 相同。

## 2. 检查服务配置

| 配置项 | 作用 |
| --- | --- |
| `model_provider=work` | 选择由后面这些设置定义的服务。 |
| `model_providers.work.name` | 给这个服务一个显示名称。 |
| `model_providers.work.base_url` | 设置 API 基础地址。 |
| `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-cn/docs/troubleshooting/)。

## 服务商示例：QwenCloud

用 QwenCloud Token Plan 的密钥时，基础地址填 `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。服务商配置继续由现有 Codex profile 管理，不需要在 Facade 条目里重复配置。

保存后选择 **New Agent** 里的 `Codex · profile`，发一个短任务，并在服务商支持时到用量记录里确认这次请求。