Codex CLI

准备

安装 Codex CLI，确认模型支持 responses 协议，并复制区域的完整 /v1 Base URL。以下示例仅供阅读与复制，不会修改本机配置。

npm install -g @openai/codex
export CODEFLARE_API_KEY="YOUR_CODEFLARE_KEY"

用户级配置

导入到桌面管理工具

在 API Keys 页面，打开密钥的 更多操作，选择 导入到 CC Switch 或 导入到 Cockpit Tools。选择 Codex 和支持 Responses 的默认模型，生成配置后打开客户端并确认导入。Cockpit Tools 也支持复制 JSON 手动导入。导入使用当前区域的 API 地址。CC Switch 会同时启用余额、密钥额度与用量查询；Cockpit Tools 可在供应商页面自动识别并查询用量。账户余额由所有密钥共享，用量和额度只属于当前密钥，今日用量按 UTC 计算。查询通过 API Key 鉴权的 GET /v1/usage 完成，无需网页登录。查询响应中的 quota 表示账户可用余额，key_quota 单独表示 API Key 的额度。不限额密钥不会让账户余额显示为无限。已导入 CC Switch 的旧查询配置需要重新导入一次，以使用更新后的查询脚本。导入链接和 JSON 包含完整密钥，请妥善保存。

手动配置

将示例合并到用户级 ~/.codex/config.toml；不要覆盖已有配置。替换模型 ID 与区域地址。

~/.codex/config.toml

model = "MODEL_ID"
model_provider = "codeflare"

[model_providers.codeflare]
name = "Codeflare"
base_url = "https://YOUR-REGION.example/v1"
env_key = "CODEFLARE_API_KEY"
wire_api = "responses"
request_max_retries = 0
stream_max_retries = 0

codex

关闭 HTTP 和流式中断自动重试，可减少不确定执行后重放的风险。既有登录或配置可能影响实际连接，请检查运行时使用的 Provider 与模型。

能力检查

客户端工具调用、多模态和推理需要模型及渠道支持。托管工具、WebSocket 等能力不能仅凭 responses 协议推定可用。出现连接错误时核对地址、密钥与模型权限，查看故障排查。配置字段依据 Codex 官方配置参考。

开始使用

开发接入

编程工具

更多

准备

用户级配置

导入到桌面管理工具

手动配置

能力检查

​准备

​用户级配置

​导入到桌面管理工具

​手动配置

​能力检查

准备

用户级配置

导入到桌面管理工具

手动配置

能力检查