# Code CLI 四大工具快捷命令手册

> 面向日常工作查询：Codex CLI、Claude Code CLI、Gemini CLI、OpenCode CLI。
> 生成日期：2026-05-22。以下命令以本机 `--help` 输出为主，并参考官方文档补充。

## 一、先看这张总表

| 场景 | Codex CLI | Claude Code CLI | Gemini CLI | OpenCode CLI |
|---|---|---|---|---|
| 打开交互界面 | `codex` | `claude` | `gemini` | `opencode` |
| 带一句话启动 | `codex "解释这个项目"` | `claude "解释这个项目"` | `gemini "解释这个项目"` | `opencode --prompt "解释这个项目"` |
| 一次性查询后退出 | `codex exec "总结当前仓库"` | `claude -p "总结当前仓库"` | `gemini -p "总结当前仓库"` | `opencode run "总结当前仓库"` |
| 管道输入 | `type log.txt \| codex exec "分析错误"` | `type log.txt \| claude -p "分析错误"` | `type log.txt \| gemini -p "分析错误"` | `type log.txt \| opencode run "分析错误"` |
| 继续最近会话 | `codex resume --last` | `claude -c` | `gemini -r latest` | `opencode -c` |
| 继续一次性任务 | `codex exec resume --last "继续"` | `claude -c -p "继续"` | `gemini -r latest -p "继续"` | `opencode run -c "继续"` |
| 指定模型 | `codex -m <model>` | `claude --model <model>` | `gemini -m <model>` | `opencode -m <provider/model>` |
| 只读/计划模式 | `codex -s read-only` 或 `/plan` | `claude --permission-mode plan` 或 `/plan` | `gemini --approval-mode plan` 或 `/plan` | 用 agent 权限或提示词约束，谨慎开启自动批准 |
| 自动批准高风险操作 | `--dangerously-bypass-approvals-and-sandbox` | `--dangerously-skip-permissions` | `-y` / `--yolo` | `--dangerously-skip-permissions` |
| MCP 管理 | `codex mcp ...` | `claude mcp ...` | `gemini mcp ...` | `opencode mcp ...` |
| 健康检查 | `codex doctor` | `claude doctor` | `gemini --help` / `/about` | `opencode debug ...` |
| 更新 | `codex update` | `claude update` | 以安装方式更新，本机 help 未列出 `update` | `opencode upgrade` |

本机版本快照：

| 工具 | 本机版本 |
|---|---|
| Codex CLI | `codex-cli 0.132.0` |
| Claude Code CLI | `2.1.122 (Claude Code)` |
| Gemini CLI | `0.42.0` |
| OpenCode CLI | `1.14.48` |

## 二、日常任务速查

| 你想做什么 | 推荐命令 |
|---|---|
| 快速问一个问题，不进入 TUI | `codex exec "..."` / `claude -p "..."` / `gemini -p "..."` / `opencode run "..."` |
| 让 AI 看当前目录并解释项目 | `codex "解释当前项目结构"` / `claude "解释当前项目结构"` / `gemini "解释当前项目结构"` / `opencode --prompt "解释当前项目结构"` |
| 分析日志文件 | `Get-Content .\app.log \| claude -p "找出最可能的错误原因"` |
| 指定工作目录 | `codex -C D:\project` / `claude` 先 `cd` / `gemini` 先 `cd` / `opencode D:\project` 或 `opencode run --dir D:\project "..."` |
| 加额外可访问目录 | `codex --add-dir D:\lib` / `claude --add-dir D:\lib` / `gemini --include-directories D:\lib` |
| 让工具只读分析 | `codex -s read-only "..."` / `claude --permission-mode plan "..."` / `gemini --approval-mode plan "..."` |
| 自动改代码但限制在项目内 | `codex exec --sandbox workspace-write "..."` / `claude --permission-mode acceptEdits "..."` / `gemini --approval-mode auto_edit "..."` |
| 输出 JSON 供脚本处理 | `codex exec --json "..."` / `claude -p --output-format json "..."` / `gemini -p --output-format json "..."` / `opencode run --format json "..."` |
| 查看 MCP 配置 | `codex mcp list` / `claude mcp list` / `gemini mcp list` / `opencode mcp list` |
| 查看可用模型 | Codex 用 `/model` 或配置；Claude 用 `/model`；Gemini 用 `-m` 或 `/model`; OpenCode 用 `opencode models` |
| 查看 token/费用/状态 | Codex `/status`; Claude `/usage` 或 `/status`; Gemini `/stats`; OpenCode `opencode stats` |

