小白AI编程

Appearance

Claude Code 速查表 ​

这份速查表汇总了 Claude Code 中的所有命令、快捷键和配置选项，帮你快速找到需要的内容。可以把它当做你的日常参考手册。

/ 斜杠命令 ​

斜杠命令是在 Claude Code 聊天框中输入的特殊指令。

  • /help: 查看所有可用命令的说明。
  • /clear: 清空当前的聊天记录。
  • /compact: 压缩当前对话，减少上下文占用。可以加指令控制保留什么，比如 /compact 保留 auth 模块的讨论，其他丢掉。
  • /context: 用可视化图表展示上下文窗口的使用情况，看看还剩多少空间。
  • /diff: 打开交互式差异查看器，审查还没提交的代码改动。
  • /model: 切换使用的 Claude 模型（如从 Sonnet 切换到 Haiku）。
  • /cost: 查看当前会话的 token 用量、时长、代码改动量和花费。
  • /status: 查看当前版本、使用的模型和账号信息。
  • /doctor: 运行健康检查，诊断你的 Claude Code 安装有没有问题。
  • /init: 扫描你的项目，自动生成一份入门级 CLAUDE.md。
  • /memory: 查看和编辑 CLAUDE.md 记忆文件（全局的、项目的、自动的）。
  • /review: 审查当前分支上的代码改动，给出修改建议。
  • /permissions: 查看和管理工具权限，在 .claude/settings.json 里配置。
  • /config: 打开 Claude Code 的设置菜单。
  • /login: 切换 Anthropic 账号。
  • /branch: 把当前对话分叉出一个平行分支，试试别的方案，不影响主线。
  • /rewind: 回退到之前某个消息节点，撤销那之后的所有文件改动。
  • /resume: 恢复之前的会话。
  • /rename: 重命名当前会话。
  • /export: 导出当前会话的完整对话记录。
  • /effort: 设置推理深度：low（快）、medium、high（深）、max 或 auto。
  • /plan: 进入规划模式——Claude 先用只读工具研究，再给你出方案，批准后才动手。比如 /plan 把 REST 迁移到 GraphQL。
  • /btw: 问个旁白问题，不会加进对话历史。比如 /btw TypeScript 泛型约束怎么写？
  • /batch: 把任务拆给多个子智能体并行跑，各自在隔离的 git worktree 里干活。比如 /batch 给所有导出函数加 JSDoc。
  • /loop: 按固定间隔重复执行检查任务。比如 /loop 5m 看看构建通过了没。
  • /schedule: 创建云端定时任务，即使你离线了也会执行。比如 /schedule "每周一早上9点跑安全审计"。
  • /debug: 切换详细模式，查看工具调用和思考步骤（也可以用 Ctrl+O）。
  • /simplify: 审查最近改动过的文件，检查代码质量、复用和效率。
  • /agents: 列出、创建、编辑或删除子智能体定义。
  • /mcp: 查看当前活跃的 MCP 服务器连接和可用工具。
  • /plugin: 管理插件——安装、列出、删除或重新加载。比如 /plugin install pr-review。
  • /reload-plugins: 开发插件时热重载所有插件文件，不用重启。
  • /sandbox: 启用操作系统级别的沙盒隔离，限制文件系统和网络访问。

⌨️ 键盘快捷键 ​

在终端里使用 Claude Code 时的快捷操作。

  • Shift+Tab: 切换权限模式：default → plan → acceptEdits → auto，循环切换。
  • Option+T (Mac) / Alt+T (Win): 开关扩展思考（extended thinking）。
  • Ctrl+C: 中断当前 Claude 的思考或正在跑的命令。
  • Ctrl+D: 退出 Claude Code。
  • Ctrl+B: 把正在运行的子智能体放到后台，你可以继续干别的。
  • Ctrl+O: 切换调试/详细模式，查看工具调用和思考过程（同 /debug）。
  • Ctrl+G: 在外部编辑器里打开当前计划。
  • Esc: 关掉当前弹出的对话框或建议。

💻 CLI 参数 ​

在终端启动 Claude Code 时可以添加的参数。

  • claude -p: 启动并直接输入 prompt，执行完即退出。例如 claude -p "帮我写个 Python 脚本"。
  • --output-format json: 将输出格式化为 JSON，方便被其他脚本调用。
  • --model: 指定启动时使用的模型，如 --model claude-3-haiku-20240307。
  • --permission-mode: 设置权限模式，如 --permission-mode auto。
  • --sandbox: 以沙盒模式启动，限制文件系统访问。
  • --max-turns: 限制对话的最大轮数，防止意外陷入死循环。
  • --no-session-persistence: 不保存本次会话记录，用完即弃。
  • --resume: 恢复上一次未结束的会话。
  • --continue: 继续之前的任务，通常和 --resume 一起用。
  • --agent: 启动时直接调用特定的智能体，如 --agent "my-bot"。
  • --plugin-dir: 指定加载插件的自定义目录。
  • --bare: 以最简模式启动，不加载用户自定义配置。
  • --worktree: 在特定的 git worktree 中启动，实现隔离工作。

📁 配置文件 ​

