一、背景说明

Codex 是 OpenAI 推出的 AI 编程智能体，能够在本地终端中读取项目文件、修改代码、执行命令。根据官方说明，Codex 包含在 ChatGPT Plus、Pro、Business、Edu 及 Enterprise 套餐中。用户可通过 ChatGPT 账号直接登录使用，无需单独配置 API 密钥。

本文记录的是从订阅准备到 Codex CLI 本地部署的完整过程，以及在权限控制、任务拆分等方面的实践体会。

二、前期准备

2.1 操作路径：开gpt

官网：https://bewild.ai?code=BPFKOWPA

三、Codex CLI 安装

3.1 环境要求

Codex CLI 基于 Node.js 运行，建议使用 Node.js 22 及以上版本。

bash

# 检查 Node.js 版本
node --version

3.2 安装方式

官方提供多种安装方式：

方式一：npm 安装（推荐）

bash

npm install -g @openai/codex

方式二：Homebrew（macOS）

bash

brew install --cask codex

方式三：直接安装脚本（macOS/Linux）

bash

curl -fsSL https://chatgpt.com/codex/install.sh | sh

方式四：Windows PowerShell

powershell

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

安装完成后，可通过以下命令确认：

bash

codex --version

3.3 Windows 环境说明

Windows 用户建议通过 WSL2 运行 Codex CLI：

powershell

# PowerShell（管理员）

wsl --install

然后在 WSL2 环境中安装 Node.js 22+，再按 Linux 流程安装 Codex CLI。

四、登录认证

进入目标项目目录，执行启动命令：

bash

cd your-project
codex

首次运行会自动弹出浏览器窗口，选择 Sign in with ChatGPT 即可完成认证。

Codex CLI 支持两种认证方式：

认证方式	适用场景
ChatGPT 账号登录	Plus/Pro 订阅用户，消耗套餐内额度
API Key 登录	按 API 实际用量单独计费

对于个人开发场景，建议优先使用 ChatGPT 账号登录。

五、使用建议

5.1 初次使用流程

新手容易犯的错误是直接要求 Codex 进行大规模重构，导致执行步骤过多、难以追踪改动。建议按以下流程逐步推进：

第一步：让 Codex 先理解项目

text

请阅读当前项目目录，输出：
1. 项目功能概述
2. 入口文件位置
3. 依赖安装与启动方式
4. 当前存在的潜在问题
暂不修改任何代码。

第二步：分配明确的小范围任务

text

请新增一个 /health 接口，返回 {"status":"ok"}。
约束：
1. 仅修改必要的文件
2. 不涉及无关模块
3. 完成后输出改动文件清单

第三步：验证改动结果

让 Codex 执行测试或提供手动验证步骤。

5.2 权限控制

Codex 默认启用安全确认机制，在执行文件读写或命令操作时会请求用户授权。若希望在可控范围内减少确认频次，可在任务描述中明确授权范围，或通过启动参数调整：

bash

codex --dangerously-bypass-approvals-and-sandbox

建议仅在熟悉 Codex 行为模式且项目已做好版本备份的情况下使用该参数。

六、版本管理建议

由于 Codex 具备文件写入和命令执行能力，建议在每次任务执行前进行版本备份：

bash

git add .
git commit -m "checkpoint: before codex task"

执行完成后，可通过 git diff 查看具体改动，确认无误后再提交。

七、常见问题

7.1 安装失败

• 检查 Node.js 版本是否满足要求（建议 22+）

• npm 全局安装若报权限错误，可调整 npm 全局目录权限，或使用 nvm 管理 Node.js 版本

7.2 登录认证失败

• 确认 ChatGPT Plus 订阅处于有效状态

• 检查网络环境是否能够正常访问 OpenAI 服务

• 如使用 API Key 登录，确认账号内有可用余额

八、总结

从订阅到 Codex 本地使用的完整路径为：

1. 获取 ChatGPT Plus 订阅

2. 安装 Node.js 依赖环境

3. 通过 npm 或其他方式安装 Codex CLI

4. 使用 ChatGPT 账号登录认证

5. 从项目理解开始，逐步分配明确任务

6. 配合 Git 版本管理进行安全迭代

核心建议：从小任务开始，逐步建立对工具行为的理解和掌控。这种方式更适合将 AI 编程工具融入日常开发流程。