Skip to content

Codex 中文使用指南:国内使用方法与上手教程

一句话结论:国内使用 Codex = 一个能正常登录 ChatGPT 的账号 + 一个稳定的网络环境 + 本地装好 CLI 或 IDE 扩展。三者齐了之后,日常使用体验和官方文档描述基本一致。本文于 2026-09-16 实测更新。

为什么"用不了"?

Codex 是 OpenAI 的产品,服务端只对受支持地区开放。国内用户遇到的障碍基本都出在前置条件上,而不是 Codex 本身:

  1. 账号条件不满足:Codex 的使用额度挂在 ChatGPT 订阅(Plus/Pro/Business)下,免费账号额度极少;
  2. 网络环境不稳定:Codex CLI 与服务端保持长连接,网络一抖任务就中断,这是体验差异的最大来源;
  3. 把工具装反了顺序:先折腾配置文件,结果账号根本没登录成功。

所以正确的顺序是:先解决账号 → 再解决网络 → 最后装工具。注册环节不熟悉的先看Codex 注册与登录完整教程

两种使用方式对比

方式形态优点缺点适合谁
方式 A:本地 CLI + IDE 扩展代码在本地跑直接操作你的仓库,延迟低对本地网络要求高有明确开发任务的程序员
方式 B:Codex Web 云端任务在云端沙箱跑不吃本地网络,可并行多任务需要把代码推到 GitHub想后台挂任务的用户

建议从方式 A 开始,本地 CLI 是功能最全、更新最快的入口;网络环境确实不理想的,再考虑方式 B。

方式 A:本地 CLI 上手(推荐)

第一步:安装

任选其一(需要 Node.js 22+ 或对应包管理器):

bash
# npm 安装(跨平台通用)
npm install -g @openai/codex

# macOS 也可用 Homebrew
brew install --cask codex

Windows 用户官方提供了 PowerShell 安装脚本,且从 0.154 版本起支持后台服务进程,体验已明显改善。

第二步:登录

bash
codex

首次运行会弹出登录选项,选择 Sign in with ChatGPT,浏览器完成授权即可。Plus / Pro / Business 订阅的额度直接生效,不需要单独配置 API key。

第三步:在项目目录里使用

bash
cd your-project
codex "把 src/utils 里的日期格式化函数统一抽到一个模块"

日常开发中最有效的三个用法:

  1. 长文档总结 + 可执行清单:把需求文档丢给它,输出任务拆解;
  2. 跨文件重构:描述目标结构,让它自己找相关文件并修改;
  3. 代码审查:让它在提交前检查你的 diff,配合 Git 工作流使用。

相关阅读:Codex 版本演进与功能对比——了解 CLI、IDE、Web 各形态的能力差异。

方式 B:Codex Web 云端

打开 chatgpt.com/codex(登录 ChatGPT 后可见),在网页上提交任务,Codex 在云端沙箱里跑,完成后给你 diff 和 PR。特点:

  • 不吃本地网络,提交完任务可以关掉页面;
  • 适合批量、可并行的任务(比如同时给几个仓库升级依赖);
  • 代码需要在 GitHub 上,私有仓库需要授权。

常见问题 FAQ

Q1:不懂编程能用吗? A:Codex 的定位是编程智能体,虽然交互是自然语言,但产出是代码变更,至少需要能看懂 Git 基本操作。

Q2:网络断断续续还能用吗? A:CLI 对连接质量敏感,频繁中断建议改用 Codex Web 云端方式。

Q3:和直接用 ChatGPT 网页问代码有什么区别? A:ChatGPT 网页是对话,Codex 是能执行、能验证、能提交结果的智能体,会自己跑测试、读仓库、产出可合并的变更。

Q4:中文提示词效果好吗? A:实测中文描述任务没有问题,代码注释和提交信息也可以用中文要求输出。

更新时间

本文最后更新:2026-09-16 · 下次更新:2026-10-01

Codex 中文版博客