OpenAI Codex Codex CLI 国内使用教程：手把手教你安装与上手

一、国内用户如何上手 Codex & Codex CLI？完整指南

最近，OpenAI 的 Codex 再次受到关注。作为国内开发者，虽然直接访问可能需注意网络环境，但其最新升级让上手更便捷。半年前，我的主力编码工具是 Cursor；三个月前切换到 Claude Code。但随着一些事件的影响，我开始探索更可靠的选项。

上个月，OpenAI 更新：ChatGPT Plus 用户无需 API Key，直接登录即可使用 Codex CLI。这降低了门槛。全网讨论 Codex 的代码生成能力提升，我安装了 Codex CLI，结果使用体验不错。于是分享这篇教程，专为首次尝试 Codex 的开发者准备。

注意：Codex 为付费服务，需要 ChatGPT Plus 或更高订阅。建议通过官方渠道订阅 ChatGPT Plus。

如果你还没有 ChatGPT 账户，可用邮箱注册。

二、哪些用户可以使用 Codex？

Codex 需要 ChatGPT Plus、Pro 或 Business 订阅。这些用户在网页版已有 Codex 入口：

三种使用方式：网页版、IDE 扩展、CLI 终端。
GPT-5-Codex 专为 CLI、IDE 扩展、云环境和 GitHub 集成设计，支持多种工具。

三、Codex CLI 快速安装教程

3.1 安装 Codex CLI

若本地已安装 NodeJS（版本 ≥ 22），用 NPM 安装：

步骤	命令示例
1. 确认 Node 版本	node -v # 示例：v22.21.10
2. NPM 安装	npm i -g @openai/codex
3. 验证	codex --version # 示例：0.42.0

国内源慢时，可用镜像：

命令
npm i -g @openai/codex --registry=https://registry.npmmirror.com

3.2 安装 Codex 插件版

不习惯 CLI？安装 VSCode 或 Cursor 插件：

直接输入需求，或切换模型（如 GPT-5-Codex high）：

插件版适合新手，提供 GUI 界面。

四、一键启动 Codex CLI

终端输入：

命令
codex

首次弹出网页，用 ChatGPT 账户登录，自动写入 ~/.codex/token。需 Plus 等订阅。

若失败，检查网络连接，重试。

五、常用命令与技巧

5.1 设置中文回复

在 ~/.codex/ 创建 AGENTS.md，内容：“Always respond in Chinese-simplified”。

Mac 命令：

命令
mkdir -p ~/.codex && printf ‘Always respond in Chinese-simplified\n’ > ~/.codex/AGENTS.md

5.2 常用指令

场景	命令示例	效果
直达指令	codex “写一个下载文件的 Python 脚本”	3 秒生成代码。
交互模式	codex ↵ → >> 把脚本改成并发	Tab 补全、历史搜索。
图片报错	codex -i error.png “修掉图中报错”	解析截图。
整仓重构	codex “给 Go 项目加 ctx”	计划 + Diff + 应用。
一键运行	codex exec “跑通 pytest”	安装依赖 + 执行。

六、Codex 与 Claude Code 对比

维度	Codex (GPT-5)	Claude Code (Opus 4.1)
登录门槛	Plus 用户一键登录	需特定账号，门槛较高
响应速度	1.2 秒，高效	2.5 秒，稍慢
上下文	200k+ token，稳	1M，但易失焦
目录结构	精准生成	偶尔合并
工程体验	清晰 Diff	功能多但复杂
审美	简洁	丰富但花哨
价格	绑定 Plus，高性价比	阶梯价
隐私	云端沙盒	本地执行

建议根据需求选择。

七、常见错误解决

7.1 401 Unauthorized

授权过期：

执行 /logout，重启重授权。

7.2 502 或连接失败

检查网络，重试或设置代理：

命令
export HTTPS_PROXY=127.0.0.1:7890

Coding 不仅是写代码，更是找到节奏～

文章来源:OpenAI Codex & Codex CLI 国内使用教程：手把手教你安装与上手