Codex 手动配置教程【Mac/Linux】

一、准备 AnyAIGC API Key

打开 AnyAIGC
注册或登录 AnyAIGC 账号
进入令牌 / API Key 管理页面
创建新的 API Key
复制 API Key，稍后写入 Codex 配置文件

API Key 通常以 sk- 开头。请勿将 API Key 发布到网页、截图、GitHub 仓库或公开文档中。

二、Mac 安装 Node.js

Mac 用户需要先安装 Node.js。Apple 芯片和 Intel 芯片均可使用以下安装包：

Node.js 下载： node-v24.13.1.pkg

安装时保持默认选项即可，不建议修改安装路径。

三、Mac 安装 Codex

打开 Terminal 终端，执行以下命令：

sudo npm install -g @openai/codex

如果下载较慢或网络异常，可以使用国内 npm 镜像：

sudo npm install -g @openai/codex --registry https://registry.npmmirror.com

安装完成后，检查 Codex 版本：

codex --version

四、Mac 修改 Codex 配置文件

如果你不熟悉 Vim，可以使用其他文本编辑器打开配置文件；也可以先了解 Vim 的基本编辑和保存方式。

编辑 Codex 配置文件：

vim ~/.codex/config.toml

写入以下内容：

model_provider = "codex"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codex]
name = "codex"
base_url = "https://anyaigc.com/v1"
wire_api = "responses"
requires_openai_auth = true

如果 AnyAIGC 后台显示的接口地址与示例不同，请以后台实际接口地址为准。

继续编辑认证文件：

vim ~/.codex/auth.json

写入以下内容，并将 sk-xxx 替换成你的 AnyAIGC API Key：

{
  "OPENAI_API_KEY": "sk-xxx"
}

配置完成后，执行：

codex

五、Linux 安装 Node.js

Ubuntu 安装最新版 Node.js

在终端分别执行以下命令：

sudo apt update
sudo apt install -y curl

curl -fsSL https://deb.nodesource.com/setup_current.x | sudo -E bash -
sudo apt install -y nodejs

node -v
npm -v

CentOS 安装最新版 Node.js

在终端分别执行以下命令：

sudo yum install -y curl

curl -fsSL https://rpm.nodesource.com/setup_current.x | sudo bash -
sudo yum install -y nodejs

node -v
npm -v

六、Linux 安装 Codex

在终端执行以下命令安装 Codex：

sudo npm install -g @openai/codex

如果下载较慢或网络异常，可以使用国内 npm 镜像：

sudo npm install -g @openai/codex --registry https://registry.npmmirror.com

安装完成后，验证版本：

codex --version

七、Linux 修改 Codex 配置文件

编辑配置文件：

vim ~/.codex/config.toml

写入以下内容：

model_provider = "codex"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codex]
name = "codex"
base_url = "https://anyaigc.com/v1"
wire_api = "responses"
requires_openai_auth = true

继续编辑认证文件：

vim ~/.codex/auth.json

写入以下内容，并替换为你的 AnyAIGC API Key：

{
  "OPENAI_API_KEY": "sk-xxx"
}

配置完成后，在终端输入：

codex

八、VS Code / Cursor 插件配置

如果你需要在 VS Code 或 Cursor 中使用 Codex，可以在上述配置完成并确认 codex 能正常回复后，打开对应 IDE，搜索并安装 Codex 插件。

建议先确认终端版本可用，再进行 IDE 插件配置。

常见问题

1. npm 安装失败怎么办？

可以尝试使用 npmmirror 镜像重新安装：

sudo npm install -g @openai/codex --registry https://registry.npmmirror.com

2. 不会使用 Vim 怎么办？

可以使用系统自带文本编辑器打开 ~/.codex/config.toml 和 ~/.codex/auth.json，只要文件内容正确即可。

3. Codex 无法调用模型怎么办？

检查 AnyAIGC API Key 是否正确
确认 AnyAIGC 账号余额充足
确认 base_url 是否与 AnyAIGC 后台接口地址一致
确认 auth.json 是合法 JSON 格式

4. API Key 可以放到公开文章里吗？

不可以。API Key 是敏感凭证，请只在本机配置文件中使用，不要公开展示。