Claude Code 用来保存设置和约定的文件。

  • CLAUDE.md: 当前项目的说明书，告诉 Claude 这个项目是干嘛的，有哪些规则。
  • CLAUDE.local.md: 个人的项目说明书，不会被提交到 Git。
  • .claude/settings.json: 项目级别的设置文件。
  • .claude/settings.local.json: 个人的项目设置文件。
  • ~/.claude/CLAUDE.md: 全局说明书，对你所有的项目都生效。
  • ~/.claude/settings.json: 全局的个人设置文件。
  • .claude/skills/: 存放项目中自定义技能指令的目录。
  • .claude/agents/: 存放项目中自定义子智能体配置的目录。
  • .claude/rules/*.md: 存放具体模块或场景规则的文件。
  • .mcp.json: 项目的 MCP 连接配置文件。
  • ~/.claude.json: 你的 Claude 账号认证和核心信息。

🔌 MCP 设置 ​

管理外部工具和数据源连接。

  • claude mcp add: 引导式添加一个新的 MCP 服务器。
  • claude mcp add --header: 添加带有自定义请求头的 MCP 服务器。
  • claude mcp list: 查看当前所有已连接的 MCP 服务器。
  • claude mcp get: 查看某个 MCP 服务器的具体配置信息。
  • claude mcp remove: 移除不需要的 MCP 服务器。
  • claude mcp add-from-claude-desktop: 把 Claude Desktop 中的 MCP 配置一键导过来。
  • /mcp: 聊天框内的 MCP 管理命令。
  • mcp__server__tool namespace: MCP 工具在 Claude Code 里的命名空间格式，用来避免工具名称冲突。

🪝 Hooks 钩子 ​

在特定事件发生时自动触发的操作。

  • PreToolUse: 在 Claude 使用某个工具之前触发。可以拦截（exit code 2 = 阻止执行）。
  • PostToolUse: 在工具执行完之后触发。适合自动格式化、lint 检查、日志记录。
  • UserPromptSubmit: 在你的消息交给 Claude 处理之前触发，可以拦截或修改输入。
  • Stop: 在 Claude 回复完毕时触发。可以用来检查完成标准（比如测试是否通过）。
  • SubagentStart/SubagentStop: 在子智能体启动或结束时触发，用于编排和日志。
  • Hook 类型: command（跑脚本）、prompt（让 LLM 评估）、agent（起子智能体）、http（发 webhook）。
  • Hook 匹配器: 用正则过滤哪些工具触发钩子。"Bash" 精确匹配，"Write|Edit" 匹配任一，"*" 匹配全部。
  • 技能级钩子: 在 SKILL.md 的 frontmatter 里定义，只在那个技能执行期间生效。

🔐 权限模式 ​

控制 Claude 有多大的自由度去执行操作。

  • default: 默认模式，写文件、改代码、跑命令前都会问你。读文件、搜索、grep 默认放行。
  • plan: 只读模式，只做研究和出方案，不改任何文件，等你批准后再动手。
  • acceptEdits: 自动接受文件修改，但跑 Bash 命令前还是会问你。
  • auto: 全自动模式，所有操作都不再确认（谨慎使用，适合信任的环境）。
  • bypassPermissions: 跳过所有安全检查，只用在全自动 CI/CD 流水线里。
  • allow patterns: 在 .claude/settings.json 里设白名单，预先放行特定工具。比如 "allow": ["Bash(npm run test)"]。
  • deny patterns: 设黑名单，不管什么模式都禁止执行。比如 "deny": ["Bash(git push --force*)"]。

🤖 子智能体 ​

用来处理特定任务的专业分身。

  • @"agent-name": 在聊天中直接 @ 一个子智能体把任务交给它。
  • claude --agent: 从命令行直接启动一个子智能体。
  • .claude/agents/*.md: 定义自定义子智能体的文件。
  • built-in agents: Claude Code 自带的专用智能体（比如专注于搜索的）。
  • isolation: worktree: 让子智能体在隔离的环境中干活，不影响你当前的代码。
  • background: true: 让子智能体在后台默默工作，你可以继续干别的。

🧩 插件 ​

扩展 Claude Code 的功能。

  • /plugin install: 从注册表安装插件。
  • /plugin install github:user/repo: 从 GitHub 仓库直接安装插件。
  • /plugin list: 查看已安装的所有插件。
  • /reload-plugins: 重新加载插件（当你自己写插件或者更新配置时很有用）。
  • claude --plugin-dir: 指定额外的插件加载路径。
  • .claude-plugin/plugin.json: 插件的核心描述和配置文件。
  • namespaced commands: 插件提供的命令会有专属前缀，防止跟其他插件打架。

🔄 常用工作流 ​

把命令组合起来用，效率翻倍。

  • 深度工作：/effort high → /plan → 审批 → 执行。先调高推理深度，让它出计划，你批了再动手。
  • 收工流程：/diff → /cost → /export → /compact。审查改动、看看花了多少、导出记录、压缩上下文。
  • 大规模重构：/batch <指令>。把活拆给多个子智能体并行跑，各自在隔离的 worktree 里干。
  • 后台监控：/loop 5m <检查指令>。每隔几分钟自动检查构建状态、错误日志或部署健康。
  • 探索试错：/branch → 试一种方案 → 不行就 /resume 回来。分叉对话探索替代方案，失败了不影响主线。
  • CI/CD 集成：echo $DIFF | claude -p "审查这些改动" --output-format json。把 diff 丢给 Claude 自动审查，输出 JSON。
  • 新项目起步：/init → 编辑 CLAUDE.md → 提交。自动生成项目说明，改一改，提交给团队共享。

← 返回 Claude Code 首页