Code CLI 四大工具速查笔记

一屏总览

先判断是“一次性查询”还是“长任务交互”。一次性查询优先用 headless/print/run，长任务再进入 TUI。

Codex CLI

适合 OpenAI 生态、代码修改、审查和可控沙箱执行。

codex codex exec "..."

Claude Code CLI

适合长上下文代码协作、计划模式、MCP 和后台任务。

claude claude -p "..."

Gemini CLI

适合 Google 模型、headless 任务、扩展、skills 和策略控制。

gemini gemini -p "..."

OpenCode CLI

适合多 provider、TUI/Web/Server、多模型和会话导入导出。

opencode opencode run "..."

快速查询矩阵

这张表是最常打开看的部分：启动、一次性查询、恢复、模型、权限、MCP、诊断和更新。

场景	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 "总结当前仓库"`
继续最近会话	`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 exec "..." claude -p "..." gemini -p "..." opencode run "..."

适合解释报错、总结日志、比较方案、生成小段命令。

分析当前目录

codex "解释当前项目结构" claude "解释当前项目结构"

长任务建议进入 TUI，便于保留上下文和继续修改。

分析日志文件

Get-Content .\app.log | claude -p "找出最可能的错误原因"

PowerShell 下也可以把测试输出、构建输出直接管道给 CLI。

指定工作目录

codex -C D:\project opencode D:\project opencode run --dir D:\project "..."

Claude 和 Gemini 通常先 cd 到目标目录再运行。

增加可访问目录

codex --add-dir D:\lib claude --add-dir D:\lib gemini --include-directories D:\lib

用于跨项目读取库、文档或共享组件。

输出 JSON

codex exec --json "..." claude -p --output-format json "..." gemini -p --output-format json "..." opencode run --format json "..."

适合脚本消费、流水线分析、批处理。

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

Codex CLI

主命令：codex，一次性任务：codex exec

常用入口

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

一次性任务

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 resume --last
codex resume --all
codex resume <SESSION_ID> "继续刚才的问题"
codex fork --last
codex review
codex apply
codex exec resume --last "继续"

MCP / 登录 / 诊断

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

关键 exec 参数

--sandbox read-only 只读分析；--sandbox workspace-write 允许写工作区；--json 输出 JSONL；-o 写出最后回复；--ephemeral 不保存会话文件。

适用场景

需要 OpenAI 模型、受控沙箱、代码审查、自动修复、从非交互命令串到流水线时，优先考虑 Codex CLI。

Codex 交互内斜杠命令

/model切换模型和推理强度

/plan先给方案再动手

/review审查当前工作区改动

/diff查看改动

/status查看模型、权限、工作目录

/permissions调整审批和权限策略

/mcp查看 MCP 工具和诊断

/init生成 AGENTS.md

/new新开会话

/clear清空当前上下文

/resume恢复会话

/fork分叉会话

/goal设置或查看任务目标

/mention附加文件或目录上下文

/skills选择本地 skill

/quit退出

Claude Code CLI

主命令：claude，一次性任务：claude -p

常用入口

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

模型与权限

claude --model sonnet
claude --model opus
claude --effort high
claude --permission-mode plan
claude --permission-mode acceptEdits
claude --permission-mode bypassPermissions
claude --add-dir D:\lib

结构化输出

claude -p --output-format json "总结当前 diff"
claude -p --output-format stream-json "实时输出处理过程"
claude -p --json-schema '{"type":"object"}' "提取信息"
claude -p --max-budget-usd 1 "控制成本"

MCP / 认证 / 更新

claude auth login
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

脚本友好参数

--bare 是最小模式；--tools 限制可用工具；--allowedTools 和 --disallowedTools 控制免确认或禁用的工具。

适用场景

需要长上下文、计划模式、复杂代码协作、MCP 配置或多轮背景任务时，Claude Code CLI 很适合做主力交互工具。

Claude 交互内斜杠命令

/init初始化 CLAUDE.md

/memory管理项目记忆

/mcp管理 MCP 连接

/agents管理 subagents

