ARTICLE · 1146673
Codex 保姆级教程:从账号、订阅到安装使用,一篇搞定
📦 本文看点 + 写在最后
👉 滑动
PART 01
形态怎么选
别装四个
PART 02
账号与订阅
钱怎么花
PART 03
安装与跑通
五分钟起步
PART ///
写在最后
门槛与心法
门槛其实只有三道
账号 · 订阅 · 安装 —— 过了这三道,剩下的都好办
这两年 AI 编程工具换了一茬又一茬,Codex 是少数从「帮你补全代码」进化成「自己动手干活」的那一类。它能读你的仓库、改文件、跑命令、看结果,最后丢给你一份可以 review 的 diff。
它同时也是劝退率最高的一个。不是因为它难,而是因为入口太多、订阅太绕、文档太散。这篇文章就把三件事一次讲完:账号怎么开、钱怎么花、装好之后怎么跑通第一个任务。
本文整理自 2026 年的公开资料,价格、额度、功能都处于滚动调整中,动手前请以官方页面显示为准。
01
PART
先搞清楚,Codex 有几种形态
FOUR SURFACES · 四种入口
很多人第一次打开官网就懵了:CLI、IDE 扩展、桌面 App、Cloud,四个名字长得都像同一个东西。它们确实是同一个 agent,只是穿了四件不同的衣服。
四种形态共享同一套登录态和配置。你在 CLI 里写好 AGENTS.md,桌面 App 打开就认得;在 App 里改一个设置,CLI 也同步生效。所以不存在「先装哪个后装哪个」的问题,选一个顺手的开始就行。
四种形态的能力大约有八成重叠,不必全装。全装的结果通常是四个面板显示同样的数据。
如果你完全没碰过命令行,从桌面 App 开始是最理性的默认选择,它能覆盖日常九成以上的任务;如果你本来就在终端里,CLI 更顺手,也是唯一能被脚本调用的入口。
02
PART
账号,先有一个能用的
ACCOUNT · 登录与网络
这里有个好消息:Codex 没有独立账号。它直接认你的 ChatGPT 登录态,所以不存在「再注册一个 Codex 账号」这一步。如果你已经有 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 订阅,账号这关基本已经过了。
真正需要准备的只有两样东西。
一个稳定的邮箱
Gmail、Outlook 这类国际邮箱收验证码最稳,部分国内邮箱会出现验证邮件延迟甚至收不到。注册过程中可能触发手机号验证,建议用长期使用的号码 —— 临时接码注册的账号,后续找回和二次验证都会很麻烦。
一个尽量固定的网络环境
这是国内用户最容易忽略的一点 —— 今天连美国节点、明天换欧洲节点,是账号触发风控的常见诱因。选定一个地区长期使用,比追求「最快的节点」重要得多。
✦ API Key 的边界
除了订阅登录,Codex 也支持用 OpenAI API Key 认证。但API Key 只覆盖 CLI 和 IDE 这类本地入口,云端代码审查、Slack 集成这些 cloud 功能用不了。如果你登录后发现有功能是灰的,那不是故障,是入口本身的差异。
03
PART
订阅,钱到底怎么花
PRICING · 六档方案
先纠正一个最常见的误解:Codex 没有单独的订阅。它捆绑在所有 ChatGPT 方案里,你付的是 ChatGPT 的月费,Codex 额度随方案层级往上走。
| Plus | $20 | ||
关于额度,有三件事必须先讲清楚,否则很容易用着用着被账单吓一跳。
01限额是滚动窗口,不是月配额
额度按滚动 5 小时窗口计算,到顶之后要么等窗口重置,要么加购额外的 credits。同一条消息消耗多少,取决于这次任务读了多少文件、写了多少代码 —— 一句「改个错别字」和一次「读三十个文件再改十个」,差距可以很悬殊。
02输出比输入贵得多
各家单价都遵循同一个规律:生成 token 的单价是读取 token 的数倍。所以生成测试、批量搭脚手架这类「大量产出代码」的任务,烧额度明显快过调试和读代码。
03订阅和 API 是两套账单
买了 Plus 不等于 API 免费,API 里有余额也不能抵扣月费。这两笔钱互不相通,别搞混。
选择建议:先用 Plus。只有当你发现自己每周都在撞限额,再考虑 Pro。Pro 档位在 2026 年有过调整和新开通限制,具体以官方页面为准。
关于支付:官方订阅需要符合支持地区的支付方式。无论走哪条路,三条底线不能破 —— 不伪造账单和地区信息,不购买来源不明的低价虚拟卡,不使用多人共享账号。
04
PART
安装,五分钟装好
INSTALL · 三种方式
装之前先确认两件事:一个可用的 ChatGPT 账号,以及 Node.js 18 或更高版本(走 npm 安装才需要,官方脚本自带运行时)。
macOS 与 Linux
npm 是最通用的方式。
npm install -g @openai/codex
macOS 可以改用 Homebrew:
brew install --cask codex
不想装 Node.js 的话,官方还提供一键脚本,它会自带运行时:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows
2026 年已经不需要先搭 WSL2,原生 PowerShell 就是官方推荐路径:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
也可以直接从 Microsoft Store 安装,或者用 winget:
winget install Codex -s msstore
桌面 App 更简单,在 CLI 里执行 codex app 会自动下载安装,也可以直接去官网下安装包。
装完之后验证一下:
codex --version
看到版本号,就说明成功了。
!踩坑提示 🕳
高频错:顺手敲 npm install -g codex,忘了加 @openai/ 作用域。那是另一个完全无关的包,装完自然跑不起来。
05
PART
第一次跑通,交一个任务给它
FIRST RUN · 登录与首个任务
在终端里输入:
codex
第一次运行会引导你登录。推荐选 Sign in with ChatGPT,浏览器弹出授权页,授权完回到终端即可 —— 这样 CLI、桌面 App、Cloud 的数据和额度是打通的一整套。
如果在服务器或 CI 环境里没有浏览器,可以改用 API Key:
codex --api-key sk-...
# 或者写进环境变量
export OPENAI_API_KEY=sk-...
登录成功后,Codex 会启动一个全屏终端界面,有输入框、输出面板和状态栏。第一眼看它更像一个 IDE,而不是一个聊天窗口。
给你一个可以直接照抄的首个任务
先确保当前目录是一个 Git 仓库,然后把下面这段交给它:
解释这个仓库的结构,找出最小的一个可以修的 bug,
在新的 worktree 上修掉它,跑相关测试,然后把 diff 给我看。
这个问题好在有明确边界,也有可验证的完成标准。反过来,「把这个项目优化一下」是典型的坏任务:目标是主观的,范围没有上限,失败了你也不容易发现。
几个马上会用到的命令:
codex # 在当前目录启动交互模式
codex app # 启动桌面 App
codex exec "给用户列表加分页" # 非交互执行,适合写进脚本
codex cloud # 在云端环境提交一个任务
codex mcp # 配置 MCP 外部工具
在交互模式里,用 /plan 或 Shift+Tab 打开 Plan Mode,让 Codex 先把计划写出来、由你确认之后再动文件。这是官方和多数老用户都推荐的第一道闸门。
动手前先提交一次。运行 git add . && git commit -m "checkpoint"。万一它改出了你不想要的东西,git reset --hard HEAD~1 就能瞬间回滚。这是成本最低的一张安全网。
06
PART
新手最容易踩的六个坑
PITFALLS · 避坑清单
忘了加 @openai/ 作用域
这是社区里出现频率最高的错误。装完发现命令不存在,八成就是这个问题 —— 完整包名是 @openai/codex。
把 API Key 当成万能钥匙
API Key 只有本地入口,云端功能一律不可用。想要完整体验,登录方式得用 ChatGPT 账号。
没盯额度就放开用
额度消耗和任务复杂度强相关。头一两周养成看一眼用量的习惯,别默认套餐自带额度一定够。
一次性把权限开到底
Codex 默认运行在受限沙箱里,文件访问、网络请求、命令执行都要经过确认。这是设计如此,不是麻烦。等你清楚知道自己在放开什么,再逐项调整。
在共享账号上省钱
账号本身就是你的资产。密码、验证码、Cookie、恢复码,都不要交给任何人,也不要购买来源不明的低价代充服务。
把敏感资料随手丢给 Agent
客户数据、未公开的商业文件、公司内部凭证,交出去之前先想一秒。代码沙箱不等于数据合规。
///
LAST
写在最后
FINAL WORDS · 门槛与心法
把这件事拆开看,Codex 的门槛真的只有三道:开一个账号(其实就是你已有的 ChatGPT 账号)、选一档订阅(从 Plus 开始就行)、装好 CLI 或桌面 App。
真正拉开差距的,不是你会不会用这些命令,而是你会不会提任务。
给足上下文 · 划清边界 · 说明什么叫「做完了」
这三条,比记住任何一条命令都值钱。工具会一直变,模型版本、价格档位、入口形态,半年后可能就是另一套样子。但这个工作方式不会变:把可以验证的工作交给它,把需要拍板的部分留给自己。
我是 {{作者名}},{{一句话简介,比如:持续拆解 AI 工具与实战工作流}}。
既然看到这里了,如果觉得有用,随手点个赞、在看、转发三连吧。
THANKS FOR READING