第 8 章 命令大全
...
❓ 引导问题：CLI 有哪些启动方式和参数？斜杠命令分哪几类？如何在脚本中自动化使用 Claude Code？
📖 8.1 CLI 启动方式
| 命令 | 说明 | 示例 |
|---|---|---|
claude | 启动交互式 REPL | claude |
claude "query" | 带初始提示启动 REPL | claude "解释这个项目" |
claude -p "query" | 打印响应后退出（非交互模式） | claude -p "解释这个函数" |
cat file | claude -p "query" | 管道输入 | cat logs.txt | claude -p "分析日志" |
claude -c | 继续当前目录最近对话 | claude -c |
claude -c -p "query" | 通过 SDK 继续对话 | claude -c -p "检查类型错误" |
claude -r "session" "query" | 按 ID/名称恢复会话 | claude -r "auth-refactor" "完成 PR" |
claude update | 更新至最新版本 | claude update |
📖 8.2 CLI 标志全表
| 标志 | 说明 | 示例 |
|---|---|---|
--add-dir | 添加工作目录 | claude --add-dir ../apps ../lib |
--agent | 指定会话代理 | claude --agent my-custom-agent |
--agents | JSON 定义自定义子代理 | claude --agents '{"reviewer":{...}}' |
--allowedTools | 免权限提示的可用工具 | "Bash(git log:*)" "Read" |
--append-system-prompt | 追加到默认系统提示 | claude --append-system-prompt "Always use TypeScript" |
--chrome | 启用 Chrome 浏览器集成 | claude --chrome |
--continue/-c | 加载最近对话 | claude --continue |
--dangerously-skip-permissions | 跳过权限提示（谨慎！） | claude --dangerously-skip-permissions |
--debug | 启用调试模式 | claude --debug "api,mcp" |
--disallowedTools | 禁用指定工具 | "Bash(git log:*)" "Edit" |
--fallback-model | 模型过载时自动切换（仅打印模式） | claude -p --fallback-model sonnet "query" |
--fork-session | 恢复会话时生成新 ID | claude --resume abc123 --fork-session |
--ide | 自动连接可用 IDE | claude --ide |
--input-format | 打印模式输入格式 | --input-format stream-json |
--json-schema | 输出符合 JSON Schema（仅打印模式） | claude -p --json-schema '{...}' "query" |
--max-turns | 限制代理轮次 | claude -p --max-turns 3 "query" |
--mcp-config | 从 JSON 文件加载 MCP 配置 | claude --mcp-config ./mcp.json |
--model | 指定会话模型 | claude --model claude-sonnet-4-6 |
--output-format | 打印模式输出格式 | --output-format json（可选 text/json/stream-json） |
--permission-mode | 按指定权限模式启动 | claude --permission-mode plan |
--plugin-dir | 加载指定目录插件 | claude --plugin-dir ./my-plugins |
--print/-p | 打印响应后退出 | claude -p "query" |
--resume/-r | 按 ID/名称恢复会话 | claude --resume auth-refactor |
--session-id | 指定会话 ID（需为 UUID） | claude --session-id "550e8400-..." |
--settings | 加载自定义 JSON 配置文件 | claude --settings ./settings.json |
--system-prompt | 替换默认系统提示 | claude --system-prompt "You are a Python expert" |
--tools | 限制可用内置工具 | claude --tools "Bash,Edit,Read" |
--verbose | 启用详细日志 | claude --verbose |
--version/-v | 输出版本号 | claude -v |
系统提示标志对比
| 标志 | 行为 | 适用模式 | 推荐场景 |
|---|---|---|---|
--system-prompt | 替换默认系统提示 | 交互+打印 | 完全自定义行为 |
--system-prompt-file | 从文件加载并替换 | 仅打印 | 团队共享提示模板 |
--append-system-prompt | 追加到默认提示 | 交互+打印 | 推荐大多数场景——保留内置能力 + 个性化 |
💡 优先使用
--append-system-prompt，既保留 Claude Code 内置能力，又满足定制需求。
📖 8.3 斜杠命令分类速查
会话管理
| 命令 | 功能 | 示例 |
|---|---|---|
/clear | 清空对话历史，开始全新会话 | /clear |
/compact | 智能压缩历史对话，保留语义摘要 | /compact 保留数据库设计部分 |
/resume | 恢复历史会话 | /resume task-hub-backend |
/rewind | 撤销最近操作，恢复到上一检查点 | 按 Esc Esc 呼出回退菜单 |
/rename | 为当前会话命名 | /rename auth-module-refactor |
/export | 导出对话为 Markdown 文件 | /export debug-session.md |
/copy | 将最近回复复制到剪贴板 | /copy |
/btw | 临时插问，不影响主任务上下文 | /btw Redis 默认端口？ |
/diff | 查看本次会话所有文件变更摘要 | /diff |
上下文与记忆
| 命令 | 功能 |
|---|---|
/context | 可视化上下文窗口使用量 |
/memory | 打开编辑器修改 CLAUDE.md |
/add-dir | 将额外目录纳入工作范围 |
/todos | 列出当前会话 TODO 事项 |
项目与配置
| 命令 | 功能 |
|---|---|
/init | 分析项目并自动生成 CLAUDE.md（新项目第一步） |
/config | 交互式管理全局配置 |
/status | 查看当前配置概览 |
/hooks | 配置生命周期 Hook |
/permissions | 查看/更新工具权限 |
/sandbox | 启用隔离沙盒环境 |
/doctor | 诊断安装状态 |
模型与输出
| 命令 | 功能 |
|---|---|
/model | 切换底层 AI 模型 |
/plan | 进入计划模式 |
/output-style | 设置响应格式 |
/theme | 切换终端配色方案 |
/statusline | 定制状态栏显示 |
/vim | 启用 Vim 键位绑定 |
/terminal-setup | 安装 Shift+Enter 换行绑定 |
代码与工具
| 命令 | 功能 |
|---|---|
/review | 对最近修改进行结构化 Code Review |
/security-review | 安全专项审查（SQL 注入/XSS/敏感信息泄露） |
/pr-comments | 拉取当前分支关联 PR 的审查意见 |
/agents | 管理专项子代理 |
/bashes | 查看后台运行的 Bash 进程 |
/skills | 列出所有可用 Skills |
集成与扩展
| 命令 | 功能 |
|---|---|
/mcp | 管理 MCP 服务器连接 |
/ide | 配置 IDE 联动集成 |
/plugin | 管理插件（install/list/update/uninstall） |
/install-github-app | 配置 GitHub Actions 集成 |
统计与账户
| 命令 | 功能 |
|---|---|
/cost | 显示 Token 消耗与预估费用 |
/usage | 查看套餐用量和速率限制 |
/stats | 图表展示历史使用数据 |
/release-notes | 查看最新版本变更 |
/login//logout | 登录/注销账户 |
📖 8.4 五大内置 Skills
内置 Skills 加载提示词后由 Claude 推理执行，与固定逻辑的内置命令不同：
| Skill | 功能 | 适用场景 |
|---|---|---|
/simplify | 简化代码，提升可读性 | 重构冗长函数、消除过度工程化 |
/debug | 系统化根因分析，给出修复思路 | 定位难以复现的 Bug |
/batch | 对多文件并行执行相同任务 | 批量重命名、批量添加类型注解 |
/loop | 循环执行操作直到满足退出条件 | 自动化 CI 修复循环 |
/claude-api | 快速生成 Anthropic API 示例代码 | 搭建 API 集成原型 |
📖 8.5 自定义命令（Skills 推荐格式）
Skills 是新一代自定义命令格式（.claude/skills/<名称>/SKILL.md），支持 Claude 自动触发、多文件组织。旧格式 Commands（.claude/commands/<名称>.md）仍兼容。
创建步骤：
# 项目级 Skill
mkdir -p .claude/skills/optimize
编写 SKILL.md：
---
name: optimize
description: 分析代码性能瓶颈，给出优化建议。当用户提到性能问题时自动触发。
allowed-tools: Read, Grep, Glob
argument-hint: [目标文件或目录]
model: claude-sonnet-4-6
---
分析以下代码的性能瓶颈，给出具体的优化建议，优先考虑时间复杂度和内存占用：
$ARGUMENTS
使用时输入 /optimize src/utils/data-processor.ts。
前端参数语法：$ARGUMENTS 捕获所有参数，$1/$2 按位置取参，!`cmd` 嵌入命令输出。
📖 8.6 非交互模式（Headless）
非交互模式是 CI/CD 和自动化场景的核心用法：
# 在 CI 中运行代码审查
claude -p '审查最近的代码改动，检查安全问题和代码质量' \
--allowedTools 'Read,Glob,Grep,Bash' \
--output-format json
输出格式：
text：纯文本（默认）json：结构化数据，适合程序化解析stream-json：流式输出，配合--include-partial-messages使用
管道输入示例：
cat logs.txt | claude -p "分析日志中的错误模式"
git diff HEAD~5 | claude -p "总结最近5次提交的改动要点"
📖 8.XX 要点总结
- 四种启动方式：交互 REPL（
claude）、单次执行（-p）、继续会话（-c）、恢复会话（-r） --output-format json是脚本和自动化场景的关键标志--append-system-prompt是定制行为的推荐方式，保留内置能力的同时添加个性指令- 斜杠命令按功能分为 8 类：会话管理、上下文记忆、项目配置、模型输出、代码工具、集成扩展、统计账户
- Skills 推荐格式优于旧 Commands 格式——支持自动触发、多文件组织、更丰富的 frontmatter 控制
