Facade CodeCodex 接入其他模型服务
给一套 Codex 启动配置单独指定模型服务，或者直接用你已经有的原生 profile。
先拿到服务商的信息
安装 Codex，准备服务商的基础地址、API 密钥和模型 ID。接口要支持 OpenAI Responses API，只兼容 Chat Completions 不够。
下面的例子新增 Codex · work，不改其他 Codex 条目，也不动 Codex 的全局配置。
已经在用 Codex profile，可以跳到 使用已有的 Codex profile。
1. 定义模型服务
把这段加到 facade.json（见Agent 配置）。基础地址、密钥和模型 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"
}
}
}
}服务 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 会按当前配置怎么启动。
请求报错见排查问题。
服务商示例：QwenCloud
用 QwenCloud Token Plan 的密钥时，基础地址填 https://token-plan.maas.qwencloudapi.com/compatible-mode/v1，保留 wire_api=responses，模型选计划里可用的。按量付费的密钥用所在区域的地址。
使用已有的 Codex profile
已经在用 Codex 自己的 profile，可以通过条目参数选它：
{
"clis": {
"Codex · profile": {
"type": "codex",
"args": [
"--profile",
"work"
]
}
}
}把 work 换成你在用的 profile。服务商配置继续由现有 Codex profile 管理，不需要在 Facade 条目里重复配置。
保存后选择 New Agent 里的 Codex · profile，发一个短任务，并在服务商支持时到用量记录里确认这次请求。