Codex 是 OpenAI 的编程智能体,能写代码、做审查、把 Pull Request 也顺手开了。官网入口是 openai.com/codex。所有 ChatGPT 套餐(连免费的 Free、Go 都算)都内置 Codex,用 ChatGPT 账号登任意一个客户端就能上手。下面把 4 种入口和新手从装好到跑通第一个任务的步骤一次讲清。 Codex 有哪几种使用入口
OpenAI 给 Codex 提供了四种客户端,底层是同一套引擎,区别只在使用场景。对应的官方地址整理在下表,认准这几个就行:
| | |
|---|
| | |
| 桌面端安装 ChatGPT 应用后切到 Codex 模式,账号入口同为 chatgpt.com | |
| | |
| 在 VS Code、Cursor、Windsurf 等编辑器的扩展市场搜索 Codex 安装 | |
官方资料备查:开发者文档 developers.openai.com/codex;中文帮助《在你的 ChatGPT 套餐中使用 Codex》help.openai.com/zh-hans-cn/articles/11369540。四种客户端都走 ChatGPT 账号登录,不用单独注册,第一次用先选桌面应用或网页版,爱敲终端再上 CLI。
Codex 怎么用:从安装到提交第一个任务
下面分两条最常用的路线,先把一条跑通就行。
路线一:Codex CLI(本地终端)
- 安装,任选一种:macOS 用 Homebrew 跑 brew install --cask codex;跨平台用 npm install -g @openai/codex;Mac/Linux 也能用一键脚本 curl -fsSL https://chatgpt.com/codex/install.sh | sh,Windows 用 PowerShell 跑 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex";
- 安装后直接运行 codex 即可启动,首次会进入登录流程,这一步别跳过;
- 登录时选 Sign in with ChatGPT,用你的 ChatGPT 账号(Plus / Pro / Business / Edu / Enterprise 均含 Codex 额度)授权;需要程序化调用也可改用 API Key,走 OpenAI API 标准计费;
- 下任务就是描述需求,例如 codex "解释这个项目的结构";复杂改动先让它调研再动手,并用 /init 生成 AGENTS.md 把项目规范沉淀下来。
路线二:Codex 网页版(云端环境)
- 打开 Codex 并用 ChatGPT 账号登录;
- 按提示连接 GitHub 或 GitLab(Beta),只开放当前要用的仓库,别为了方便一把授权全部私有库;
- 为仓库创建 Environment,配置好依赖、构建工具、环境变量和必要的 Secrets;
- 选好环境,用自然语言描述想要的结果,任务可以在后台继续跑;
- 查看摘要与 diff,要求它补改或直接开 Pull Request。
Codex 支持哪些套餐与额度
据 OpenAI 帮助中心说明,所有 ChatGPT 套餐均包含 Codex,包括 Free 和 Go,使用限额因套餐而异。各档的包含关系如下:
具体每档的用量上限会随官方调整,以 chatgpt.com/pricing 与账号内用量页当期显示为准。
Codex 的额度与计费规则
Codex 按套餐内置额度运行,计费逻辑分两路:
- 用 ChatGPT 账号登录,直接消耗套餐内含的 Codex 额度,不额外扣费;
- 用 API Key登录,走 OpenAI API 标准计费,不占用 ChatGPT 订阅额度,适合自动化测试、CI/CD 等需要精细控量的场景。
额度按周期重置而非自然日清零,官方帮助中心的「管理用量」专文说明了滚动窗口等重置规则;具体可用条数与周期以账号「设置 → 用量」页面显示为准。Codex、ChatGPT Work 等共享同一额度池,在某一处省着用,另一处就多留一些。客服不会手动重置用量限制,到顶后请等周期重置或切换 API Key 方式。
Codex 使用注意事项
- 权限与沙箱:CLI 默认在沙箱里运行,文件可写范围受限;给它写文件或执行命令的权限前,先想清影响范围。
- 仓库授权最小化:云端版连 GitHub / GitLab 时只开当前要用的仓库,别为省事授权全部私有库,避免代码被无关任务触碰。
- Windows 已原生支持:官方提供 PowerShell 原生安装,无需 WSL2;若已装 WSL,桌面版里可指定发行版,但 WSL 不是必选项。
- 别暴露在不可信环境:不要在不信任的公开环境运行带写权限的 Codex,账号与代码都有风险;只连自己拥有并信任的设备。
- 额度超限不找客服:官方明确客服不会手动重置用量限制,到顶请等周期重置、升级套餐或用 API Key。
- API Key 与订阅额度分开算:CI/CD 等程序化场景建议用 API Key,走标准 API 计费,不占订阅额度。
- 先调研后动手:大改动先让 Codex 总结职责与依赖、给两三个方案,再让它编辑,能少返工。
- 用 AGENTS.md 沉淀规范:/init 生成项目说明,把构建命令、测试要求、代码风格写进去,输出更稳。
Codex 常见问题(FAQ)
Q:Codex 免费吗,要额外花钱吗?
A:所有 ChatGPT 套餐都含 Codex(含 Free、Go),订阅内就能用;Free / Go 额度较低。用 API Key 登录则走 OpenAI API 标准计费,不占订阅额度。
Q:Codex 的入口在哪,怎么打开?
A:四个客户端都行——ChatGPT 桌面应用(Codex 模式)、Codex CLI、IDE 扩展、网页版,统一用 ChatGPT 账号登录,不用单独注册。
Q:Codex 支持 Windows 吗?
A:支持,官方提供 PowerShell 原生安装,不需要 WSL2;WSL 只是可选方案,想用 Linux 环境时再开。
Q:Codex 和 ChatGPT 是什么关系?
A:Codex 是 OpenAI 的编程智能体,内置于各 ChatGPT 套餐,用 ChatGPT 账号登录;它不是普通的聊天窗口,而是能读写代码、跑命令的执行代理。
Q:Codex 额度用完了怎么办?
A:等周期重置(滚动窗口)或升级套餐;API Key 方式按 API 用量另算;官方客服不会手动重置限制。
Q:Codex 连不上或报错怎么排查?
A:CLI 里运行 codex doctor 诊断启动、连接与性能问题;先确认网络和登录态正常,Windows 用户可用内置的 Codex Doctor。
Q:没有编程基础能用 Codex 吗?
A:桌面版和网页版有可视化界面,新手能直接上手;但理解任务范围、审阅结果仍需一点工程常识,建议从小任务开始。
Q:Codex 会乱改我的代码库吗,安全吗?
A:默认沙箱隔离、写权限受限,云端版在隔离环境跑;只连信任的仓库与设备,合并前先看 diff 再点确认。
Q:新手先用哪个客户端?
A:想最快看到效果用桌面应用(Codex 模式)或网页版;习惯终端用 CLI;整天在编辑器里干活就装 IDE 扩展。
Codex 的套餐与额度会随官方调整,使用前在账号用量页确认当期标准即可。想持续跟进 Codex agent 的客户端更新与用法变化,可以关注本站的 AI 工具栏目,有新版本我们会同步更新。