CodeX 是 OpenAI 推出的 AI 编程助手支持 CLI命令行、IDE 插件和云端三种使用方式集代码生成、解释、调试、重构于一体。随着 GPT-5-Codex 模型的发布其编程能力大幅提升已成为国内开发者的重要工具。本文将手把手教你如何在国内环境下安装、配置并高效使用 CodeX。一、准备工作1. 系统要求操作系统Windows 10/11、macOS 12、LinuxUbuntu/Debian/CentOS 等Node.js版本 ≥ 18推荐 ≥ 22Git可选但推荐用于拉取项目或与 GitHub 集成2. 账号准备CodeX 官方版本需ChatGPT Plus / Pro / Team 订阅账号才能直接登录使用 。若你没有 Plus 账号也可通过国内中转平台如gaccode.com、wolfai.top、api.kl-api.info获取 API Key 使用部分平台还提供免费额度 。 提示国内用户建议优先注册 CodeX 中国镜像站输入邀请码DZFW8J可获得价值 $100 的使用额度 。二、安装 CodeX CLI方法一通过 npm 安装推荐# 1. 检查 Node.js 版本node -v# 应 ≥ v18推荐 v22# 2. 安装 CodeX CLInpm install -g openai/codex# 国内网络慢使用淘宝镜像加速npm install -g openai/codex --registryhttps://registry.npmmirror.com# 3. 验证安装 codex --version # 如输出 0.42.0 或更高即成功方法二通过包管理器macOS/Linux# macOS (Homebrew)brew install codex# Linux (Chocolatey 或手动二进制)# 参考 GitHub Releases 下载对应平台文件三、配置 API 密钥非 Plus 用户必看如果你没有 ChatGPT Plus 账号需手动配置 API Key 和中转地址。步骤 1获取 API Key访问任一中转平台如 wolfai.top 或 api.kl-api.info注册后在「令牌管理」中创建一个无限额度、永不过期的密钥 。步骤 2创建配置文件Windows 路径C:\Users\你的用户名\.codex\macOS/Linux 路径~/.codex/1. 创建auth.json{ OPENAI_API_KEY: sk-你的实际API密钥 }2. 创建config.toml以wolfai.top为例model_provider wolfaimodel gpt-5-codexmodel_reasoning_effort highdisable_response_storage truepreferred_auth_method apikey[model_providers.wolfai]name wolfaibase_url https://wolfai.top/v1wire_api responses⚠️ 注意不同中转平台的base_url和model_provider名称不同请按平台文档填写。四、首次运行与授权情况 A你有 ChatGPT Plus 账号直接在终端运行codex系统会自动弹出浏览器使用你的 ChatGPT 账号登录授权后 Token 会自动保存到~/.codex/token无需手动配置 API Key 。情况 B你使用中转 API确保auth.json和config.toml已正确配置然后运行codex若提示 “No Active Subscription”请邮件联系gaccode163.com获取权限 。五、常用功能与技巧1. 设置中文回复在~/.codex/目录下创建AGENTS.md文件mkdir -p ~/.codex printf Always respond in Chinese-simplified\n ~/.codex/AGENTS.md此后 CodeX 将默认使用简体中文回复 。2. 常用命令示例场景命令效果快速生成代码codex 写一个下载文件的 Python 脚本3 秒输出可运行代码交互式修改codex→ 输入 把脚本改成并发支持 Tab 补全、历史搜索修复报错codex -i error.png 修掉图中报错自动解析截图错误一键测试codex exec 跑通 pytest自动安装依赖并执行测试3. 切换模型/model # 查看当前模型codex --model gpt-5-codex-high # 指定高推理强度模型推荐使用gpt-5-codex系列专为编程优化 。六、IDE 插件使用VS Code打开 VS Code进入扩展市场搜索“Codex”认准OpenAI 官方插件避免山寨版安装后侧边栏会出现 OpenAI Logo点击即可聊天编程支持直接在编辑器中生成/修改代码体验类似 Cursor七、常见问题解决问题解决方案command not found检查 PATH或重启终端401 Unauthorized执行/logout后重新授权403 No Active Subscription升级 Plus 或联系中转平台获取权限连接失败/超时检查代理设置或使用中转 API八、总结CodeX 凭借 GPT-5 强大的代码理解与生成能力已成为国内开发者的高效编程搭档。无论你是通过官方 Plus 账号一键登录还是借助国内中转平台低成本使用都能享受到接近 Claude Code 的体验且封号风险更低、响应更快 。建议日常开发用 IDE 插件批量任务用 CLI复杂项目结合 GitHub 云端模式三位一体效率翻倍现在就安装 CodeX让你的编码效率起飞吧