高风险提示：所有 `dangerously`、`yolo`、`bypass` 类参数都只适合隔离环境、临时目录或你完全确认命令影响范围的场景。

## 三、Codex CLI

### 1. 常用入口

```powershell
codex
codex "解释当前项目"
codex -C D:\project "检查这个项目的测试入口"
codex -m gpt-5.3-codex
codex --search "联网查一下这个库的最新迁移方式"
codex --no-alt-screen
```

`codex` 不加子命令会进入交互 TUI。`-C/--cd` 用于指定工作根目录，`--add-dir` 用于额外授权可写目录。

### 2. 一次性任务

```powershell
codex exec "总结当前仓库结构"
codex e "总结当前仓库结构"
Get-Content .\error.log | codex exec "找出关键错误并给出排查步骤"
codex exec --sandbox workspace-write "修复最小问题并运行相关测试"
codex exec --json "分析当前 diff 风险"
codex exec -o .\summary.md "生成当前项目说明"
codex exec --output-schema .\schema.json "提取项目信息"
codex exec --ephemeral "临时分析，不保存会话文件"
```

常用 `exec` 参数：

| 参数 | 用途 |
|---|---|
| `--sandbox read-only` | 只读，适合分析和审查 |
| `--sandbox workspace-write` | 允许写工作区，适合自动修复 |
| `--sandbox danger-full-access` | 广泛访问，高风险 |
| `--json` | 输出 JSONL 事件流 |
| `-o, --output-last-message <file>` | 把最后回复写入文件 |
| `--output-schema <file>` | 要求最终输出符合 JSON Schema |
| `--skip-git-repo-check` | 允许在非 Git 目录运行 |
| `--ignore-user-config` | 不加载用户配置 |
| `--ignore-rules` | 不加载 execpolicy rules |

### 3. 会话与审查

```powershell
codex resume --last
codex resume --all
codex resume <SESSION_ID> "继续刚才的问题"
codex fork --last
codex review
codex apply
```

`resume` 是继续交互会话，`exec resume` 是继续非交互任务：

```powershell
codex exec "审查当前改动"
codex exec resume --last "修复刚才发现的问题"
```

### 4. MCP、登录、诊断、更新

```powershell
codex login
codex logout
codex mcp list
codex mcp get <name>
codex mcp add <name> <command-or-url>
codex mcp remove <name>
codex doctor
codex doctor --summary
codex update
codex completion powershell
```

### 5. 交互内斜杠命令

| 命令 | 用途 |
|---|---|
| `/model` | 切换模型和推理强度 |
| `/plan` | 进入计划模式，先给方案再动手 |
| `/review` | 审查当前工作区改动 |
| `/diff` | 查看改动 |
| `/status` | 查看模型、权限、工作目录、上下文 |
| `/permissions` | 调整审批/权限策略 |
| `/mcp` / `/mcp verbose` | 查看 MCP 工具和诊断 |
| `/init` | 生成 `AGENTS.md` 项目指令文件 |
| `/new` / `/clear` | 新开会话或清空当前上下文 |
| `/resume` | 在 TUI 内恢复会话 |
| `/fork` / `/side` | 分叉会话或开临时旁路问题 |
| `/goal` | 设置、查看、暂停、清除任务目标 |
| `/mention` | 附加文件或目录上下文 |
| `/skills` | 选择本地 skill |
| `/hooks` | 查看生命周期 hook |
| `/copy` | 复制上一条回复 |
| `/debug-config` | 检查配置层级和策略来源 |
| `/quit` / `/exit` | 退出 |

