Appearance

Codex 接入指南 ​

Codex CLI 是 OpenAI 推出的命令行编码助手。通过 Mirrorstages，你可以使用 Codex CLI 接入多种模型。

前提条件 ​

  • 已安装 Codex CLI（npm install -g @openai/codex）
  • 已获取 Mirrorstages API Key（参考 API Keys 说明）

配置方式 ​

1. 修改配置文件 ​

编辑 ~/.codex/config.toml，写入以下内容：

toml
model_provider = "mirrorstages"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.mirrorstages]
name = "mirrorstages"
base_url = "https://api.mirrorstages.com/openai/v1"
wire_api = "responses"
requires_openai_auth = true

2. 修改认证文件 ​

编辑 ~/.codex/auth.json，写入你的 API Key：

json
{
  "OPENAI_API_KEY": "your-api-key"
}

将 your-api-key 替换为你在 API Keys 页面 获取的 Mirrorstages API Key。

验证配置 ​

运行以下命令确认配置生效：

bash
codex

如果配置正确，Codex CLI 将正常启动并通过 Mirrorstages 代理发送请求。

指定模型 ​

可以在 ~/.codex/config.toml 中修改 model 字段来切换模型：

toml
model = "gpt-5.3-codex"

也可以在运行时通过 --model 参数临时指定：

bash
codex --model claude-sonnet-4-6-20250514

常见问题 ​

配置后无法连接？ ​

  1. 确认 ~/.codex/auth.json 中的 API Key 是否正确
  2. 确认 ~/.codex/config.toml 中的 base_url 配置正确
  3. 确认套餐仍有剩余额度

提示 401 错误？ ​

API Key 无效或已被删除，请到控制台检查或重新创建。

提示额度不足？ ​

当前套餐额度已用尽，请升级套餐或等待下一计费周期刷新。