CodeX 是 OpenAI 推出的 AI 编程助手，支持 CLI（命令行）、IDE 插件和云端三种使用方式，集代码生成、解释、调试、重构于一体。随着 GPT-5-Codex 模型的发布，其编程能力大幅提升，已成为国内开发者的重要工具。本文将手把手教你如何在国内环境下安装、配置并高效使用 CodeX。

一、准备工作

1. 系统要求

• 操作系统：Windows 10/11、macOS 12+、Linux（Ubuntu/Debian/CentOS 等）
• Node.js：版本 ≥ 18（推荐 ≥ 22）
• Git（可选但推荐）：用于拉取项目或与 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 CLI

npm install -g @openai/codex

# 国内网络慢？使用淘宝镜像加速

npm install -g @openai/codex --registry=https://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 = "wolfai"

model = "gpt-5-codex"

model_reasoning_effort = "high"

disable_response_storage = true

preferred_auth_method = "apikey"

[model_providers.wolfai]

name = "wolfai"

base_url = "https://wolfai.top/v1"

wire_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”，请邮件联系 gaccode@163.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）

1. 打开 VS Code，进入扩展市场
2. 搜索 “Codex”，认准 OpenAI 官方插件（避免山寨版）
3. 安装后侧边栏会出现 OpenAI Logo，点击即可聊天编程
4. 支持直接在编辑器中生成/修改代码，体验类似 Cursor

---

七、常见问题解决

问题	解决方案
command not found	检查 PATH，或重启终端
401 Unauthorized	执行 /logout 后重新授权
403 No Active Subscription	升级 Plus 或联系中转平台获取权限
连接失败/超时	检查代理设置，或使用中转 API

---

八、总结

CodeX 凭借 GPT-5 强大的代码理解与生成能力，已成为国内开发者的高效编程搭档。无论你是通过官方 Plus 账号一键登录，还是借助国内中转平台低成本使用，都能享受到接近 Claude Code 的体验，且封号风险更低、响应更快 。

🌟 建议：日常开发用 IDE 插件，批量任务用 CLI，复杂项目结合 GitHub 云端模式，三位一体，效率翻倍！

现在就安装 CodeX，让你的编码效率起飞吧！