Codex 配置教程

适用于 Codex CLI、Codex 桌面端，以及 VS Code / Cursor / Windsurf / Kiro 里的 Codex 扩展。三者共用同一份配置文件，配一次全部生效。

不想手动改文件？

用 星芒AI管理工具 一键写入即可，下面的步骤是手动配置方式。

1. 安装 Codex CLI

先完成 Node.js 安装，然后：

npm install -g @openai/codex

codex --version

显示版本号即安装成功。已经装过的跳过。

2. IDE 扩展（可选）

只用命令行的可以跳过这一步。在 VS Code / Cursor / Windsurf / Kiro 的扩展市场里搜索 Codex 安装：

其他 IDE 同理。

3. 修改配置文件

先关闭正在运行的 Codex（CLI、桌面端、IDE 扩展都关掉）。

打开配置目录：

Windows

按 Win + R，输入 %userprofile%\.codex 回车

macOS / Linux

~/.codex

目录里有两个文件要改：auth.json 和 config.toml，没有就新建。之前配置过的建议先备份一份。

auth.json

只能是下面这个格式，只有 OPENAI_API_KEY 一项：

{
  "OPENAI_API_KEY": "换成你在星芒AI创建的API密钥"
}

config.toml

把接口配置改成下面这样，放在文件开头：

model_provider = "mycodex"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.mycodex]
name = "mycodex"
base_url = "https://api.solov.cc"
wire_api = "responses"
requires_openai_auth = true

只改这四项，其他别动

可以按需修改的只有 model、model_reasoning_effort、model_context_window、model_auto_compact_token_limit。模型名请以 可用渠道 页面为准。

4. 重启

• 用 Codex 桌面端：完全退出后重新打开。

  

• 用 CLI 或 IDE 扩展：重启终端 / IDE。

配置成功后的效果：

调不通？

按顺序检查：

1. base_url 是否是 https://api.solov.cc（没有多余的 /v1）；
2. 密钥是否复制完整、是否已启用；
3. 密钥的分组是否包含你填的模型；
4. config.toml 是否保存成功、是否放在文件开头；
5. Codex 是否已经完全重启。

仍然报错，对照 错误码对照 处理，或把完整报错文案发给客服。