⚡ Codex 配置指南

🔑 API 密钥管理：每位用户最多可创建 1 个 API 密钥，用于 CLI 调用或直接请求 API。

1. 安装 Codex CLI

打开终端（Terminal），运行以下命令将 Codex CLI 全局安装到本机：

npm install -g @openai/codex@latest

安装完成后，执行以下命令验证版本，确认安装成功：

codex --version

2. 配置环境变量

Codex 需要通过环境变量读取 API 密钥以连接镜像服务。请根据需求选择以下任一方式：

方式一：临时设置（仅在当前终端会话中有效）

export OPENAI_API_KEY_0011AI="你的API_KEY"

方式二：永久设置 — Bash 用户（Linux 默认）

echo 'export OPENAI_API_KEY_0011AI="你的API_KEY"' >> ~/.bashrc
source ~/.bashrc

方式二：永久设置 — Zsh 用户（macOS 默认）

echo 'export OPENAI_API_KEY_0011AI="你的API_KEY"' >> ~/.zshrc
source ~/.zshrc

• 请将 "你的API_KEY" 替换为页面顶部生成的实际密钥。
• macOS 默认使用 zsh，Linux 默认使用 bash，请按需选择对应配置文件。

3. 创建 Codex 配置文件

运行以下命令，一键创建配置文件，同时跳过官方登录流程，直接接入镜像服务：

mkdir -p ~/.codex && cat <<'EOF' > ~/.codex/config.toml
model_provider = "aicoding"

[model_providers.aicoding]
name            = "aicoding"
base_url        = "https://aicoding.2233.ai"
env_key         = "OPENAI_API_KEY_0011AI"
wire_api        = "responses"
requires_openai_auth = false
EOF

配置文件将写入 ~/.codex/config.toml，指定使用自定义镜像服务及对应的密钥环境变量。

4. 开始使用 Codex

进入你的项目目录，然后启动 Codex CLI：

cd your-project-folder
codex

Codex 将自动读取当前目录的代码上下文，你可以通过自然语言向它发起提问或请求。

❓ 常见问题

遇到 401 Unauthorized 错误？

此问题通常由 ~/.codex/auth.json 文件引起——该文件保存了此前登录 ChatGPT 官方账号时残留的认证凭证，与镜像服务的鉴权方式冲突。

请执行以下命令删除该文件后重试：

rm -f ~/.codex/auth.json

删除后，Codex 将完全依赖 config.toml 中配置的环境变量密钥进行认证，无需再次登录官方账号。