Claude Code 备忘录 中文版

Claude Code v2.1.81
最后更新: 2026年3月24日
🗓️ 最近更新
  • --bare 标志 - 极简无头模式 (无 hooks/LSP/插件)
  • --channels - 权限中继与 MCP 推送消息 (预览版)
  • 技能和斜杠命令新增 effort 前置数据(frontmatter)
  • /fork 重命名为 /branch (保留了别名)
  • SendMessage 自动恢复已停止的代理(agents)
⌨️ 键盘快捷键 (KEYBOARD SHORTCUTS)
通用控制 (General Controls)
Ctrl C
取消输入 / 取消生成
Ctrl D
退出会话
Ctrl L
清屏
Ctrl O
切换详细输出 (verbose)
Ctrl R
反向搜索历史记录
Ctrl G
在编辑器中打开提示词
Ctrl B
后台运行任务
Ctrl T
切换任务列表
Ctrl V
粘贴图片
Ctrl F
终止后台代理 (连按2次)
Esc Esc
倒退 / 撤销 (Rewind)
模式切换 (Mode Switching)
↑ Tab
循环切换权限模式
⌥ P
切换模型
⌥ T
切换思考模式 (thinking)
输入 (Input)
\ Enter
换行 (快速)
Ctrl J
换行 (控制序列)
前缀 (Prefixes)
/
斜杠命令
!
直接执行 bash 命令
@
提及文件 + 自动补全
会话选择器 (Session Picker)
↑↓
导航选择
←→
展开 / 折叠
P
预览
R
重命名
/
搜索
A
所有项目
B
当前分支
⚡ 斜杠命令 (SLASH COMMANDS)
会话 (Session)
/clear
清空对话
/compact [focus]
压缩上下文
/resume
恢复 / 切换会话
/rename [name]
命名当前会话
/branch [name]
分支对话 (/fork 别名)
/cost
Token 使用统计
/context
可视化上下文 (网格)
/diff
交互式差异查看器
/copy
复制最后一次回复
/export
导出会话
配置 (Config)
/config
打开设置
/model [model]
切换模型 (← → 投入度)
/fast [on|off]
切换快速模式
/vim
切换 vim 模式
/theme
更改颜色主题
/permissions
查看/更新权限
/effort [level]
设置投入度 (low/med/high/max/auto)新
/color [color]
设置提示栏颜色
/keybindings
自定义键盘快捷键
/terminal-setup
配置终端快捷键
工具 (Tools)
/init
创建 CLAUDE.md
/memory
编辑 CLAUDE.md 文件
/mcp
管理 MCP 服务器
/hooks
管理钩子 (hooks)
/skills
列出可用技能
/agents
管理代理 (agents)
/chrome
Chrome 浏览器集成
/reload-plugins
热重载插件
/add-dir <path>
添加工作目录
特殊 (Special)
/btw <question>
旁支问题 (不带上下文)
/plan [desc]
计划模式 (+ 自动启动)
/loop [interval]
安排定期循环任务
/voice
按键语音 (支持20种语言)
/doctor
诊断安装环境
/pr-comments [PR]
获取 GitHub PR 评论
/stats
使用连击统计与偏好
/insights
分析会话报告
/desktop
在桌面客户端中继续
/remote-control
桥接到 claude.ai/code (/rc)新
/usage
计划额度与速率状态
/schedule
云端定时任务
/security-review
代码变更安全分析
/help
显示帮助与命令
/feedback
提交反馈 (别名: /bug)
/release-notes
查看完整更新日志
/stickers
订购贴纸！🎉
🔌 MCP 服务器 (MCP SERVERS)
添加服务器 (Add Servers)
--transport http
远程 HTTP (推荐)
--transport stdio
本地进程
--transport sse
远程 SSE
作用域 (Scopes)
Local
.claude.json (单项目)
Project
.mcp.json (共享/版本控制)
User
~/.claude.json (全局)
管理 (Manage)
/mcp
交互式 UI 管理界面
claude mcp list
列出所有服务器
claude mcp serve
将 CC 作为 MCP 服务器运行
引导获取 (Elicitation)
Servers request input mid-task新
服务器在任务执行中途请求输入
📁 记忆与文件 (MEMORY & FILES)
CLAUDE.md 位置 (Locations)
./CLAUDE.md
项目级 (团队共享)
~/.claude/CLAUDE.md
个人级 (适用于所有项目)
/etc/claude-code/
托管级 (组织范围内)
规则与导入 (Rules & Import)
.claude/rules/*.md
项目规则
~/.claude/rules/*.md
用户规则
paths:
前置数据(Frontmatter)特定路径规则
@path/to/file
在 CLAUDE.md 中导入文件
自动记忆 (Auto Memory)
~/.claude/projects/<proj>/memory/
MEMORY.md
+ 主题文件，自动加载
🔥 工作流与提示 (WORKFLOWS & TIPS)
计划模式 (Plan Mode)
↑ Tab
常规 → 自动接受 → 计划
--permission-mode plan
以计划模式启动
思考与投入度 (Thinking & Effort)
⌥ T
开启/关闭思考模式
"ultrathink"
单次对话最大投入度
Ctrl O
查看思考过程 (详细输出)
/effort
〇 低 · ◐ 中 · ⬤ 高新
Git 工作树 (Git Worktrees)
--worktree name
每个功能独立的隔离分支
isolation: worktree
代理运行在自己的工作树中
sparsePaths
仅检出所需目录新
/batch
自动创建工作树
语音模式 (Voice Mode)
/voice
启用按键通话 (Push-to-talk)
Space (长按)
录音，松开发送
支持 20 种语言
英, 西, 法, 德, 捷, 波 等...
上下文管理 (Context Management)
/context
使用情况 + 优化提示
/compact [focus]
带焦点的压缩上下文
自动压缩 (Auto-compact)
达到 ~95% 容量时触发
1M 上下文限制
Opus 4.6 (Max/团队/企业版)
CLAUDE.md
在压缩后仍会保留！
会话高级操作 (Session Power Moves)
claude -c
继续上一次对话
claude -r "name"
按名称恢复对话
/btw question
旁支问题，不消耗主上下文
SDK / 无头模式 (SDK / Headless)
claude -p "query"
非交互式运行
--output-format json
结构化数据输出
--max-budget-usd 5
设置成本上限
cat file | claude -p
管道 (Pipe) 输入
调度与远程 (Scheduling & Remote)
/loop 5m msg
循环 / 定期任务
/rc
远程控制
--remote
在 claude.ai 上的 Web 会话
⚙️ 配置与环境变量 (CONFIG & ENV)
配置文件 (Config Files)
~/.claude/settings.json
用户全局设置
.claude/settings.json
项目设置 (团队共享)
.claude/settings.local.json
仅限本地的设置
~/.claude.json
OAuth, MCP, 状态信息
.mcp.json
项目的 MCP 服务器配置
关键设置项 (Key Settings)
modelOverrides
映射模型选择器 → 自定义 IDs
autoMemoryDirectory
自定义记忆文件目录
worktree.sparsePaths
稀疏检出(Sparse checkout)目录新
关键环境变量 (Key Env Vars)
ANTHROPIC_API_KEY
API 密钥
ANTHROPIC_MODEL
指定模型
CLAUDE_CODE_EFFORT_LEVEL
投入度：low/med/high
MAX_THINKING_TOKENS
最大思考Token数 (0=关闭)
ANTHROPIC_CUSTOM_MODEL_OPTION
自定义 /model 菜单条目
CLAUDE_CODE_PLUGIN_SEED_DIR
多个插件种子目录
CLAUDECODE
检测 CC shell 环境 (=1)
IS_DEMO
演示模式 (隐藏邮箱/组织名)
🤖 技能与代理 (SKILLS & AGENTS)
内置技能 (Built-in Skills)
/simplify
代码审查 (3个并行代理)
/batch
大规模并行更改 (5-30个工作树)
/debug [desc]
根据调试日志排查问题
/loop [interval]
安排定期循环任务
/claude-api
加载 API + SDK 参考文档
自定义技能存放位置
.claude/skills/<name>/
项目专属技能
~/.claude/skills/<name>/
个人通用技能
技能前置数据 (Skill Frontmatter)
description
自动调用的触发描述
allowed-tools
跳过特定工具的权限提示
model
覆盖该技能使用的模型
effort
覆盖投入度级别新
context: fork
在子代理(subagent)中运行
$ARGUMENTS
用户输入占位符
${CLAUDE_SKILL_DIR}
技能自身的目录路径
!cmd
动态执行命令注入上下文
内置代理 (Built-in Agents)
Explore
快速只读浏览 (使用 Haiku)
Plan
为计划模式提供研究支持
General
提供全套工具，处理复杂任务
Bash
终端独立的上下文环境
代理前置数据 (Agent Frontmatter)
permissionMode
default / acceptEdits / plan / dontAsk / bypass
isolation: worktree
在独立的 git 工作树中运行
memory: user|project
持久化记忆范围
background: true
作为后台任务运行
maxTurns
限制代理自主执行的轮数
SendMessage
恢复代理 (取代旧的 resume)新
💻 CLI 与标志 (CLI & FLAGS)
核心命令 (Core Commands)
claude
进入交互式模式
claude "q"
带初始提示词启动
claude -p "q"
无头模式 (执行完毕即退)
claude -c
继续上一次对话
claude -r "n"
按名称恢复特定会话
claude update
更新 Claude Code 工具
关键标志 (Key Flags)
--model
设置使用的模型
-w
指定 Git 工作树
-n / --name
指定会话名称
--add-dir
添加工作目录
--agent
使用特定的代理
--allowedTools
预先批准特定工具的权限
--output-format
输出格式: json 或 stream
--json-schema
使用结构化约束输出
--max-turns
限制最大对话轮数
--max-budget-usd
设置成本(美元)上限
--console
通过 Anthropic Console 认证
--verbose
开启详细日志输出
--bare
极简无头模式 (无 hooks/LSP)新
--channels
权限中继 / MCP 推送新
--remote
Web 远程会话模式
--effort
low / med / high / max
--permission-mode
plan / default / ...
--dangerously-skip-permissions
跳过所有权限提示 ⚠️
--chrome
启用 Chrome 支持