## 四、Claude Code CLI

### 1. 常用入口

```powershell
claude
claude "解释当前项目"
claude -p "总结当前目录"
Get-Content .\error.log | claude -p "分析错误原因"
claude -c
claude -r "<session-id-or-name>" "继续处理"
```

Claude Code 默认进入交互模式；`-p/--print` 是一次性输出并退出，适合脚本、管道和快速查询。

### 2. 常用参数

| 参数 | 用途 |
|---|---|
| `-p, --print` | 非交互输出后退出 |
| `-c, --continue` | 继续当前目录最近会话 |
| `-r, --resume [value]` | 按 ID/名称恢复会话，或打开选择器 |
| `--fork-session` | 恢复时新建分叉会话 |
| `--model <model>` | 指定模型，如 `sonnet`、`opus` 或完整模型名 |
| `--effort low|medium|high|xhigh|max` | 设置推理强度 |
| `--permission-mode default|acceptEdits|auto|dontAsk|plan|bypassPermissions` | 设置权限模式 |
| `--add-dir <dir...>` | 额外授权目录 |
| `--allowedTools ...` | 允许特定工具免确认 |
| `--disallowedTools ...` | 禁止特定工具或工具模式 |
| `--tools "Bash,Edit,Read"` | 限制可用内置工具 |
| `--output-format text|json|stream-json` | 设置输出格式，仅 `--print` 下常用 |
| `--json-schema '<schema>'` | 结构化输出 |
| `--max-budget-usd <amount>` | 限制 API 花费，仅 `--print` |
| `--mcp-config <file-or-json>` | 加载 MCP 配置 |
| `--strict-mcp-config` | 只使用传入的 MCP 配置 |
| `--settings <file-or-json>` | 指定设置 |
| `--bare` | 最小模式，跳过 hooks、插件、自动发现等，适合脚本 |
| `--debug` / `--debug-file <path>` | 调试日志 |

### 3. MCP、认证、更新、审查

```powershell
claude auth login
claude auth login --console
claude auth status
claude auth logout

claude mcp list
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
claude mcp add my-server -- npx my-mcp-server
claude mcp get <name>
claude mcp remove <name>

claude doctor
claude update
claude install stable
claude plugin --help
claude agents --json
claude ultrareview 1234 --json
```

### 4. 交互内斜杠命令

| 命令 | 用途 |
|---|---|
| `/init` | 生成或初始化 `CLAUDE.md` |
| `/memory` | 管理项目记忆 |
| `/mcp` | 管理 MCP 连接 |
| `/agents` | 管理 subagents / background agents |
| `/permissions` | 管理工具权限规则 |
| `/plan` | 进入计划模式 |
| `/model` | 切换模型 |
| `/effort` | 调整推理强度 |
| `/context` | 查看上下文占用 |
| `/compact` | 压缩上下文 |
| `/btw` | 问一个不污染主上下文的旁路问题 |
| `/background` / `/bg` | 将当前会话转后台 |
| `/tasks` | 查看后台任务 |
| `/batch` | 大任务拆分并行处理 |
| `/diff` | 查看当前改动 |
| `/code-review` | 审查当前 diff 的正确性问题 |
| `/review` | 本地 PR 或改动审查 |
| `/security-review` | 安全审查 |
| `/clear` | 新开空上下文 |
| `/resume` | 恢复会话 |
| `/branch` / `/fork` | 分叉当前会话 |
| `/rewind` | 回退对话或代码检查点 |
| `/doctor` / `/debug` | 诊断问题 |
| `/status` / `/usage` | 查看状态、费用和用量 |
| `/copy` | 复制回复 |
| `/exit` / `/quit` | 退出 |

