Codex国内使用教程：从安装登录到让AI帮你改项目

前面的国内如何使用 ChatGPT、Codex讲了账号、会员和 API 的区别。这篇单独把 OpenAI Codex 的安装、登录和项目使用讲透。

不少人搜“Codex 国内怎么用”“Codex 怎么安装”“ChatGPT Plus 能不能用 Codex”，其实是想解决同一件事：让 AI 真正读懂自己的项目，修改代码，再把结果跑起来。

这篇按实际操作顺序来。想装 VS Code 插件、用 Windows 命令行、在 Mac 上打开桌面端，或者搞清楚 Codex 充值和 API 费用，都可以找到对应步骤。

信息核对日期：2026 年 11 月 6 日。套餐、模型和界面会更新，涉及价格与开放范围时，以文中链接的官方页面及自己账号显示为准。配图使用 OpenAI 官网公开截图，部分为历史演示界面。

已经能登录，只差会员付款，可以直接看：ChatGPT Plus／Pro 国内充值教程。

一、Codex是什么？和ChatGPT、Claude Code有什么区别？

Codex 是 OpenAI 的 AI 编程智能体，也就是经常说的 Coding Agent。

你给它一个项目和具体目标，它可以在权限允许的范围内读取代码、修改文件、执行命令、运行测试，再根据结果继续修正。它的价值在于把这些步骤连起来，完成一项可检查的开发任务。

比如你可以直接说：

这个登录接口在密码错误时返回500。
先定位异常处理逻辑，给出原因，再修复为正确的业务错误响应。
补充对应测试，运行相关检查，最后告诉我改了哪些文件。

工具或产品	主要使用方式	适合的场景
ChatGPT 普通聊天	提问、上传材料、讨论方案	解释概念、分析报错、讨论代码思路
OpenAI Codex	结合项目文件和开发工具执行任务	读项目、修 Bug、实现功能、代码审查
Claude Code	另一家的编程智能体，需要独立核对账号与计费	类似的项目开发与终端任务
Cursor	以编辑器为中心组织 AI 开发工作	在 IDE 内补全、对话、修改代码
OpenAI API	用密钥将模型接入程序或工具	自建应用、自动化、按调用计费

在 Cursor 里安装 Codex 插件，和购买 Cursor 自身的订阅，是两回事。 Codex 的身份和费用要看它当前使用的登录方式。

如果你也在比较另一条开发路线，可以看Claude Code 国内使用教程。

Codex能做什么？

如果你正在写项目、准备面试，下面几类任务比较实用：

• **读懂陌生项目：**找到启动入口、接口调用链、数据库访问和配置文件。
• **修复问题：**结合报错、复现步骤和代码定位原因，完成小范围修改。
• **实现功能：**按现有工程结构增加接口、页面或脚本。
• **补充测试：**围绕真实边界条件补用例，再执行验证。
• **代码审查：**检查改动中的逻辑漏洞、遗漏分支和兼容性问题。
• **整理开发材料：**生成接口说明、部署步骤、项目结构说明。

它能做多少，取决于你给的上下文、项目环境和授权。“已经改完”要结合实际 diff 和运行结果来判断。

二、国内用Codex，先准备什么？

先把三件事分开：服务可用条件、账号登录、订阅付款。

安装成功不代表一定能登录，能登录不代表所有功能都开放，付款成功也不会自动解除地区或账号限制。

1. 核对服务支持范围和访问条件

国内读者尤其要先核对服务地区。以官方 API 为例，核对当天的支持国家和地区列表 (opens new window)未列入中国大陆，官方也说明在支持范围外访问或提供服务可能导致账号被限制。

这篇提供的是安装和使用方法，不代表官方已经在中国大陆开放服务。 ChatGPT 账号路线和 API 路线，都需要分别满足对应服务的实际要求。遇到地区不可用提示，先核对可用资格，不要靠反复充值解决。

2. 准备自己的账号或API Key

Codex 本地使用主要有两种认证方式：官方认证说明 (opens new window)。

