接入 Codex App

Codex App 适合企业研发团队进行代码理解、修改、审查和自动化执行。接入 UWCode 后，企业可以把 Codex 使用的模型调用纳入统一入口、Key 管理、用量统计和日志审计。

重要前提

Codex 的本地配置支持自定义模型 Provider，但生产接入必须满足以下条件：

UWCode 已为租户开启 Codex 所需的 OpenAI Responses API 兼容通道。
员工 Key 已分配可用于 Codex 的模型。
该配置应写入用户级 ~/.codex/config.toml，不要放在项目级 .codex/config.toml 中管理 Provider 凭据。

如果企业当前只启用了 chat/completions 兼容通道，建议先使用 Cline、NextChat 或 Dify 接入；Codex 代理工作流建议等待 Responses 兼容通道启用后再推广。

配置环境变量

先把员工 Key 放入本机环境变量，避免把密钥写入配置文件。

export UWCODE_API_KEY=uwc-xxxxxxxx

如需长期生效，可写入员工使用的 shell 配置文件或企业终端管理系统。

配置 Codex Provider

打开 ~/.codex/config.toml，增加 UWCode Provider。以下示例适用于 UWCode 已启用 Responses API 兼容通道的租户。

model = "gpt-5.5"
model_provider = "uwcode"

[model_providers.uwcode]
name = "UWCode API Gateway"
base_url = "https://api.uwcode.com/v1"
wire_api = "responses"
env_key = "UWCODE_API_KEY"

配置项	说明
`model_provider`	指向自定义 Provider，不覆盖内置 `openai` Provider。
`base_url`	UWCode 的 OpenAI-compatible / Responses 兼容入口。
`wire_api`	Codex Provider 使用的协议。生产接入建议使用 `responses`。
`env_key`	Codex 从该环境变量读取员工 Key。

如果 UWCode 控制台为企业配置了专用模型别名，请将 model 替换为控制台展示的 Codex 可用模型 ID。

验证接入

在新终端中执行：

echo $UWCODE_API_KEY
codex --version
codex -m gpt-5.5

进入 Codex 后发送一个低风险任务，例如“解释当前目录结构”。如果配置正确，UWCode 控制台应出现该员工 Key 的调用记录。

团队管理建议

使用员工 Key 或项目 Key，不要多人共用一个长期 Key。
将 Codex Provider 放在用户级配置中，避免项目仓库携带密钥或 Provider 切换策略。
对高权限仓库设置独立预算和审计策略。
若企业使用私有化部署，将 base_url 替换为内网 UWCode 网关地址。

常见问题

启动后仍使用官方 OpenAI Provider：确认 model_provider = "uwcode" 已写入用户级配置，并重新启动 Codex。
提示 Provider 或 wire API 不支持：确认 Codex 版本较新，且 UWCode 已启用 Responses API 兼容通道。
401 或认证失败：确认 UWCODE_API_KEY 在启动 Codex 的同一个终端会话中可读取。
项目配置不生效：Codex 对会改变 Provider 或凭据的项目级配置有安全限制，应使用用户级配置。

官方依据

OpenAI Codex Manual：自定义模型 Provider、openai_base_url 与 config.toml