引言

上一章用十个案例展示了Claude Code能做什么。这一章换个角度,把工具本身做一次系统梳理。从键盘快捷键开始,依次走过命令行命令与标志、会话内的斜杠命令、技能与智能体生态,末尾汇合到高手工作流。基准版本是2026年4月的v2.1.86。

通读一遍,整体结构就能装进脑子里。放在桌边当手册翻也行。每天用到的功能不超过十个,但知道其余功能的存在,卡住的时候就多一张可以打出的牌。

Claude Code一览

Claude Code的构成大致分为六块:键盘、MCP、斜杠命令、记忆、工作流、技能/智能体、命令行方式。刚入门的朋友只需要记住三样东西。

Ctrl+C停止生成,Ctrl+L清屏,/clear重置对话。

有这三样就能上手了。其余的,用着用着觉得需要的时候再一个个查就好。

六个领域各用一句话概括。

键盘:Ctrl+C停止、Ctrl+L清屏、Ctrl+D退出、Shift+Tab切换模式、Alt+T深度推理,特殊前缀只有斜杠(/)、感叹号(!)、at符号(@)三种。

MCP:外部工具连接规范。通过--transport支持http、stdio、sse三种连接方式,作用域分Local、Project、User三层管理。/mcp命令是管理界面,同时支持Elicitation(问答式工具调用)。

斜杠命令:在会话内输入的命令。/clear、/compact、/resume管理对话,/plan、/voice、/loop切换模式,/init初始化项目,/memory编辑指引文件。/btw、/rc、/schedule是v2.1系列新增或增强的命令。