登录方式	费用归属	适合谁
Sign in with ChatGPT	对应 ChatGPT 套餐和当前用量规则	已有 ChatGPT 账号，希望直接使用产品的人
API Key	对应 API 项目的账单和模型价格	开发者、脚本与自动化使用者

云端 Codex 需要 ChatGPT 登录；API Key 在本地工作流中可用，但不能据此获得全部云端和工作区功能。

先用自己能够正常管理的账号。不要把账号密码、验证码、Cookie 或登录凭证贴到公开群和项目仓库里。

3. 准备项目和开发环境

第一次建议选一个自己熟悉的小项目，确认原本就能启动。让 Codex 跑 Java、Python 或 Node.js 项目，电脑上也需要对应的 JDK、Python、Node.js、依赖和服务环境。

开始前先查看 Git 状态，保存已有工作。这样才能分清哪些修改来自自己，哪些来自 Codex。

三、Codex免费吗？Plus、Pro和充值怎么选？

不要把“Codex 充值”直接理解成必须再购买一份独立会员。

使用 ChatGPT 账号登录时，先看自己的 ChatGPT 套餐。根据核对当天的官方价格说明 (opens new window)：

方案	官方美元月价	和Codex有关的主要区别
Free	0 美元	桌面端轻量任务能力逐步开放，不能推断所有入口都可用
Go	8 美元	桌面端轻量使用，具体以账号开放情况为准
Plus	20 美元	包含更多 Codex 入口与编程使用权益，仍有用量限制
Pro	100、200 或 500 美元	按实际使用需求选择档位，不能理解为所有任务无限使用
API Key	按模型和用量计费	独立 API 账单，模型权限跟随对应密钥

以上为官方展示的美元价格，实际结账可能受到地区、税费和付款渠道影响。不同套餐的模型、速度、功能与额度有差异，以账号实际可见的权益为准。

当前官方还说明，ChatGPT Work 与 Codex 共享用量。发现可用额度减少时，也要检查其他 Work 任务的使用情况，不能只数自己发了几条编程消息。

国内没有海外信用卡，怎么给Codex开通会员？

如果你选的是 ChatGPT 账号登录路线，需要更多会员权益，付款部分统一看这篇：

👉 ChatGPT Plus／Pro 充值教程：支付宝、微信、代付与续费

里面整理了国内付款方式、第三方充值、海外信用卡、苹果礼品卡，以及订单和续费注意事项。先确认自己要开的是 Plus 还是 Pro，再按对应教程操作。

如果你已有 Plus，先使用现有权益跑通一个小任务，观察用量，再决定是否升级。档位区别可以继续看Plus 与 Pro 套餐对比。

会员权益、ChatGPT credits 和 API 余额需要分别核对，不能把其中一个余额直接当成另一个使用。 API Key 登录也不会因为你已开 Plus，就自动改走会员额度。

四、Codex官网入口：桌面端、插件、CLI和网页版怎么选？

第一次选自己最熟悉的入口即可。

入口	从哪里开始	更适合的习惯
桌面端	官方快速入门 (opens new window)	希望在图形界面管理项目、任务和改动
VS Code／Cursor 插件	官方扩展文档 (opens new window)	日常就在编辑器里写代码
Codex CLI 命令行	官方 CLI 文档 (opens new window)	熟悉终端，希望直接在项目目录执行任务
网页与云端任务	ChatGPT 官网 (opens new window)和云端环境文档 (opens new window)	希望将任务放到配置好的远程环境运行

网上旧教程可能使用“Codex App”“独立 Codex 客户端”等叫法。截至核对日期，官方快速入门已使用 ChatGPT 桌面应用作为桌面入口，并在其中选择 Codex。 找不到旧截图里的按钮时，先看当前文档。

五、Codex桌面端下载安装：Mac、Windows和Linux

不习惯使用终端，可以从桌面入口开始。

1. 打开官方快速入门 (opens new window)，选择 Desktop。
2. 根据系统下载官方提供的 macOS、Windows 或 Linux 安装包；系统要求以下载页为准。
3. 安装并打开应用，完成账号登录。
4. 在模式选择中进入 Codex，再选择要处理的本地项目文件夹。
5. 先让它解释项目，确认打开的是正确目录，再安排修改。

