uView Plus Vue3 ： （ VIP Plus 付费版 ）

# codex 使用

# Codex CLI 模式使用说明

更新时间：2026-03-26 参考官方文档：

  • https://developers.openai.com/codex/cli
  • https://developers.openai.com/codex/cli/features
  • https://developers.openai.com/codex/cli/reference
  • https://developers.openai.com/codex/cli/slash-commands

# 1. 什么是 Codex CLI

Codex CLI 是 OpenAI 提供的终端编码代理，可以直接在本地终端中读取代码、修改文件、执行命令，并和你持续对话式协作。

最适合的场景：

  • 在本地项目里边聊边改代码
  • 让 Codex 帮你分析仓库、修 bug、补文档、写测试
  • 在终端里直接完成代码审查、执行计划、恢复历史会话
  • 在 CI 或脚本里用非交互模式执行一次性任务

# 2. 安装

官方安装方式：

npm i -g @openai/codex

✅ Copy success!

安装后直接运行：

codex

✅ Copy success!

也可以带一个初始问题启动：

codex "Explain this codebase to me"

✅ Copy success!

升级：

npm i -g @openai/codex@latest

✅ Copy success!

# 3. 登录

首次运行 codex 时会提示登录。官方支持两种方式：

# 3.1 用 ChatGPT 账号登录

直接执行：

codex login

✅ Copy success!

默认会拉起浏览器走 OAuth 登录流程。

如果当前环境不方便打开浏览器，可以用设备码方式：

codex login --device-auth

✅ Copy success!

# 3.2 用 API Key 登录

codex login --with-api-key

✅ Copy success!

通常会从标准输入读取 API Key。

查看当前是否已经登录：

codex login status

✅ Copy success!

退出登录：

codex logout

✅ Copy success!

# 4. CLI 模式到底怎么用

很多人说的“CLI 模式”，本质上就是在终端里直接运行 codex，进入一个全屏的交互式 TUI 会话。

启动命令：

codex

✅ Copy success!

进入后，你可以把它理解成“终端里的 AI 编程助手”：

  • 直接输入需求，例如“帮我分析这个项目结构”
  • 让它阅读当前仓库文件
  • 让它修改代码
  • 让它执行命令
  • 在执行前查看计划、审批动作
  • 通过斜杠命令调整模型、权限、计划模式等

最常见的使用方式：

进入项目目录
-> 执行 codex
-> 输入你的任务
-> 看 Codex 给出计划
-> 同意它读取/修改/执行
-> 审查结果

✅ Copy success!

# 5. 一个最小可用流程

# 5.1 进入项目目录

cd your-project

✅ Copy success!

# 5.2 启动 Codex

codex

✅ Copy success!

# 5.3 给出明确任务

例如：

帮我梳理这个项目的目录结构，并说明入口文件和核心模块。

✅ Copy success!

或者：

检查当前未提交改动，找出潜在 bug，并给出修复建议。

✅ Copy success!

再或者：

为 src/api/user.ts 补充单元测试。

✅ Copy success!

# 5.4 审批它的操作

在交互模式里，Codex 会说明下一步计划，并在需要时申请：

  • 读取文件
  • 编辑文件
  • 运行命令
  • 访问额外目录

你可以边看边决定是否放行。

# 6. 交互模式里最常用的能力

官方文档里明确提到，交互模式支持这些典型能力：

  • 直接发送提示词、代码片段、截图
  • 在改动前先查看计划
  • 在终端中查看语法高亮代码块和 diff
  • 用 /clear 清空当前对话
  • 用 /copy 复制最近一次完成输出
  • 用 Ctrl+C 或 /exit 退出

也可以直接带图片启动：

codex -i screenshot.png "Explain this error"

✅ Copy success!

多图：

codex --image img1.png,img2.jpg "Summarize these diagrams"

✅ Copy success!

# 7. 斜杠命令是 CLI 模式的关键

在 Codex CLI 里输入 /，会弹出内置命令列表。最常用的是下面这些：

# 7.1 会话控制

  • /clear：清空界面并开始新聊天
  • /new：在同一个 CLI 会话里开一个新对话
  • /resume：恢复历史会话
  • /quit 或 /exit：退出 CLI
  • /status：查看当前会话状态、模型、权限、上下文等

# 7.2 模型与模式

  • /model：切换当前模型
  • /fast：切换 Fast mode
  • /plan：切到计划模式，先让 Codex 出执行计划
  • /personality：调整回复风格

# 7.3 权限与环境

  • /permissions：调整审批策略
  • /sandbox-add-read-dir：在 Windows 下追加可读目录
  • /mcp：查看当前配置的 MCP 工具
  • /apps：浏览可插入到对话中的外部应用/连接器

# 7.4 工程相关

  • /diff：查看当前 Git diff
  • /review：让 Codex 对当前工作树做代码审查
  • /init：生成 AGENTS.md 模板，记录仓库级协作规则
  • /mention：主动把文件附加到上下文里
  • /fork：从当前对话分叉一个新线程
  • /agent：切换到某个子代理线程