记忆:CLAUDE.md是项目指引的主体,rules/*.md存放细则,用@path格式引入文件,memory/文件夹存储约25KB的自动记忆。

工作流:用Plan Mode先做计划,用ultrathink启动最强思考模式,用/batch并行跑工作树,用/compact压缩上下文。

配置文件:settings.json是行为配置的主体,ANTHROPIC_API_KEY环境变量必不可少。放一个managed-settings.d/文件夹,管理员分发的配置就会生效;hooks是按条件触发的钩子。

技能/智能体:在.claude/skills/里用SKILL.md创建自定义技能。内置智能体有Explore、Plan、General、Bash四种,initialPrompt和SendMessage是v2.1系列的新功能。

命令行方式:claude -p非交互执行,claude -c接续上次对话,--bare最小化运行,--channels权限中继,--permission-mode plan强制计划模式。

把这些拼成一幅画面:终端里坐着一位助手,用快捷键操控动作,用斜杠命令切换任务,用MCP呼叫外部工具,用技能调取专业知识,用命令行方式接入自动化流水线。各功能彼此不重叠,分工清晰。接下来逐一细看。

键盘快捷键

Claude Code在终端里运行,键盘快捷键就是鼠标的替代品。熟练之后,双手不离键盘就能指挥整个会话。

常规控制用五个Ctrl组合键就能搞定。Ctrl+C停止生成。Claude往错误方向写代码、读错了文件、或者回复越来越长而你已经拿到了想要的答案,直接按下去。按下的瞬间就会中断,token消耗到此为止。Ctrl+D退出会话。Ctrl+L清屏。

与其上下翻滚去找之前的输出,不如清一次屏重新开始,反而更快。Ctrl+O打开对话记录查看器。想回顾之前的对话,或者复盘Claude在某个步骤做了什么决定时可以用。

在v2.1系列中,Ctrl+O的角色收窄为详细日志(verbose transcript)的开关,焦点视图另外交给了/focus命令。Ctrl+B是后台执行。把耗时较长的任务放到后台跑,自己接着做别的事。

模式切换靠Shift+Tab和三个Alt组合键。Shift+Tab在普通、自动批准、计划模式之间循环切换。需要快速写代码时切到自动批准,面对设计优先的任务时先切到计划模式,让Claude只输出方案。Alt+P切换模型。

可以在Haiku、Sonnet、Opus之间即时切换。简单问题用Haiku省钱,复杂重构切到Opus。Alt+T是深度推理(Thinking)开关。需要复杂判断时打开,改个简单文件时关掉。Alt+O开关快速响应模式。

特殊前缀只有三个。斜杠(/)调用内置斜杠命令。感叹号(!)直接执行终端命令,输入「!ls -la」文件列表立刻出来。at符号(@)把文件加载到对话中,像「@src/auth.py 帮我重构这个文件」这样用。这三个前缀几乎是所有高级交互的入口。

多行输入用反斜杠+Enter,或者Ctrl+J。输入较长指令时,可以避免按Enter直接发送的默认行为。

会话选择器(Session Selector)有专门的按键。上下方向键移动列表,P预览,R重命名,斜杠搜索,B只显示当前分支。这个界面在执行claude --resume或输入/resume时弹出。

对话记录查看器里,Ctrl+O打开查看器,斜杠搜索(v2.1系列新增),N和Shift+N在搜索结果间跳转,Ctrl+E全部展开,Q或Esc关闭。

快捷键看起来多,实际上Ctrl+C、Ctrl+L、Shift+Tab、Alt+T这四个覆盖了90%的使用场景。其余的,卡住的时候再想起来用就行。

命令行命令与标志

在终端里敲「claude」就进入对话模式。但这个命令后面跟什么,决定了它变成一个完全不同的工具。

核心命令五个。

claude # 启动对话模式 claude "问题" # 带着问题启动 claude -p "问题" # 非交互执行(自动化用) claude -c # 接续上次对话 claude -r "会话名" # 按名称打开会话 claude update # 更新到最新版本

日常用到的就是「claude」和「claude -c」两个。搭建自动化流水线时,「claude -p」是核心。-p是print的缩写,不启动交互界面,只输出结果后退出。嵌入shell脚本或在GitHub Actions之类的CI中调用时必不可少。

主要标志分为两组。

基础标志在实际工作中常用的大约八个。

--model # 指定模型(haiku/sonnet/opus)

-w # 创建Git工作树 -n, --name # 指定会话名称

--add-dir # 添加工作目录 --agent # 指定智能体(Explore/Plan/General/Bash) --allowedTools # 预授权工具 --output-format json|stream # 输出格式(自动化用) --json-schema # 结构化输出模式 --max-turns # 限制轮次 --max-budget-usd # 费用上限($)

--allowedTools在自动化脚本中是个关键标志。交互会话里每次使用工具都会向用户确认,但脚本执行时没有人可以回答。在这个标志里列出「Read,Edit,Bash」,对应工具就会跳过确认直接执行。--max-turns和--max-budget-usd是安全阀。从根本上防止Claude陷入死循环或消耗超预期的token。

高级标志在v2.1系列中大批加入。

--console # Anthropic控制台认证 --verbose # 详细日志 --bare # 最小化运行(跳过钩子/LSP/技能,新增) --channels # 权限中继(新增,研究预览) --remote # 以Web会话运行 --effort # low/mid/high/max/auto --permission-mode plan|default # 权限模式 --dangerously-skip-permissions # 跳过权限询问(慎用) --chrome # Chrome联动

--bare是2026年3月v2.1.81新增的标志,为脚本环境优化的最小化运行模式。钩子、LSP、插件同步、技能目录扫描全部跳过,启动速度因此变快。代价是OAuth和钥匙串认证被禁用,必须通过ANTHROPIC_API_KEY环境变量或--settings中的apiKeyHelper来认证。自动记忆也完全关闭。在CI环境中用来防止「别人机器上的钩子混入我的构建」这类问题。

--channels在同一时期以研究预览的形式加入。它让频道服务器能把权限请求转发到用户手机上。服务器上的自动化遇到敏感操作时,开发者的手机会弹出审批通知,在那里做出决定。合上笔记本出门之后,也能管理长时间运行的会话。

--dangerously-skip-permissions,名字本身就在警告你这是个危险标志。它跳过所有权限询问,让Claude随意执行。原则上只能在Docker容器或虚拟机之类的沙箱里使用。在本地Mac上直接跑的话,连rm -rf这样的命令也拦不住了。

--effort 用来调节 Claude 的思考力度。默认值 auto 会根据任务复杂度自行判断；设为「low」则快速且省钱，设为「max」则最慢但思考最深。对成本敏感的批量任务用 low，重要的重构工作则指定 high 或 max。

看三个实战组合示例就能找到感觉。

# 1. 错误分析：快速模型 + JSON 输出

claude -p "分析错误" --model claude-haiku-4-5 --output-format json

# 2. 以计划模式分析 src 文件夹

claude --permission-mode plan --add-dir ./src

# 3. 通过管道传入日志文件进行原因分析，限额 1 美元

cat error.log | claude -p "找出原因" --max-budget-usd 1

第三个例子格外有意思。一行 Unix 管道就能拿到日志分析结果，如果在 1 美元之内给不出答案，它就直接停下来。这种组合之所以成立，正是命令行工具的威力所在。

斜杠命令完全指南

在会话中输入斜杠（/），就会弹出内置命令列表。只要打一个斜杠，自动补全列表就会下拉出来，记不住名字也能找到。全部命令分为四大类。

会话管理由八个命令组成。

/clear # 重置对话（清空上下文） /compact # 压缩对话（上下文占用超过 60% 时使用） /resume # 续接上一次会话 /rename # 给会话命名 /branch # 对话分支 /cost # 查看模型计算的 token 费用 /rewind # 回退到先前的对话节点 /export # 导出

/clear 在切换任务时使用。比如整理完会议纪要，现在要开始做代码审查，之前的对话内容留着反而碍事。用 /clear 清空后重新开始。/compact 是长时间在同一会话中工作时用的压缩功能。上下文快要满的时候它会自动触发，但也可以手动调用，告诉它「只保留这些信息，其余压缩掉」。

/rewind 能把跑偏的对话回退到之前的节点。/branch 则在一个对话里分出多条岔路做实验时很有用。「按这个思路写一版，不满意再回到原点」，这种探索性尝试就靠它。

设置相关命令有八个。

/config # 打开设置界面 /model # 切换模型 /fast # 开关快速模式 /effort # 调节质量（思考力度） /theme # 更换主题 /permissions # 权限管理 /keybindings # 快捷键设置

/effort 在会话内发挥的作用与命令行的 --effort 相同，根据当前任务难度随时切换思考力度。/permissions 是权限管理界面，可以精细设定：哪些工具自动放行，哪些命令每次都要询问，哪些命令绝不允许执行。

比如「git commit 自动放行，rm -rf 直接拒绝，网络请求每次都问」这样的规则，就在这里配置。

工具管理命令有八个。

/init # 生成 CLAUDE.md /memory # 编辑指令手册 /mcp # 管理 MCP 连接服务器 /hooks # 设置钩子 /skills # 查看技能列表 /agents # 管理代理 /add-dir # 添加工作文件夹

/init 是启动新项目时第一个要输入的命令。Claude 会分析当前文件夹的结构，自动生成 CLAUDE.md 草稿。这个文件就是项目的指令手册，之后每次会话都会自动加载。/memory 则是编辑这份指令手册的界面。

诸如「本项目使用 Python 3.12」「严格遵守 PEP 8」「测试覆盖率保持 80% 以上」之类的规则，都写在这里。

/mcp 是 MCP 连接服务器的管理界面，一目了然地展示哪些服务器已连接、各自提供哪些工具。重启出问题的服务器、添加新服务器、临时禁用某个服务器，都在这里操作。/hooks 是钩子设置界面，可以在特定事件（文件修改前、工具调用前、会话结束时等）上挂载自动执行的 Shell 命令。

特殊命令这一类里有不少是近期新增的。

/btw # 不消耗上下文地提问 /plan # 计划模式 /loop # 循环定时执行 /voice # 语音模式 /doctor # 环境诊断 /remote-control # 远程控制（NEW） /schedule # 云端定时任务（Routines） /security-review # 安全审查

/btw 是「by the way」的缩写，在不消耗主任务上下文的情况下插一个小问题。比如「对了，这种场景 PostgreSQL 和 MySQL 哪个更合适？」这样的旁支问题用 /btw 来问，当前正在进行的代码工作上下文就不会被打断。/plan 和用 Shift+Tab 进入的计划模式功能一样。

/loop 在会话内设置循环任务。输入「/loop 5m 检查 CI 状态」，它就每隔 5 分钟检查一次 CI 状态，有变化就通知你。/voice 是语音模式，按住空格键说话，自动转成文字作为命令输入。支持 20 种语言，包括中文和韩语。

/doctor 是环境诊断命令，一次性检查 Node 版本是否匹配、API 密钥是否已设置、MCP 连接服务器是否响应、所需权限是否具备。刚装好发现哪里不对劲时，第一个该试的就是这条命令。

/schedule 控制的是 2026 年 4 月 14 日发布的 Routines 功能。与 /loop 只在本机会话内运行不同，/schedule 创建的任务跑在 Anthropic 云端，合上笔记本也照常执行。每天早上 7 点简报、每周一 9 点周报、每月 1 号费用结算之类的例行工作，都可以放上去。

/security-review 会扫描整个代码库，查找安全漏洞。它按照 OWASP Top 10 标准，排查 SQL 注入、XSS、硬编码密钥等问题。养成发布前跑一遍的习惯，能避免不少大事故。

技能与代理生态

斜杠命令是内置功能，技能（Skill）则是用户自己创建的功能。与其反复下达同样的指令，不如存成技能，一次调用就搞定。技能和斜杠命令在 v2.1 系列中已统一，底层跑的是同一套引擎。.claude/commands/deploy.md 文件和 .claude/skills/deploy/SKILL.md 文件都能生成 /deploy 命令。

先看内置技能。安装 Claude Code 后开箱即用的有五个。

/simplify # 代码审查（3 个 AI 并行） /batch # 批量变更（5 到 30 个工作树） /debug # 日志分析 /loop # 循环定时执行 /claude-api # 加载 Claude API/SDK 参考文档

/simplify 专门用于代码审查。三个代理并行运行，分别从质量、安全、可读性三个角度审视代码。/batch 与工作树功能结合，在 5 到 30 个独立工作空间中同时执行变更。给整个库加类型注解，或在多个文件中做统一重构时会用到。

/debug 把日志文件整个读进来，定位错误原因。/claude-api 会将 Claude API 和 SDK 的官方文档拉入上下文，在做 API 相关工作时作为参考。

技能的存放位置有两处。

.claude/skills/<名称>/ # 项目技能（团队共享） ~/.claude/skills/<名称>/ # 个人技能（适用于所有项目）

放在项目文件夹里的技能会被提交到 git，整个团队共享。放在主目录里的技能则是只有本人使用的全局技能。公司统一的部署规则做成项目技能，个人的笔记整理流程做成个人技能，这样的区分很自然。

SKILL.md 文件的结构分为 YAML 前置元数据和 Markdown 正文两部分。逐一看前置元数据的各个字段。

name: deploy description: 生产环境部署。当用户请求部署或提及 deploy 时使用。 allowed-tools: [Bash, Edit] model: claude-haiku-4-5 effort: low paths: [src/**] context: fork disable-model-invocation: true

name 是技能的标识符，只能用小写字母和连字符，最长 64 个字符。description 是 Claude 判断何时调用该技能的依据，也是最关键的字段。要具体写明「做什么、什么时候用」。像「帮助处理代码」这种模糊描述，会导致技能要么不触发，要么在错误的场景下触发。

allowed-tools 限定该技能执行时 Claude 可以使用的工具。只读型技能设为 [Read, Grep, Glob]，部署型技能设为 [Bash, Edit]，这个限制充当安全屏障。model 强制指定执行技能所用的模型，复杂分析用 claude-opus-4-6，简单重复用 claude-haiku-4-5。

effort 是 v2.1 系列为技能新增的字段。可设为 low、med、high、max 中的一个，技能触发时 Claude 的思考力度就会被锁定为该值。paths 定义该技能在哪些文件模式下激活。设为 [src/**] 意味着只有处理 src 文件夹内的文件时，这个技能才会进入候选列表。

context: fork 是一个重要选项。它的意思是让这个技能在辅助代理的独立上下文中运行，防止大量探索结果涌入主对话。需要遍历整个代码库的技能，大多数情况下用 context: fork 来运行更稳妥。

disable-model-invocation: true 会阻止该技能被 Claude 自动调用。只有用户明确输入 /deploy 时才会执行。部署、提交、向外部发送消息这类难以撤销的操作，必须加上这道安全锁。

正文的 Markdown 中使用了三种特殊语法。

$ARGUMENTS # 用户调用技能时传入的参数 ${CLAUDE_SKILL_DIR} # 技能文件夹路径 ! cmd # 动态上下文注入（执行 shell 命令后将结果嵌入上下文）

使用 $ARGUMENTS 后，技能就像函数一样工作。输入 /analyze-file src/auth.js，src/auth.js 就会被填入 $ARGUMENTS 并插入技能正文。${CLAUDE_SKILL_DIR} 返回技能文件夹的绝对路径，利用这个路径可以执行随技能一起部署的脚本。

像 ! date 这样的感叹号加反引号语法，会在技能加载时执行 shell 命令，并将结果注入上下文。当前日期、分支名称、最近的提交哈希等动态信息，就是用这种方式写入技能的。

内置代理共有四种。

Explore # 快速探索专用（基于 Haiku，针对只读工具优化） Plan # 计划模式调查用 General # 通用（可访问全部工具） Bash # 终端独立执行

Explore 是一个轻量快速的代理，用于摸清代码库结构，回答「这个函数在哪里被调用」之类的问题。因为使用 Haiku 模型，成本低、速度快。Plan 在 Plan Mode 内活动。General 是能访问所有工具的通用代理。Bash 是在独立进程中执行终端操作的代理，适合把耗时的构建或验证放到后台运行。

代理的 frontmatter 比技能的选项更多。

permissionMode: default/plan/bypass isolation: worktree # 在独立工作树中运行 memory: user|project # 记忆存储范围 background: true # 后台运行 maxTurns: 10 # 行动次数限制 initialPrompt: ...

# 自动首条提示（NEW） SendMessage # 恢复代理（替代 resume，NEW）

initialPrompt 是 v2.1 系列的新功能。代理创建后会立即自动执行这条提示。比如设置「请总结当前 PR 的变更内容」，用户进入会话时结果就已经准备好了。SendMessage 也是新功能，替代了原来的 resume，向暂停的代理发送新消息以恢复工作。

高手工作流

前面五个小节是零件说明，这一节是把零件组装起来使用的方法。八个核心工作流彼此咬合，构成了 Claude Code 真正的速度。

计划模式优先。大规模变更之前必须通过的关卡。按 Shift+Tab 进入计划模式后，Claude 不会修改任何一行代码，只撰写计划书。用户审阅并批准后，实际修改才会开始。如果「改一下数据库 schema」这种指令一下去，Claude 就直接动手改代码，后果会很严重。

需要在计划模式中预览影响范围，指出危险之处后再继续推进。

思考与精力调节。Alt+T 可以开关深度推理。简单的文件操作关掉就好，架构决策或微妙的 bug 追踪时再打开。如果只想让某一轮以最强模式运行，在输入框中键入「ultrathink」即可，仅该轮以最高思考级别运作。使用 /effort 命令可以在 low、med、high、max 四个级别间切换整个会话的默认精力水平。

Git 工作树。当开发者同时操作多个分支时，工作树提供互不干扰的工作空间。在 claude 命令后加 -w 标志，会话就在独立工作树中启动。用 /batch 并行运行 5 到 30 个任务时，每个任务在自己的工作树里只处理自己的变更，不会冲突。在全库范围的批量修改、同时推进多个 PR 的场景下威力巨大。

claude -w feature-login # 创建工作树后启动 /batch 5 「对分配给各 worker 的模块进行重构」

语音模式。输入 /voice 进入语音输入模式。按住空格键说话，自动转换为文字。支持包括中文在内的 20 种语言。懒得打长指令的时候，或者散步时想把脑中的设计一股脑倒出来的时候，非常好用。

上下文管理。输入 /context 可以查看当前对话占用了上下文窗口的百分之多少。达到 60% 到 70% 时，就该用 /compact 进行压缩了。到 95% 会自动压缩，但在那之前手动压缩的好处是可以指定保留哪些信息，准确度更高。Opus 4.6 在 Max 订阅下支持 1M token 的上下文。

这个容量足以一次性装入数十万行代码库进行分析。

/context # 查看当前用量 /compact 「只保留关键决策事项和当前工作文件」

会话管理。claude -c 从上次对话的断点继续。下班时直接关掉会话也没关系，第二天早上 -c 一下，昨天的工作原封不动地接上。claude -r 「会话名」可以调出按名称保存的会话。在多个项目间切换工作时，给会话起个名字能减少混乱。/btw 用于在不影响当前上下文的情况下抛出一个简短问题。

自动化与 SDK。claude -p 「问题」是自动化的入口。它不启动交互界面，只返回结果。加上 --output-format json 就能得到 JSON 格式的输出，方便其他程序解析。与 Unix 管道也配合得很好。

tail -200 app.log | claude -p 「向 Slack 发送异常告警」 git diff main --name-only | claude -p 「对变更文件进行安全审查」

定时与远程控制。/loop 30m 每 30 分钟重复执行一次指令，仅在会话打开期间有效。/schedule 创建 Routines，在 Anthropic 云端运行。即使笔记本关机也照常执行，这才是真正的自动化。/rc 将 claude.ai 网页与会话连接，实现手机端控制。--remote 标志则让任务直接在网页会话中运行。

以上六个小节就是 v2.1.86 版本 Claude Code 的全貌。日常高频使用的功能缩减到 Ctrl+C、Ctrl+L、/clear、Shift+Tab、claude -c 五个，搭建自动化流水线时则以 claude -p、--output-format、MCP 连接功能和 Routines 为核心。

其余几十个命令和标志，在某个具体场景下需要时，回到这一章来查就好。

版本迭代很快。就像 2026 年 3 月加入了 --bare 和 --channels，4 月加入了 Routines，几乎每个月都有新功能。养成偶尔跑一下 claude update 保持最新版本、用 /doctor 检查环境状态的习惯，就不会掉队。

本书未能覆盖的新功能，可以在 Claude Code 官方更新日志（code.claude.com/docs/en/changelog）中直接查阅。

人工智能专家 金京镇 律师

AI 法律政策专家 · 前国会议员 · 著作等身

如果这本书曾在您身边短暂停留，请支持我们，让下一个故事得以问世。

（自愿赞助账户：农协 302-1096-0948-81 户名：金京镇）