## 五、Gemini CLI

### 1. 常用入口

```powershell
gemini
gemini "解释当前项目"
gemini -p "总结当前目录"
gemini -i "先解释项目，然后继续交互"
Get-Content .\error.log | gemini -p "分析错误原因"
gemini -r latest
gemini -r latest "继续刚才任务"
```

Gemini CLI 默认进入交互模式。`-p/--prompt` 是 headless 模式；`-i/--prompt-interactive` 是先执行提示词，再留在交互模式。

### 2. 常用参数

| 参数 | 用途 |
|---|---|
| `-p, --prompt <text>` | 非交互模式 |
| `-i, --prompt-interactive <text>` | 执行提示词后继续交互 |
| `-m, --model <model>` | 指定模型 |
| `-r, --resume latest|<id>` | 恢复会话 |
| `--list-sessions` | 列出会话 |
| `--delete-session <index>` | 删除会话 |
| `--include-directories <dirs>` | 增加工作区目录 |
| `--skip-trust` | 本次信任当前工作区 |
| `-s, --sandbox` | 启用沙箱 |
| `--approval-mode default|auto_edit|yolo|plan` | 设置审批模式 |
| `-y, --yolo` | 自动接受所有动作，高风险 |
| `--policy` / `--admin-policy` | 加载策略文件或目录 |
| `--allowed-mcp-server-names` | 限制可用 MCP server |
| `-e, --extensions` | 指定启用的扩展 |
| `-l, --list-extensions` | 列出扩展 |
| `-o, --output-format text|json|stream-json` | 输出格式 |
| `--raw-output` | 禁用输出净化，高风险 |
| `--screen-reader` | 屏幕阅读器模式 |

### 3. MCP、扩展、技能、Hooks

```powershell
gemini mcp list
gemini mcp add <name> <commandOrUrl> [args...]
gemini mcp enable <name>
gemini mcp disable <name>
gemini mcp remove <name>

gemini extensions list
gemini skills list --all
gemini skills enable <name>
gemini skills disable <name>
gemini skills install <source>
gemini skills link <path>
gemini hooks list
```

### 4. 交互内命令与特殊前缀

| 命令 | 用途 |
|---|---|
| `/help` 或 `/?` | 查看帮助 |
| `/chat save <tag>` | 保存当前对话 |
| `/chat resume <tag>` | 恢复保存的对话 |
| `/chat list` / `/chat delete <tag>` | 列出或删除保存点 |
| `/clear` | 清屏 |
| `/compress` | 压缩上下文 |
| `/commands list` / `/commands reload` | 管理自定义命令 |
| `/copy` | 复制上一条输出 |
| `/directory add <path>` / `/directory show` | 管理工作区目录 |
| `/mcp` / `/mcp desc` / `/mcp schema` | 查看 MCP server 和工具 |
| `/memory list|show|refresh` | 管理 `GEMINI.md` 层级记忆 |
| `/model set <model> [--persist]` | 设置模型 |
| `/permissions trust` | 管理目录信任 |
| `/plan` | 计划模式 |
| `/restore [tool_call_id]` | 恢复工具执行前的文件状态 |
| `/rewind` | 回看并回退历史 |
| `/resume` | 浏览和恢复会话 |
| `/settings` | 打开设置 |
| `/skills list|enable|disable|reload` | 管理技能 |
| `/stats` | 查看会话、模型、工具统计 |
| `/tools [desc]` | 查看可用工具 |
| `/quit` / `/exit` | 退出 |
| `/vim` | 切换 Vim 编辑模式 |

特殊输入：

```text
@README.md 解释这个文件
@src/ 总结这个目录
!git status
!
```

`@` 会把文件或目录内容注入提示词；`!` 用于执行 shell 命令或切换 shell 模式。`!` 执行的命令等同于你在终端直接运行，注意权限和副作用。

