OpenAI Codex CLI 配置指南

核心特性

Codex CLI 让 AI 编程变得简单而强大

快速响应

基于 GPT 模型，提供快速、精准的代码建议和自动补全

安全沙盒

内置安全执行环境，代码操作需要你的确认，保障项目安全

多语言支持

支持 Python、JavaScript、TypeScript、Go 等所有主流编程语言

无需翻墙

国内直连，无需 VPN 或代理工具。配置环境变量后即可直接使用，告别网络烦恼

🚀 一键配置

一条命令自动完成所有配置，无需手动修改任何文件

curl -sL '/api/setup/codex?key=YOUR_API_KEY' | bash

irm '/api/setup/codex-win?key=YOUR_API_KEY' | iex

脚本将自动完成：
环境检查 → Node.js 版本验证 → 服务端连接测试 → 创建配置文件 → 写入环境变量 → API 连接验证

安装与配置

选择你喜欢的安装方式，几分钟即可完成配置

                        
                            # 步骤 1: 安装 Codex CLI
                            npm install -g @openai/codex
                        
                            # 步骤 2: 配置环境变量
                            export OPENAI_BASE_URL=""
                            
export OPENAI_API_KEY="你的密钥"
                        
                            # 步骤 3: 启动 Codex CLI
                            cd 你的项目目录 && codex

                        
                            # 步骤 1: 安装 Codex CLI
                            brew install --cask codex
                        
                            # 步骤 2: 配置环境变量
                            export OPENAI_BASE_URL=""
                            
export OPENAI_API_KEY="你的密钥"
                        
                            # 步骤 3: 启动 Codex CLI
                            cd 你的项目目录 && codex

                        
                            # 步骤 1: 创建配置文件 ~/.codex/config.toml
                            model_provider = "xingyao"
                        
                            # 步骤 2: 添加自定义提供商
                            [model_providers.xingyao]
                            
name = "星耀云商"
                            
base_url = ""
                            
requires_openai_auth = false
                            
env_key = "OPENAI_API_KEY"
                            
wire_api = "responses"
                        
                            # 步骤 3: 设置密钥并启动
                            export OPENAI_API_KEY="你的密钥"
                            
cd 你的项目目录 && codex
                        
                             重要：如果之前使用过 GitHub Copilot 内置认证，请先清理旧配置
                            cat ~/.codex/config.toml  # 查看是否有旧的 base_url 配置
                            
# 如果看到 base_url = "http://localhost:8080/v1" 或类似旧地址，请用上面的配置覆盖

使用小贴士

一些实用建议，帮助你更好地使用 Codex CLI

环境变量建议写入 ~/.bashrc 或 ~/.zshrc 以永久生效

Codex CLI 默认使用交互式确认模式，使用 --full-auto 启用全自动模式

使用 codex --help 查看所有可用选项和命令

推荐使用 ~/.codex/config.toml 配置文件方式，无需每次设置环境变量，更方便持久化

本平台无需翻墙，国内网络可直接访问。如遇到 403 Country not supported 错误，请确认使用环境变量或配置文件方式连接

需要 Node.js 22+ (codex 命令依赖)

重要提醒：之前使用过 GitHub Copilot 内置认证的用户请注意！
如果你之前通过 codex --provider copilot 或 GitHub 登录方式使用过 Codex CLI，系统可能自动生成了 ~/.codex/config.toml 文件，其中包含 base_url = "http://localhost:8080/v1" 等旧配置。这会覆盖环境变量设置，导致请求直接发往 GitHub 服务器，触发 403 Country not supported 错误。

# 检查是否有旧配置
cat ~/.codex/config.toml

# 如果有旧配置，用以下命令一键修复：
cat > ~/.codex/config.toml << 'EOF'
model_provider = "xingyao"

[model_providers.xingyao]
name = "星耀云商"
base_url = ""
requires_openai_auth = false
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF

常见问题

遇到问题？这里可能有答案

npm install 提示权限错误？

macOS/Linux 用户尝试 sudo npm install -g @openai/codex，或配置 npm 全局安装路径。

配置后提示 API key 无效？

请确认 OPENAI_BASE_URL 包含 /v1 后缀（如 https://example.com/v1），且 API Key 正确无误。

Codex CLI 需要 Node.js 吗？

npm 安装方式需要 Node.js 18+。如果不想安装 Node.js，可以使用 Homebrew 方式安装。

如何更新到最新版本？

npm 用户执行 npm update -g @openai/codex，Homebrew 用户执行 brew upgrade codex。

提示 "403 Country not supported" 怎么办？

这是因为请求直连了 GitHub 官方服务器。常见原因：① 没有设置 OPENAI_BASE_URL 环境变量；② ~/.codex/config.toml 中有旧的 base_url 配置覆盖了环境变量（最常见！）。请先运行 cat ~/.codex/config.toml 检查，如有旧配置请用上方「使用小贴士」中的一键修复命令替换。

配置文件和环境变量哪种方式更好？

推荐使用 ~/.codex/config.toml 配置文件方式。配置一次永久生效，不需要每次打开终端都设置环境变量。两种方式效果相同，选择你习惯的即可。

设置了环境变量还是报 403 错误？

最常见的原因是 ~/.codex/config.toml 中存在旧的配置（如之前使用 GitHub Copilot 内置认证时自动生成的 base_url）。config.toml 中的配置会覆盖环境变量，导致请求绕过本平台直连 GitHub 服务器。解决方法：运行 cat ~/.codex/config.toml 检查，如有旧配置请按上方「使用小贴士」中的修复命令替换为正确配置。