Codex CLI 首次运行

安装完成后，进入你要处理的项目目录，再启动 Codex CLI。

cd your-project
codex

选择认证方式

Codex 通常支持两种认证路径：

1. 使用 ChatGPT / OpenAI 账号登录
2. 使用 API Key

如果你使用 Code8 的 API Key，先参考：订阅 Code8，把 config.toml 和 auth.json 配置好。

第一个 CLI 任务

建议第一次只做一个低风险任务，例如：

请阅读当前项目结构，告诉我主要目录分别负责什么，不要修改文件。

如果 Codex 能正常读取目录并给出说明，说明认证和工作目录都已经可用。

逐步放开权限

第一次运行时，不建议直接让 Codex 修改大量文件。可以按下面顺序逐步验证：

1. 只读项目结构
2. 让 Codex 找一个明确文件并解释代码
3. 让 Codex 修改一个小文件
4. 让 Codex 运行测试或构建命令

权限和审批策略可以继续看：权限管理。

配置是否生效

如果你配置了 API Key，但 Codex 仍然不能使用，优先检查：

1. auth.json 是否是合法 JSON
2. API Key 是否完整复制
3. config.toml 是否放在正确目录
4. 终端或 Codex 是否已经重启
5. Code8 账号余额是否充足