12 Codex CLI 首次运行

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

cd your-project
codex

选择认证方式

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

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

如果你使用 Code8 的 API Key，先参考：Codex API Key 获取与配置教程，把 config.toml 和 auth.json 配置好。

Windows 用户还会看到 native、WSL、winget、PowerShell 等不同说法。第一次运行时先确认 codex --version 能输出版本，再处理认证方式；不要同时在多个终端环境里改不同的配置文件。

第一个 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 账号余额是否充足

如果你不确定密钥从哪里创建，回到：配置 Code8 API Key。

如果你需要手动配置 config.toml、auth.json、代理或 openai_base_url，继续看：Codex config.toml 与 auth.json 配置说明。