图片来源：OpenAI 官方更新日志 (opens new window)。这是官网公开的桌面端演示截图，展示了任务对话、文件改动和页面预览；图里的旧模型名与按钮位置不作为当前安装依据。

第一条消息可以这样写：

请用中文介绍这个项目的技术栈、目录结构和启动方式。
找出前端入口、后端入口和测试命令，说明依据来自哪些文件。
这一步先不要修改文件或安装依赖。

看完回答，再安排一个小任务，比如修改一个表单校验、修复一个明确报错。任务完成后检查改动文件和验证结果。

六、VS Code、Cursor怎么安装Codex插件？

平时就在 VS Code 写代码，优先试插件入口，文件和修改结果都能放在编辑器里看。

第一步：安装官方扩展

在扩展市场搜索 Codex，核对发布者为 OpenAI。也可以从官方文档 (opens new window)跳转安装，避免装到同名扩展。

当前官方 VS Code 扩展链接中的标识是 openai.chatgpt，不要仅凭这个标识含有 ChatGPT 就认为找错了插件。

VS Code、Cursor、Windsurf 等兼容编辑器可按官方文档选择入口。JetBrains、Xcode 使用各自的集成方式，不需要照搬 VS Code 安装步骤。

第二步：打开项目并登录

先打开完整项目文件夹，再点击 Codex 图标。如果侧边栏找不到入口，可以在命令面板搜索：

Codex: Open Codex Sidebar

选择 Sign in with ChatGPT，在浏览器完成授权，再返回编辑器。使用 API 路线时，选择对应的 API Key 登录入口。

第三步：带着代码上下文提问

打开有问题的文件，把选中的代码、错误日志和预期行为一起提供给它：

请检查当前选中的分页查询代码。
现象：第一页正常，第二页出现重复数据。
要求：先找到排序和分页条件，再解释原因；确认后做最小范围修复。

图片来源：OpenAI DevDay 官方案例 (opens new window)，为 2025 年公开演示界面。这里重点看任务结果的结构：修改说明、涉及文件、验证情况。

要看清楚哪些验证成功、哪些检查失败或没有执行。 不能把一段“完成说明”当成全部测试已经通过。

七、Codex CLI安装教程：终端登录与常用命令

Codex CLI 适合习惯使用命令行的人。它直接在当前项目目录工作，可以调用本机已有的开发工具。

1. 安装Codex CLI

已经有 Node.js 和 npm 的环境，可以按官方提供的方式安装：

npm install -g @openai/codex
codex --version

更新也可以使用：

npm install -g @openai/codex

Mac 上已使用 Homebrew，也可以选择：

brew install --cask codex

上面的方式选一种即可。 没有 Node.js 环境，也可以在官方 CLI 安装页 (opens new window)选择系统对应的独立安装器。

2. Windows怎么运行Codex？

官方 CLI 安装页提供 Windows 独立安装方式；已有 npm 环境时也可使用 npm 安装。在 PowerShell 中进入自己的项目目录：

cd D:\projects\my-project
codex

如果项目原本放在 WSL，可以在对应的 WSL 环境里安装和使用 CLI。在哪个系统里运行，项目路径、依赖和配置就按哪个环境检查。 不要在 Windows 安装好依赖，却默认 WSL 也已经具备同样环境。

3. 登录ChatGPT账号

macOS 或 Linux 下的项目示例：

cd ~/projects/my-project
codex

首次启动后，按提示选择 ChatGPT 登录，在浏览器里完成授权。

需要单独发起登录、查看身份或退出时：

codex login
codex login status
codex logout

4. 常用命令速查

命令	用途
codex	在当前目录开始交互式任务
codex --help	查看当前版本支持的参数
codex resume	恢复已有会话
codex exec "任务描述"	非交互方式执行任务，适合脚本
codex --search	启用实时搜索，适合需要查询最新资料的任务
/model	在交互会话中选择当前可用模型与推理设置
/permissions	检查和调整当前权限设置

