Skip to content

Codex CLI 安装与使用教程:登录、命令、权限与常见问题 ​

如果你搜索 Codex CLI 安装、Codex 命令行怎么用、OpenAI Codex 终端教程,这篇可以直接照着做。Codex CLI 适合在终端中阅读仓库、修改代码、运行命令和检查 Git 变化,也可以通过 codex exec 接入脚本或重复任务。

使用前提醒

安装命令、登录入口、可用模型和权限选项会随版本更新。以下步骤以 Codex CLI 官方文档 为准,遇到界面差异时优先查看官方页面。

第一步:安装 Codex CLI ​

macOS 和 Linux 可以使用官方提供的独立安装脚本:

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

安装完成后,重新打开终端,检查命令是否可用:

bash
codex --help

Windows 用户请在官方 CLI 页面切换到 Windows 安装方式,并确认 PowerShell、Git 和项目运行时已经准备好。不要把不同版本的安装命令混在同一台机器上;如果系统里已有旧的 codex,先用 which codex 或 Windows 的命令定位工具确认实际调用的是哪个版本。

第二步:登录并进入项目 ​

进入一个已有 Git 仓库,再启动 Codex:

bash
cd ~/code/your-project
codex

第一次运行时,按屏幕提示选择可用的登录方式。登录完成后,先让 Codex 解释项目:

text
请先阅读项目结构、README、package.json 和测试目录。
告诉我这个项目如何安装、启动和运行测试,不要修改文件。

如果 Codex 没有正确识别项目,先确认当前目录、Git 状态、依赖是否安装,以及项目是否被当前环境访问。

广告|先做中文代码问答

如果你暂时只需要中文代码解释、报错分析、接口文档或提示词整理,可以先查看以下第三方 AI 入口。它们不等同于 Codex CLI,本地文件读写、命令执行和审批能力请以平台当前说明为准。

常用命令和斜杠命令 ​

命令用途
codex打开交互式终端界面
codex exec "任务描述"以脚本或自动化方式执行一项任务
/init在当前目录生成 AGENTS.md 起始文件
/status查看当前会话的模型、目录和权限状态
/permissions调整当前任务允许的操作范围
/model查看或切换当前可用模型和推理设置
/review检查当前变更并寻找问题
/compact压缩较长会话的上下文

不同版本可能会新增、调整或隐藏命令。输入 / 或查看官方命令参考,可以确认当前客户端支持的选项。

第三步:完成一个最小任务 ​

先从小范围改动开始,例如:

text
请修复首页在移动端横向滚动的问题。

先检查相关 CSS、布局组件和已有测试,不要修改无关页面。
完成后运行 lint 和构建命令;如果项目没有对应脚本,请先说明。
最后列出修改文件、根因、验证命令和结果。

任务结束后,检查:

  1. git diff 是否只包含预期文件。
  2. 测试、lint、构建是否真的运行过。
  3. 是否新增了依赖、环境变量或未说明的配置。
  4. 是否改变了 API、权限、数据结构或公开行为。

codex exec 适合什么场景? ​

当任务有稳定输入和明确验收标准时,可以使用 codex exec 进行重复工作,例如生成变更说明、检查一组文件或在 CI 前做静态审阅。自动化任务应遵守三个原则:

  • 输入尽量来自受控文件或参数,不要把密钥拼接进命令行。
  • 输出要保存为可检查的文本或补丁,失败时保留日志。
  • 发布、删除、迁移和推送等动作仍然由人工或独立流水线确认。

示例:

bash
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,不要每次重复粘贴。

最小工作流 ​

text
1. git status
2. codex
3. 先读项目并给计划
4. 允许小范围修改
5. 运行测试和构建
6. 检查 git diff
7. 必要时使用 /review
8. 由人工决定提交、推送或发布

继续阅读:Codex 提示词与 AGENTS.md 教程。

非 Google 官方网站。内容用于中文用户了解 Gemini 模型与可用入口。