先区分两个完全不同的 Codex，二者使用方式完全割裂：
-
初代 Codex（code-davinci-002 模型 API）：2023 年 3 月永久下线，无法再调用，废弃；
-
新版 Codex（2025 年后官方编程智能体）：独立客户端 / CLI/VSCode 插件，基于 GPT-5-Codex，可直接使用，下文全部讲这个可用版本。
一、使用前准备
1. 账号与权限
-
拥有 ChatGPT 账号（Free/Plus/Pro/Business/Enterprise 均可免费使用 Codex，仅用量额度不同）；
-
可选：绑定 GitHub 账号，实现自动提交代码、创建 PR、读取仓库；
-
海外网络环境，国内直连无法登录 OpenAI 官方 Codex 客户端。
2. 四种使用入口（按需选择）
-
Codex 桌面 App（Windows/macOS，图形界面，管理多项目）
-
Codex CLI 命令行（终端批量处理、自动化脚本）
-
VS Code Codex 官方扩展（IDE 内无缝编程，最推荐日常开发）
-
API 调用 GPT-5-Codex 模型（自有程序集成）
二、方式 1：VS Code 官方扩展（日常开发首选）
-
打开 VS Code 扩展市场，搜索：
Codex - OpenAI's coding agent（发布者 OpenAI）安装； -
侧边栏点击 Codex 图标，选择 Sign in with ChatGPT；
-
浏览器跳转 OpenAI 登录，授权后返回 IDE 自动连接；
-
基础使用：
-
选中代码：右键 → Codex 解释 / 重构 / 修复 Bug / 生成单测；
-
对话框输入需求：
给整个项目加登录接口，AI 自动读取全仓库，生成多文件修改，Diff 预览； -
内置终端：直接让 Codex 执行 npm install、编译、跑测试；
-
-
高级：绑定 GitHub 后，可一键生成 Pull Request。
三、方式 2：Codex CLI 终端工具（批量 / 自动化）
1. 安装依赖
先安装 Node.js ≥18（官网下载 msi/pkg 包），验证：
node -v
2. 全局安装 Codex CLI
# 国内镜像加速安装 npm install -g @openai/codex --registry=https://registry.npmmirror.com # 验证安装 codex --version
3. 登录授权
终端输入：
codex
弹出选项选 Login with ChatGPT，浏览器登录授权完成；
4. 常用命令
codex # 交互式对话，当前项目上下文 codex new # 清空上下文，新建任务 codex resume # 恢复上一次未完成任务 codex run "重构所有Python接口，统一异常处理"
5. 无浏览器登录（API Key 模式，CI / 服务器）
# Windows PowerShell $env:OPENAI_API_KEY="sk-xxx" # Mac/Linux export OPENAI_API_KEY="sk-xxx" codex
四、方式 3：Codex 桌面客户端（大型项目管理）
- 下载渠道
- Windows：Microsoft Store 搜索 OpenAI Codex；
- macOS：OpenAI 官网下载 dmg 安装包；
- 启动登录：ChatGPT 账号一键授权；
- 核心操作：
- 导入本地代码文件夹作为独立项目；
- 多智能体并行执行任务（重构、写文档、修复漏洞同时跑）；
- 任务面板查看执行日志、沙盒运行记录、文件修改 Diff；
- 录制重复工作流保存为自定义 Skills，一键复用。
五、方式 4：API 调用 GPT-5-Codex（自研系统集成）
旧 code-davinci 模型已废弃，现在专用代码模型为 gpt-5-codex，使用标准 OpenAI Chat Completions 接口：
请求示例（curl）
curl https://api.openai.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5-codex",
"messages": [
{"role": "user", "content": "用Python写一个异步爬虫，带代理池"}
]
}'
适用场景：自研 IDE、内部自动化平台、代码审计系统接入。
六、基础标准使用流程（通用所有客户端）
- 绑定代码目录：让 Codex 读取完整项目结构、依赖、现有代码；
- 下发自然语言任务（示例提示词）：
- 轻量：
优化这段JS代码，减少冗余 - 中型：
给这个Go项目增加JWT鉴权中间件 - 大型工程：
将整个前端Vue2项目迁移至Vue3+Vite，兼容原有接口
- 轻量：
- AI 沙盒自动执行：安装依赖、编译、运行测试、定位报错；
- 人工审核 Diff：所有文件修改预览，确认后写入本地；
- 提交版本：一键 git commit、创建 GitHub PR。
七、初代 Codex（code-davinci）为什么不能用？
2023 年 3 月 OpenAI 正式下线全部 code 系列专用模型，接口返回 410 Gone：
code-davinci-002、code-cushman-001永久停用；- 不再维护、不提供 token 计费、无技术支持；
- 替代：新版 Codex 智能体 /gpt-4o /gpt-5-codex API 模型。
八、常见替代方案（无法访问 OpenAI 时）
- GitHub Copilot：底层早期是初代 Codex，现用 GPT-4o，VSCode 原生插件，国内可正常使用；
- Cursor AI：内置 OpenAI 代码模型，本地编辑器；
- 第三方封装：Aider、Continue 等开源代码助手。
九、使用注意事项
- 安全：Codex 修改文件全部生成 Diff，高危操作（删文件、rm 命令）需要人工确认；云端独立沙盒运行代码，不会直接操作本地系统；
- 成本：桌面 / CLI 客户端计入 ChatGPT 套餐免费额度；API 调用 gpt-5-codex 单独按 Token 计费；
- 局限性：底层内核、硬件驱动、复杂加密算法生成代码必须人工全面测试，存在逻辑漏洞风险。