# 8. 历史会话恢复

Codex 会在本地保存会话记录，所以不用每次从零开始。

恢复最近会话：

codex resume

✅ Copy success!

恢复当前目录最近一次会话：

codex resume --last

✅ Copy success!

跨目录查最近会话：

codex resume --all

✅ Copy success!

按会话 ID 恢复：

codex resume <SESSION_ID>

✅ Copy success!

这对长任务尤其有用，例如昨天分析到一半，今天继续做。

# 9. 非交互模式：适合脚本、自动化、CI

如果你不想进入交互界面，而是希望“执行完就退出”，用：

codex exec "为当前仓库生成变更摘要"

✅ Copy success!

官方说明里，codex exec 适合：

  • 脚本调用
  • CI 流水线
  • 批处理任务
  • 一次性自动化操作

常见参数：

codex exec --help

✅ Copy success!

比较重要的几个：

  • --cd：指定工作目录
  • --model：指定模型
  • --image：附带图片输入
  • --json：输出 JSON 事件流
  • --output-last-message：把最终回复写入文件
  • --ephemeral：不把本次 session 落盘
  • --sandbox：设置沙箱策略
  • --full-auto：低摩擦自动执行预设
  • --dangerously-bypass-approvals-and-sandbox 或 --yolo：跳过审批和沙箱，危险，不建议日常用

例如：

codex exec --cd . --model gpt-5.4 "检查当前仓库是否缺少测试"

✅ Copy success!

CI 常见用法：

codex exec --json --output-last-message result.txt "总结本次构建失败原因"

✅ Copy success!

# 10. 权限、审批、沙箱怎么理解

这是 CLI 模式最容易让新人困惑的地方。

官方文档里常见的沙箱值有：

  • read-only：只读，不能改文件
  • workspace-write：允许写当前工作区
  • danger-full-access：危险，全访问

审批策略常见值：

  • untrusted
  • on-request
  • never

其中官方特别提到：

  • --full-auto 相当于低摩擦自动模式，会设置为 workspace-write + on-request
  • 如果只是想多给几个目录写权限，优先用 --add-dir
  • 不要轻易用 danger-full-access
  • 更不要把 --full-auto 和 --yolo 混在普通环境里一起使用

追加额外可写目录：

codex --add-dir D:\path\to\extra\dir

✅ Copy success!

# 11. 常用命令速查

# 11.1 交互模式

codex
codex "Explain this repo"
codex --model gpt-5.4
codex -i error.png "Explain this error"

✅ Copy success!

# 11.2 登录与状态

codex login
codex login --device-auth
codex login status
codex logout

✅ Copy success!

# 11.3 历史会话

codex resume
codex resume --last
codex resume --all

✅ Copy success!

# 11.4 自动化模式

codex exec "生成 README 草稿"
codex exec --json "输出机器可读结果"
codex exec --full-auto "扫描项目中的潜在问题"

✅ Copy success!

# 11.5 其他实用命令

codex features list
codex features enable unified_exec
codex features disable shell_snapshot
codex mcp list
codex completion powershell

✅ Copy success!

# 12. PowerShell 补全

官方支持生成 PowerShell 补全脚本：

codex completion power-shell

✅ Copy success!

输出会打印到 stdout，你可以自行重定向到 PowerShell 的补全加载位置。

# 13. Windows 用户特别注意

官方当前说明是：

  • Codex CLI 支持 macOS 和 Linux
  • Windows 支持仍然是 experimental
  • 想获得更稳定的 Windows 体验，官方建议在 WSL 工作区中使用

所以如果你在原生 Windows 终端里碰到权限、路径、沙箱行为不一致，优先考虑切到 WSL。

# 14. 推荐的新手使用习惯

如果是第一次用，建议按这个顺序：

  1. 进入项目目录后执行 codex
  2. 先让它“解释代码结构”，不要一上来就让它大改
  3. 学会看 /status
  4. 学会用 /diff 审查变更
  5. 学会用 /plan 先出方案再执行
  6. 需要恢复上下文时用 codex resume --last
  7. 需要自动化时再用 codex exec

# 15. 一个推荐工作流示例

# 场景：修一个接口报错

cd 项目目录
codex
输入：帮我排查登录接口 500 的原因，先不要改代码，先给计划
输入：/plan
确认计划后，允许它读取相关文件
让它定位问题
让它修复
输入：/diff 检查改动
输入：/review 做一次审查
最后自己测试

✅ Copy success!

# 16. 总结

一句话理解：

codex 是交互式终端协作模式，适合边看边改；codex exec 是一次性非交互执行模式，适合脚本和 CI。

如果你只是想“在终端里像聊天一样让 Codex 帮你改项目”，记住下面这几个就够用了：

codex
codex resume --last
codex exec "你的任务"
codex login
codex login status

✅ Copy success!

← AI codex_install →