命令以官方 CLI 文档 (opens new window)和本机 --help 为准。遇到旧教程参数不可用，先检查版本。

新手先保留默认权限。 看清需要执行什么命令、修改什么路径，再决定是否授权。

八、Codex API Key怎么配置？会员和API有什么区别？

使用官方 API，需要在自己的 OpenAI Platform 项目中创建密钥，并核对账单、模型权限和服务可用条件。

在 macOS／Linux 中，如果已经通过安全的环境变量方式配置了 OPENAI_API_KEY，可以使用官方认证命令：

printenv OPENAI_API_KEY | codex login --with-api-key
codex login status

这条命令把密钥通过标准输入交给 Codex。不要把真实密钥写进教程示例、Git 仓库或公开截图。 具体认证方式见官方说明 (opens new window)。

第三方中转API能不能接Codex？

先看兼容性，不能只看是否写着“OpenAI 兼容”。

至少核对 Base URL、认证方式、模型标识，以及 Responses 协议和工具调用。当前官方模型文档 (opens new window)说明，Codex 不支持仅提供 Chat Completions 的接口。

同样，也不能只把普通聊天模型名称改成 Codex，就认定它拥有对应模型和工具能力。第三方服务的模型真实性、数据处理和费用，跟随对应服务商规则。

如果使用 API，先做一个简单的项目读取任务，确认响应、工具调用与扣费记录，再逐步增加复杂度。

想充值 ChatGPT 会员，不用在 API 后台找 Plus 付款入口，直接看ChatGPT 国内充值教程。

九、Codex网页版和云端任务怎么用？

本地任务使用你电脑上的文件和开发环境；云端任务则需要配置远程环境，让 Codex 能拿到仓库、依赖和运行条件。

根据当前官方云端环境说明 (opens new window)，可以在支持的界面中选择 Work in → Cloud → Select environment → Create environment，再按流程准备环境。

一般需要完成这些步骤：

1. 使用有对应权益的 ChatGPT 账号登录。
2. 按页面提示连接所需仓库，只授权任务需要的范围。
3. 配置依赖安装、启动方式和必要环境变量。
4. 先测试环境能否正常准备，再发布为可用环境。
5. 发起小任务，完成后检查 diff、日志和验证结果，再决定如何合入。

图片来源：OpenAI DevDay 官方案例 (opens new window)，为 2025 年云端页面修改示例。截图用来说明任务、差异和页面预览之间的关系，当前配置入口以官方文档为准。

云端失败时，优先看环境准备日志。缺少依赖、测试数据库不可用、启动命令不对，都可能导致任务受阻，不能一概归因于模型。

十、Codex实战：让它真正帮你改好一个项目

第一次使用，建议按下面三个阶段走。

1. 先读项目，建立共同上下文

请阅读README、依赖配置和主要目录。
用中文说明项目架构、启动方式和测试方式。
找出用户登录接口的调用链，并列出相关文件。
这一步只分析，不修改。

它找错入口时，先纠正上下文。不要在错误理解上连续追加需求。

2. 给出可验证的小任务

现在修复登录失败返回500的问题。
预期：密码错误时返回项目约定的业务错误，不泄露内部异常。
约束：复用现有异常处理，不新增依赖，不修改数据库结构。
请补充相关测试并运行；如果环境不支持，明确说明缺少什么。
不要自动提交或部署。

目标、现象、预期结果、限制条件和验收方式越明确，越容易得到能检查的结果。

3. 检查改动和验证结果

在项目目录查看：

git status
git diff --stat
git diff

重点看：是否只改了相关文件、是否引入了意外依赖、是否真正覆盖了错误分支，以及声称通过的检查是否有运行结果。

如果需要数据库、Redis 或外部接口，先让它说清楚验证依赖，再准备环境。通过静态检查，并不等于完整业务流程已经可用。

十一、AGENTS.md、Skills和MCP是什么？

等第一个任务跑通，再了解这几个词就够了。