## 六、OpenCode CLI

### 1. 常用入口

```powershell
opencode
opencode D:\project
opencode --prompt "解释当前项目"
opencode -c
opencode -s <session-id>
opencode -m anthropic/claude-sonnet-4-5
```

OpenCode 的模型格式通常是 `provider/model`，例如 `anthropic/...`、`openai/...`、`google/...`。不确定模型名时先运行 `opencode models`。

### 2. 一次性任务

```powershell
opencode run "总结当前仓库"
opencode run -m openai/gpt-5.3-codex "审查当前改动"
opencode run -f .\README.md "总结这个文件"
opencode run --format json "输出 JSON 事件"
opencode run -c "继续上一次任务"
opencode run -s <session-id> "继续指定会话"
opencode run --dir D:\project "在这个目录分析"
```

常用 `run` 参数：

| 参数 | 用途 |
|---|---|
| `-c, --continue` | 继续上一会话 |
| `-s, --session <id>` | 继续指定会话 |
| `--fork` | 继续前先分叉 |
| `-m, --model <provider/model>` | 指定模型 |
| `--agent <name>` | 指定 agent |
| `-f, --file <file>` | 附加文件 |
| `--format default|json` | 输出格式 |
| `--title <title>` | 设置会话标题 |
| `--attach <url>` | 连接运行中的 `opencode serve` |
| `--dir <path>` | 指定运行目录 |
| `--variant <level>` | 指定 provider 相关推理变体 |
| `--thinking` | 显示 thinking blocks |
| `--dangerously-skip-permissions` | 自动批准未显式拒绝的权限，高风险 |
| `-i, --interactive` | 直接交互 split-footer 模式 |

### 3. 会话、模型、统计

```powershell
opencode session list
opencode session delete <sessionID>
opencode models
opencode models anthropic
opencode models --refresh
opencode stats
opencode stats --days 7 --models 10
opencode export <sessionID>
opencode export <sessionID> --sanitize
opencode import .\session.json
```

### 4. MCP、认证、Agent、服务

```powershell
opencode auth login
opencode auth list
opencode auth logout

opencode mcp add
opencode mcp list
opencode mcp auth [name]
opencode mcp logout [name]
opencode mcp debug <name>

opencode agent list
opencode agent create

opencode serve --port 4096
opencode run --attach http://localhost:4096 "解释 async/await"
opencode web --port 4096
opencode attach http://localhost:4096
```

`opencode serve` 是无头 HTTP server，`opencode web` 会启动 server 并打开 Web 界面。需要长期运行时再开，不建议为了普通查询常驻。

### 5. GitHub、插件、更新、调试

```powershell
opencode pr <number>
opencode github install
opencode github run
opencode plugin <module>
opencode plug <module>
opencode debug --help
opencode db path
opencode upgrade
opencode upgrade v1.14.48
opencode completion
```

### 6. TUI 内命令与自定义命令

OpenCode 内置常见命令包括：

| 命令 | 用途 |
|---|---|
| `/init` | 初始化项目上下文 |
| `/undo` / `/redo` | 撤销或重做 |
| `/share` | 分享会话 |
| `/help` | 查看帮助 |

自定义命令可以放在：

```text
.opencode/commands/<name>.md
~/.config/opencode/commands/<name>.md
```

示例：

```markdown
---
description: Run tests with coverage
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---

Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.
```

然后在 TUI 中运行：

```text
/test
```

自定义命令里常用占位：

| 写法 | 用途 |
|---|---|
| `$ARGUMENTS` | 接收命令后面的全部参数 |
| `$1`, `$2`, `$3` | 接收第 1、2、3 个参数 |
| ``!`npm test` `` | 把 shell 命令输出注入 prompt |
| `@src/components/Button.tsx` | 把文件内容注入 prompt |

## 七、推荐工作流

