深色模式
ChatGPT Codex 是什么？官网、下载、CLI、账号绑定与 API 额度教程
更新时间：2026年10月6日 | 系统、登录方式和额度以官方页面实时显示为准
**Codex 是面向软件开发的 OpenAI 编程 Agent。**它可以在授权的项目目录中阅读文件、解释代码、提出修改、执行获准的命令并运行测试。它和 ChatGPT 网页对话有联系，但入口、工作区权限和计费方式可能不同。使用前先看 OpenAI Codex 官方文档，再根据设备和账号看到的选项操作。
Codex 第三方配置入口：ZeoGPT
如果你需要第三方 Codex 配置路径，可以先看 ZeoGPT 注册入口，再按平台当前说明配置兼容的 API 网关。ZeoGPT 与配套的 ZeoAPI 都是独立第三方服务，不是 OpenAI Codex 或 OpenAI API；模型、额度、价格、Base URL、日志和数据规则以登录后的实时页面为准。注册链接包含推荐参数，是否使用完全自愿。不要把第三方 Key 发送到 OpenAI 官方 endpoint，也不要在生产代码中暴露任何 Key。
如果只想在网页里进行对话、写作和模型切换，也可以查看 GPTCat 或 SnakeGPT；需要运行 CLI、读取项目文件或执行开发任务，请继续使用官方 Codex 入口并妥善保护凭据。
一、Codex、ChatGPT 订阅和 API 是什么关系？
| 使用方式 | 登录或凭证 | 费用与额度 | 适合场景 |
|---|---|---|---|
| ChatGPT 账号登录 | OpenAI 账号授权 | 按账号当前套餐和产品规则提供使用权益 | 想快速在 Codex 中处理项目 |
| OpenAI API Key | 项目级 Secret Key | 按 API 模型与实际用量计费 | 后端、自动化、企业集成 |
| 第三方兼容网关 | 第三方 Key 与 Base URL | 由第三方平台决定 | 有明确合规和数据评估后的兼容接入 |
ChatGPT Plus/Pro 不等于一张通用 API 余额卡；API Key 也不自动赋予 ChatGPT 订阅权益。登录界面、可选模型、使用上限和套餐资格会因账号、地区、产品版本而变化，不能用旧截图替代实时页面。
二、官方入口与安装前准备
建议从官方文档进入下载和安装说明：
安装前准备一个有 Git 版本控制的测试项目，并先移除生产密钥、客户资料和未备份文件。Codex 可能读取项目内容、编辑文件或执行命令；第一次使用应保持“先说明、再批准”的工作方式。
三、安装 Codex CLI
具体安装脚本和包名可能更新，以下命令用于说明常见流程，执行前请以 官方 Codex 页面当前内容为准。
Windows PowerShell
powershell
# 以官方文档当前提供的安装方式为准
codex --version
codex --help如果官方页面提供 PowerShell 安装脚本，应从该页面复制最新命令后执行，不要从搜索结果或陌生网盘下载可执行文件。安装后关闭并重新打开 PowerShell，再用 codex --version 检查 PATH。
macOS 或 Linux
bash
# 按官方文档选择安装方式后验证
codex --version
codex --help如果你通过 npm 安装官方包，先确认当前文档中的包名、Node.js 版本和发布渠道，再运行相应的 npm install -g ...。CLI 的命令、桌面端和 IDE 集成可能分别发布，不能把旧教程中的包名当作永久接口。
四、第一次启动和账号绑定
进入一个测试项目目录后启动：
bash
cd your-project
codex首次启动一般会出现浏览器授权或 API Key 配置选项，常见流程如下：
- 选择 使用 ChatGPT 登录，浏览器打开 OpenAI 授权页面；
- 使用自己的账号完成登录和授权；
- 返回 CLI 或桌面端，确认当前工作区和账号；
- 如果选择 API Key，按页面提示绑定项目 Key，并确认该 Key 属于目标项目；
- 先发送只读任务，检查 Codex 是否能正确识别目录、语言和测试命令。
不要把密码、验证码或完整 API Key 发给第三方“代登录”客服。浏览器回调失败时，先确认浏览器和 Codex 在同一台设备、账号没有切错，并重新启动客户端；不要为了绕过企业策略而关闭系统安全设置。
五、CLI 的基本工作方式
Codex CLI 的核心不是某个固定参数，而是“任务、上下文、审批、验证”四步：
- 任务：说明目标、边界和完成标准；
- 上下文：在正确的项目目录运行，指出相关文件；
- 审批：命令、网络访问和文件修改按需批准；
- 验证：查看 diff，运行测试，记录实际结果。
第一次可以输入：
text
请只读分析这个项目，不要修改文件。说明技术栈、入口文件、测试命令，以及完成一个小修复前还需要确认的信息。确认分析无误后，再提出可回滚的小任务：
text
请修复 issue-123 中描述的输入校验问题。先列出准备修改的文件和原因，等我批准后再编辑；完成后运行相关测试并报告命令和结果。常用命令通常包括：
bash
codex --help
codex --version
codex版本之间可能新增或调整子命令，使用 --help 比复制旧文章中的参数更可靠。
六、API Key 登录和额度核验
使用官方 API Key 时，Key 在 API Keys 控制台创建，费用和用量在项目的 Usage/Billing 页面查看。不要把 ChatGPT 订阅页面显示的消息额度直接换算成 API token，也不要把某个模型在 ChatGPT 中可选推断为 API 项目一定开放。
核验顺序：
- 确认登录的是目标 OpenAI 组织和项目；
- 在 Models 页面确认 Codex 工作流所需模型 ID；
- 在 Pricing 页面查看输入、输出和工具费用；
- 在 Usage 页面用一两个小任务检查真实消耗；
- 设置预算提醒、并发限制和自动化任务上限。
模型名称、价格和可用额度可能随着产品更新、账号类型或地区变化。标题中出现的 GPT-6 Astra 等名称，只有在官方模型目录和你的项目控制台同时显示时，才应写进配置；代码中建议使用环境变量 OPENAI_MODEL。
七、把 API 配置放在安全位置
CLI 或本地开发可以使用系统环境变量：
powershell
$env:OPENAI_API_KEY = "sk-你的密钥"
$env:OPENAI_MODEL = "控制台中可用的模型 ID"
codexmacOS/Linux：
bash
export OPENAI_API_KEY="sk-你的密钥"
export OPENAI_MODEL="控制台中可用的模型 ID"
codex不要把 Key 写入项目源码、.git 历史、截图、公开 issue 或团队聊天。发现泄露时，立即撤销旧 Key、生成新 Key，并查看 Usage 和账单是否有异常。对公司代码使用第三方网关前，还要确认组织的数据处理和保留政策。
八、常见问题与排错
codex 不是内部或外部命令
重开终端并执行 codex --version。仍失败时检查安装路径是否加入 PATH、当前 Node.js/npm 是否属于预期用户，并回到官方文档重新确认安装渠道。
ChatGPT 登录后没有返回客户端
确认浏览器和客户端使用同一设备与账号，暂时停用会拦截回调的扩展，重新启动后再授权。企业设备若有管理员策略，应联系管理员，不要绕过安全控制。
API 返回 401 或 403
检查 Key 是否完整、是否已撤销、项目是否选错，以及当前请求是否发送给与 Key 匹配的 endpoint。403 还可能涉及组织、地区或权限，查看控制台的具体提示。
API 返回 404 或模型不存在
去官方 Models 页面复制当前项目可用的模型 ID。不要把第三方网关的别名、旧截图或 ChatGPT UI 名称直接填入官方 API。
Codex 修改了文件，怎么撤销？
先查看 git diff，确认没有需要保留的改动，再使用 Git 分支、提交或回滚恢复。涉及删除、迁移、部署和数据库命令时，必须逐条审查并保留备份。
九、FAQ
Codex 一定要 ChatGPT Plus 吗？
不一定。产品可能提供 ChatGPT 账号授权和 API Key 等路径，具体资格与额度以你的官方登录页面和账号说明为准。Plus 订阅和 API 项目仍是分开的。
Codex 能在 Windows 上使用吗？
Windows 是否提供桌面端、CLI 或特定安装方式，以官方文档当前系统要求为准。安装成功后用 codex --version 验证，不要下载来路不明的打包程序。
Codex 会自动执行所有命令吗？
权限由客户端和当前审批设置决定。新项目建议采用请求批准模式，先查看命令、文件范围和网络访问，再允许执行。
API Key 能和 ChatGPT 登录混用吗？
两者是不同的身份和计费路径。需要切换时，按客户端当前登录设置操作，并确认 Usage 记录落在预期项目中。
可以用第三方 API 配置 Codex 吗？
只有在客户端和服务商都明确支持、且你已评估数据与合规风险时才考虑。第三方 Key、Base URL、模型路由和价格由第三方管理，不能描述为 OpenAI 官方服务。
相关阅读
官方来源
图：Codex 工作区界面示意。具体按钮、模型和权限以当前官方版本为准。
本文为独立教程，非 OpenAI 官方页面。Codex 的下载方式、登录入口、模型、额度、价格和系统支持可能更新，执行任何安装或付费操作前请以官方页面和登录后的控制台为准。