在 Codex CLI 中使用

推荐：用「接入部署」页一键配置

登录控制台后打开左侧的「接入部署」，选好客户端（Codex CLI 和 Codex 桌面版都在里面），复制页面给出的安装指令到终端运行。指令会自动写好密钥和默认模型，真实密钥不会出现在指令文本里。页面上也有“换回官方登录”的还原指令。

想自己掌控配置文件，按下面的手动步骤做。

手动配置

1. 在 config.toml 里加一个 Provider

   文件在 ~/.codex/config.toml（Windows 是 %USERPROFILE%\.codex\config.toml）。先备份，再把下面这段加到文件末尾；已经有 [model_providers.mallow] 的话，直接改原来那段。

   [model_providers.mallow]
   name = "Mallow API"
   base_url = "https://api.mallowapi.com/v1"
   env_key = "MALLOW_API_KEY"
   wire_api = "responses"

2. 新建 profile 文件

   在 config.toml 同一个目录新建 mallow.config.toml，只写和默认配置不同的部分：

   model_provider = "mallow"
   model = "gpt-6-sol"
   # 可选：推理强度，low / medium / high
   # model_reasoning_effort = "medium"

   gpt-6-sol 面向编码和多步骤代理任务；预算紧可以换 gpt-6-luna，日常主力也可以用 gpt-6.1-sol。

3. 设置密钥并启动

   在启动 Codex 的同一个终端里设置环境变量：

   export MALLOW_API_KEY="sk-你的密钥"
   codex --profile mallow

   Windows PowerShell：

   $env:MALLOW_API_KEY = "sk-你的密钥"
   codex --profile mallow

   这样设置的变量只对当前终端有效。想长期生效，把 export 那行写进 ~/.zshrc 或 ~/.bashrc；Windows 可以运行 setx MALLOW_API_KEY "sk-你的密钥"，然后重新打开终端。

想让 codex 默认就用棉花糖 API

不想每次加 --profile，就把这两行放到 config.toml 最上面（在任何 [...] 表之前）：

model_provider = "mallow"
model = "gpt-6-sol"

要换回官方账号时，删掉这两行即可。

从旧教程迁移

以前的写法是在 config.toml 里放 [profiles.mallow] 表。Codex 0.134.0 起 --profile 不再读取这种写法，需要把里面的内容挪到 ~/.codex/mallow.config.toml，再删掉旧的 [profiles.mallow] 表。

验证

启动后发一条简单的消息，例如“列出当前目录的文件”。能正常回复，再到控制台的「使用记录」里确认出现了这次请求和对应模型。

常见问题

• 还在用官方账号：确认启动命令带了 --profile mallow，profile 文件名是 mallow.config.toml，并且放在 config.toml 同一目录。
• 提示找不到 MALLOW_API_KEY：在同一个终端里先设置变量再启动。从图标打开的桌面应用不一定读得到终端里的环境变量，桌面版建议用「接入部署」页配置。
• 404：base_url 只写到 /v1，不要自己加 /responses。
• 协议问题：Codex 只支持 Responses 协议（wire_api 只有 "responses" 一个值），棉花糖 API 支持这个协议。
• 401、403、429：看错误码排查。

字段说明来自 Codex 官方配置参考 和 高级配置。