Codex CLI 配置
Codex CLI(OpenAI 的终端编程智能体)支持通过 ~/.codex/config.toml
配置自定义的 OpenAI 兼容 provider。
配置
保存为 ~/.codex/config.toml:
model = "deepseek-v4-pro"
model_provider = "mafdet"
[model_providers.mafdet]
name = "Mafdet AI"
base_url = "https://api.mafdet.ai/v1"
env_key = "MAFDET_API_KEY"
wire_api = "chat"
然后在运行 codex 的 shell 里导出 Key:
export MAFDET_API_KEY="sk-mafdet-xxxxxxxxxxxxxxxx"
env_key指定存放 Key 的环境变量名 —— 配置文件本身永远不含密钥wire_api = "chat"让 Codex 走 Chat Completions 协议(网关原生支持)model填 Mafdet AI 的模型 ID(见 模型总览)
也可以在 控制台 → API Keys → 开发者工具 里按所选模型直接生成这个文件。
常见错误
| 现象 | 含义 | 处理 |
|---|---|---|
| 401 | 没有导出 MAFDET_API_KEY | 在运行 codex 的同一个 shell 里导出 |
| 429 | 触发限流(RPM/TPM) | 编程智能体需要高 TPM 限额的 Key |
| model not found | 模型 ID 写错 | 对照 模型总览 |