Codex CLI 安装与使用教程:登录、命令、权限与常见问题
如果你搜索 Codex CLI 安装、Codex 命令行怎么用、OpenAI Codex 终端教程,这篇可以直接照着做。Codex CLI 适合在终端中阅读仓库、修改代码、运行命令和检查 Git 变化,也可以通过 codex exec 接入脚本或重复任务。
使用前提醒
安装命令、登录入口、可用模型和权限选项会随版本更新。以下步骤以 Codex CLI 官方文档 为准,遇到界面差异时优先查看官方页面。
第一步:安装 Codex CLI
macOS 和 Linux 可以使用官方提供的独立安装脚本:
curl -fsSL https://chatgpt.com/codex/install.sh | sh安装完成后,重新打开终端,检查命令是否可用:
codex --helpWindows 用户请在官方 CLI 页面切换到 Windows 安装方式,并确认 PowerShell、Git 和项目运行时已经准备好。不要把不同版本的安装命令混在同一台机器上;如果系统里已有旧的 codex,先用 which codex 或 Windows 的命令定位工具确认实际调用的是哪个版本。
第二步:登录并进入项目
进入一个已有 Git 仓库,再启动 Codex:
cd ~/code/your-project
codex第一次运行时,按屏幕提示选择可用的登录方式。登录完成后,先让 Codex 解释项目:
请先阅读项目结构、README、package.json 和测试目录。
告诉我这个项目如何安装、启动和运行测试,不要修改文件。如果 Codex 没有正确识别项目,先确认当前目录、Git 状态、依赖是否安装,以及项目是否被当前环境访问。
广告|先做中文代码问答
如果你暂时只需要中文代码解释、报错分析、接口文档或提示词整理,可以先查看以下第三方 AI 入口。它们不等同于 Codex CLI,本地文件读写、命令执行和审批能力请以平台当前说明为准。
常用命令和斜杠命令
| 命令 | 用途 |
|---|---|
codex | 打开交互式终端界面 |
codex exec "任务描述" | 以脚本或自动化方式执行一项任务 |
/init | 在当前目录生成 AGENTS.md 起始文件 |
/status | 查看当前会话的模型、目录和权限状态 |
/permissions | 调整当前任务允许的操作范围 |
/model | 查看或切换当前可用模型和推理设置 |
/review | 检查当前变更并寻找问题 |
/compact | 压缩较长会话的上下文 |
不同版本可能会新增、调整或隐藏命令。输入 / 或查看官方命令参考,可以确认当前客户端支持的选项。
第三步:完成一个最小任务
先从小范围改动开始,例如:
请修复首页在移动端横向滚动的问题。
先检查相关 CSS、布局组件和已有测试,不要修改无关页面。
完成后运行 lint 和构建命令;如果项目没有对应脚本,请先说明。
最后列出修改文件、根因、验证命令和结果。任务结束后,检查:
git diff是否只包含预期文件。- 测试、lint、构建是否真的运行过。
- 是否新增了依赖、环境变量或未说明的配置。
- 是否改变了 API、权限、数据结构或公开行为。
codex exec 适合什么场景?
当任务有稳定输入和明确验收标准时,可以使用 codex exec 进行重复工作,例如生成变更说明、检查一组文件或在 CI 前做静态审阅。自动化任务应遵守三个原则:
- 输入尽量来自受控文件或参数,不要把密钥拼接进命令行。
- 输出要保存为可检查的文本或补丁,失败时保留日志。
- 发布、删除、迁移和推送等动作仍然由人工或独立流水线确认。
示例:
codex exec "检查当前分支的变更,列出潜在回归风险;只读,不修改文件。"权限和沙盒怎么选?
新手可以采用“项目内修改 + 关键动作审批”的方式。这样 Codex 能完成普通编码工作,同时在访问项目外文件、网络、发布和破坏性命令前停下来让你判断。
不要一开始就开启全盘访问。特别需要留意以下操作:
rm、批量覆盖、重置或清理命令。git push、发布脚本、数据库迁移。- 读取
.env、SSH 密钥、云凭据和客户文件。 - 自动安装未知依赖或向外部地址上传代码。
沙盒模式和审批策略是两类不同控制:沙盒决定技术上能触及什么,审批决定什么时候必须询问你。具体设置请查看 Codex 官方文档 中与你使用的客户端对应的说明。
常见报错排查
command not found: codex
先重新打开终端,再确认安装目录是否在 PATH 中。如果机器上有多个版本,使用 which codex 或系统对应的命令定位工具检查实际路径。
登录成功但无法读取项目
确认当前目录是否正确、项目是否被当前客户端打开、权限是否限制在其他目录,以及 Git 仓库是否包含必要文件。先运行 pwd、git status,再让 Codex 只读检查。
Codex 不愿意执行命令
查看当前 /permissions 状态和审批提示。很多情况下不是模型不会做,而是当前沙盒或审批策略要求你先授权。
改动很多但没有测试结果
让 Codex 停止继续扩展,先输出当前 diff 和测试计划。确认项目实际存在的测试脚本后,再逐项运行,不要让它凭空声称“已验证”。
上下文太长、回答开始跑题
把任务拆成“理解、实现、测试、审查”几轮;使用 /compact 前先保存关键约束;把长期规则放进 AGENTS.md,不要每次重复粘贴。
最小工作流
1. git status
2. codex
3. 先读项目并给计划
4. 允许小范围修改
5. 运行测试和构建
6. 检查 git diff
7. 必要时使用 /review
8. 由人工决定提交、推送或发布继续阅读:Codex 提示词与 AGENTS.md 教程。