OpenAI Codex CLI 配置指南

核心特性

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

⚡

快速响应

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

🔒

安全沙盒

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

🌐

多语言支持

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

🌏

无需翻墙

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

安装与配置

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

                        
                            # 步骤 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

使用小贴士

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

💡

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

💡

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

💡

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

💡

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

💡

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

💡

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

常见问题

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

🔧 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 和 OPENAI_API_KEY 环境变量（或使用配置文件方式），即可绕过地区限制，无需翻墙。

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

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

🔄 如何更新到最新版本？

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