### 1. 只问问题

```powershell
codex exec "解释 Laravel queue:work 和 horizon 的区别"
claude -p "解释 Laravel queue:work 和 horizon 的区别"
gemini -p "解释 Laravel queue:work 和 horizon 的区别"
opencode run "解释 Laravel queue:work 和 horizon 的区别"
```

### 2. 审查当前改动

```powershell
codex review
claude -p "请 review 当前 git diff，按严重程度列出问题"
gemini -p "请 review 当前 git diff，按严重程度列出问题"
opencode run "请 review 当前 git diff，按严重程度列出问题"
```

交互内可用：

```text
/review
/code-review
/security-review
/diff
```

### 3. 分析命令输出

```powershell
npm test 2>&1 | codex exec "总结失败测试并给最小修复建议"
npm test 2>&1 | claude -p "总结失败测试并给最小修复建议"
npm test 2>&1 | gemini -p "总结失败测试并给最小修复建议"
npm test 2>&1 | opencode run "总结失败测试并给最小修复建议"
```

### 4. 先规划再执行

```powershell
codex --sandbox read-only "先分析，不要修改文件，给迁移计划"
claude --permission-mode plan "先分析，不要修改文件，给迁移计划"
gemini --approval-mode plan "先分析，不要修改文件，给迁移计划"
opencode run "只读分析，不要修改文件，给迁移计划"
```

交互内优先用：

```text
/plan
```

### 5. 让工具改代码但控制范围

```powershell
codex exec --sandbox workspace-write "修复这个 bug，只改必要文件，并运行最小测试"
claude --permission-mode acceptEdits "修复这个 bug，只改必要文件，并运行最小测试"
gemini --approval-mode auto_edit "修复这个 bug，只改必要文件，并运行最小测试"
opencode run "修复这个 bug，只改必要文件，并运行最小测试"
```

## 八、Windows 使用注意

1. PowerShell 管道使用 `|`，重定向使用 `>` / `>>`。
2. 路径包含空格时加引号：`"D:\My Project"`。
3. Windows 里 `type` 和 `Get-Content` 都可读文件，复杂场景优先 `Get-Content`。
4. 不要把 `.env`、token、账号凭证直接粘进提示词；需要时让 CLI 读取本地配置，但最终输出不要泄露。
5. `--dangerously-*`、`--yolo`、`bypassPermissions` 只在隔离环境里用。
6. 长期运行的 server 类命令，如 `opencode serve`、`opencode web`，需要明确场景再启动。

## 九、官方文档入口

| 工具 | 官方文档 |
|---|---|
| Codex CLI | https://developers.openai.com/codex/cli/reference |
| Codex CLI 非交互模式 | https://developers.openai.com/codex/noninteractive |
| Codex CLI 斜杠命令 | https://developers.openai.com/codex/cli/slash-commands |
| Claude Code CLI | https://code.claude.com/docs/en/cli-usage |
| Claude Code 命令 | https://code.claude.com/docs/en/commands |
| Gemini CLI | https://google-gemini.github.io/gemini-cli/docs/cli/ |
| Gemini CLI Headless Mode | https://google-gemini.github.io/gemini-cli/docs/cli/headless.html |
| Gemini CLI Commands | https://google-gemini.github.io/gemini-cli/docs/cli/commands.html |
| OpenCode CLI | https://opencode.ai/docs/cli/ |
| OpenCode Commands | https://opencode.ai/docs/commands/ |

## 十、升级后如何重新核对

```powershell
codex --version
codex --help
codex exec --help
codex mcp --help

claude --version
claude --help
claude mcp --help
claude auth --help

gemini --version
gemini --help
gemini mcp --help
gemini skills --help

opencode --version
opencode --help
opencode run --help
opencode session --help
opencode models --help
```

建议每次大版本升级后，优先重新看 `--help`，因为 CLI 参数变化通常比网页教程更快。