/permissions管理工具权限规则

/plan进入计划模式

/model切换模型

/effort调整推理强度

/context查看上下文占用

/compact压缩上下文

/btw旁路问题

/background转后台

/tasks查看后台任务

/diff查看当前改动

/code-review审查正确性问题

/security-review安全审查

/resume恢复会话

/rewind回退对话或代码检查点

/status查看状态

/usage查看用量

Gemini CLI

主命令：gemini，一次性任务：gemini -p

常用入口

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

会话与权限

gemini --list-sessions
gemini --delete-session 3
gemini --include-directories D:\lib
gemini --skip-trust
gemini --approval-mode plan
gemini --approval-mode auto_edit
gemini --approval-mode yolo
gemini -y

输出与模型

gemini -m <model>
gemini -p --output-format json "总结当前 diff"
gemini -p --output-format stream-json "流式输出"
gemini --screen-reader
gemini --raw-output

MCP / 扩展 / 技能

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 install <source>

特殊输入

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

@ 注入文件或目录内容；! 执行 shell 命令或切换 shell 模式。

适用场景

需要 Google 模型、headless 执行、策略控制、extensions、skills 或和 Google 生态配套时优先考虑 Gemini CLI。

Gemini 交互内命令

/help查看帮助

/chat save保存当前对话

/chat resume恢复保存的对话

/clear清屏

/compress压缩上下文

/commands list列出自定义命令

/directory add管理工作区目录

/mcp查看 MCP server 和工具

/memory管理 GEMINI.md 记忆

/model set设置模型

/permissions trust管理目录信任

/plan计划模式

/restore恢复工具执行前状态

/rewind回看并回退历史

/resume浏览和恢复会话

/stats查看统计

/tools查看可用工具

/quit退出

OpenCode CLI

主命令：opencode，一次性任务：opencode run

常用入口

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

一次性任务

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 "在这个目录分析"

会话 / 模型 / 统计

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 import .\session.json

MCP / Provider / Agent

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

Server / Web

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

这类命令会启动长期进程，需要明确预览或远程连接场景再运行。

GitHub / 插件 / 更新

opencode pr <number>
opencode github install
opencode github run
opencode plugin <module>
opencode plug <module>
opencode debug --help
opencode db path
opencode upgrade
opencode completion

OpenCode TUI 命令与自定义命令

/init初始化项目上下文

/undo撤销

/redo重做

/share分享会话

/help查看帮助

自定义命令位置

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

常用占位

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

Windows 使用注意

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

官方文档入口

CLI 升级后，优先重新看本机 --help，再对照官方文档。

Codex CLI Referencedevelopers.openai.com Codex Non-interactivedevelopers.openai.com Codex Slash Commandsdevelopers.openai.com Claude Code CLIcode.claude.com Claude Code Commandscode.claude.com Gemini CLIgoogle-gemini.github.io Gemini Headless Modegoogle-gemini.github.io OpenCode CLIopencode.ai OpenCode Commandsopencode.ai 源 Markdown 手册本地文件

升级后重新核对

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

一屏总览

Codex CLI

Claude Code CLI

Gemini CLI

OpenCode CLI

快速查询矩阵

按任务查命令

快速问一个问题

分析当前目录

分析日志文件

指定工作目录

增加可访问目录

输出 JSON

Codex CLI

常用入口

一次性任务

会话与审查

MCP / 登录 / 诊断

关键 exec 参数

适用场景

Claude Code CLI

常用入口

模型与权限

结构化输出

MCP / 认证 / 更新

脚本友好参数

适用场景

Gemini CLI

常用入口

会话与权限

输出与模型

MCP / 扩展 / 技能

特殊输入

适用场景

OpenCode CLI

常用入口

一次性任务

会话 / 模型 / 统计

MCP / Provider / Agent

Server / Web

GitHub / 插件 / 更新

自定义命令位置

常用占位

推荐工作流

只问问题

审查当前改动

分析命令输出

先规划再执行

控制写入范围

Windows 使用注意

官方文档入口

升级后重新核对