Codex CLI 如何接入第三方 API
Codex CLI 支持通过配置文件声明模型提供商。接入第三方 OpenAI 兼容 API 时，关键是把 base_url 指向 ClawSocket，并让 CLI 从环境变量读取 Key。这样可以保留 Codex 的终端工作流，同时按需使用不同模型。
方法一：使用 config.toml
Codex 的用户配置通常位于 ~/.codex/config.toml。先创建目录和文件：
mkdir -p ~/.codex
touch ~/.codex/config.toml加入一个 OpenAI 兼容 provider（不同 Codex 版本字段可能略有差异，以下是当前 CLI 常见写法）：
model = "gpt-5"
model_provider = "clawsocket"
[model_providers.clawsocket]
name = "ClawSocket"
base_url = "https://api.clawsocket.com/v1"
env_key = "OPENAI_API_KEY"在配置文件里只写环境变量名，不要写真实 Key。然后在当前终端导出凭证：
export OPENAI_API_KEY="你的 ClawSocket Key"
codex如果你的 Codex 版本使用 api_key_env 而不是 env_key，以 codex --help 或本机示例配置为准替换字段名；这属于 CLI 版本差异，不是 ClawSocket 接口限制。
方法二：临时环境变量
只想快速测试时，可以直接在命令前设置：
OPENAI_API_KEY="你的 ClawSocket Key" codex --model gpt-5这只能解决鉴权，Base URL 仍需在配置文件中设置，或者使用当前版本支持的 OPENAI_BASE_URL 环境变量。启动后输入一个只读任务，例如“列出当前目录的 Python 文件”，检查模型是否真的在响应。
如何确认请求走的是 ClawSocket
查看 Codex 的启动日志或 ClawSocket 控制台请求记录。不要只看模型名称，因为同一个模型名可能由不同 provider 提供。确认不到日志时，可以暂时使用一个项目专用 Key，并观察控制台的最后请求时间和 Token 用量。
模型与权限建议
代码阅读和小幅修改可以使用更快的模型；需要复杂推理时再切换到更强模型。为 Codex 单独创建 Key，限制额度，避免自动化命令在循环或批量任务中消耗过多。Codex 能执行本地命令，任何拥有写权限的 Key 都应视为生产凭证管理。
常见报错
Provider not found：model_provider 名称必须和 [model_providers.<name>] 的名称完全一致。
401：当前 shell 没有 OPENAI_API_KEY，或启动 GUI/IDE 时没有继承终端环境变量。重新从同一个终端启动 Codex。
404：检查 base_url 是否为 https://api.clawsocket.com/v1，不要重复拼接 /v1。
429：降低并发，避免连续重试；可以在 ClawSocket 中切换备用模型。关于退避策略，参见流式输出与错误重试。
完成配置后，建议把最终的 provider 配置提交到团队的安全文档，而不是提交到仓库。需要了解 API 调用成本，可以查看模型 API 价格。
配置字段对照
| 字段 | 示例 | 作用 |
|---|---|---|
model | gpt-5 | 默认使用的模型 ID |
model_provider | clawsocket | 选择 provider 名称 |
base_url | https://api.clawsocket.com/v1 | OpenAI 兼容接口地址 |
env_key | OPENAI_API_KEY | 读取 Key 的环境变量 |
FAQ
Codex CLI 支持任意第三方 API 吗？
前提是服务商提供 Codex 当前版本能理解的 OpenAI 兼容接口。ClawSocket 提供兼容入口，但具体模型 ID 和 provider 字段仍以本机 CLI 版本文档为准。
配置文件里的 Key 应该怎么写？
只写环境变量名，例如 env_key = "OPENAI_API_KEY"，不要写真实密钥。启动前在当前终端 export Key，避免提交到 Git。
为什么 Codex 还是调用了默认 provider？
检查 model_provider 是否与配置块名称完全一致，并确认启动目录和用户配置文件位置没有被其他配置覆盖。
Codex 如何降低 API 成本？
为不同任务设置模型策略，限制自动化循环的最大次数，排除依赖目录，并在 ClawSocket 控制台按项目设置额度。