名称	解决什么问题	入门用法
AGENTS.md	告诉 Codex 这个仓库怎么工作	写清项目结构、常用命令、编码规范和交付要求
Skills	复用一套任务方法与相关资源	把反复执行的检查或制作流程整理成技能
MCP	连接外部工具和数据源	在授权范围内接入文档、服务或其他工具

比如在项目根目录创建 AGENTS.md：

# 项目约定

- 用中文说明修改原因和验证结果。
- 修改前先阅读 README 和相关模块。
- 遵循现有代码风格，避免无关重构。
- 根据 package.json 中已有脚本运行相关检查。
- 不自动提交，不自动部署。

Codex 会读取相应范围内的项目说明，具体发现顺序见官方 AGENTS.md 文档 (opens new window)。把这些规则写进仓库，可以减少每次重复解释。

先把项目规范和任务说清楚，再考虑增加工具。

十二、Codex常见问题：登录失败、无法连接、额度不足

Codex需要海外手机号吗？

是否需要额外验证，要看当前账号、认证方式和页面要求。不能承诺所有账号都不需要，也不能把别人的验证流程当成自己的固定流程。

遇到这个问题，继续看Codex 手机验证与登录失败排查。API 路线同样需要满足对应平台的注册与使用要求。

浏览器登录成功，CLI还是未登录？

先执行 codex login status，确认终端身份。检查浏览器授权回调是否完成、浏览器登录的账号是否正确，以及 CLI、编辑器和 WSL 是否处于同一个运行环境。

网页能正常使用，不代表终端已经获得认证，或终端网络也可以访问所需服务。

安装后提示command not found或找不到codex？

先检查安装是否成功，再关闭并重新打开终端。npm 安装方式需要检查全局命令路径是否进入 PATH；使用多个 Node.js 版本时，也要确认安装和运行用的是同一套环境。

不要看到找不到命令就反复安装多个版本。

Codex提示额度不足，是不是必须升级Pro？

先看用量面板、重置时间，以及当前使用的是会员还是 API。长上下文、多轮改动和较高推理强度都可能影响消耗；订阅额度也不能简单换算成固定任务次数。

可以先缩小任务范围、减少无关上下文，再判断是否需要升级。确定要开通或续费时，查看ChatGPT Plus／Pro 充值教程。

有Plus，为什么API仍然扣费或报余额不足？

先用 codex login status 查看身份。API Key 路线按 API 账单结算，不能默认扣会员额度。希望使用 ChatGPT 权益时，确认当前确实通过对应账号登录。

Codex支持中文吗？

可以。任务、约束和解释都可以用中文。文件名、API 名称、报错原文尽量保留，能减少定位歧义。

Codex CLI和IDE插件能离线使用吗？

“本地运行”主要指文件和开发工具在本机，模型调用仍需要连接对应服务。不能把安装了 CLI 理解为已经下载了可离线运行的大模型。

为什么修改完成后，项目还是跑不起来？

让它列出实际运行过的命令和原始错误，再区分代码问题与环境缺失。安装依赖失败、数据库没启动、配置不完整，都需要具体处理。

可以继续追问：

请列出本次实际执行的验证命令、结果，以及没有验证的部分。
对仍未解决的问题，先说明原因和所需条件，再继续修改。

Codex报错应该先查哪里？

现象	优先检查
地区不可用、403	对应服务支持范围、账号资格、工作区策略和完整错误信息
未认证、401	当前登录方式、密钥状态、账号与项目权限
无法连接、超时	本机访问条件、服务状态、终端与浏览器环境差异
429或额度耗尽	具体错误码、用量、重置时间、API余额与限流规则
API聊天正常，Codex失败	Responses协议、工具调用、模型权限和接入配置
无法写文件或执行命令	当前工作目录、权限设置、沙箱范围和系统权限
看不到模型或云端功能	客户端版本、登录方式、套餐及工作区开放情况

先跑通一次“读项目 → 改一个问题 → 检查结果”，再决定订阅和额度。

需要付款或续费，直接按ChatGPT Plus／Pro 国内充值教程操作。