Claude Code 中文速查表

Claude Codev2.1.121 最近更新:2026年4月28日

⌨️ 键盘快捷键

常规控制

CtrlC 取消当前输入或生成
CtrlD 退出会话
CtrlL 清屏
CtrlO 切换详细输出NEW
CtrlU 清空整个输入缓冲区
CtrlY 恢复已清空的输入缓冲区
CtrlG 在编辑器中打开输入内容
CtrlR 反向搜索历史
CtrlX CtrlK 终止后台代理
CtrlB 将运行中的任务转到后台
CtrlT 显示或隐藏任务列表
EscEsc 回退或撤销

模式切换

ShiftTab 轮换权限模式

Mac Option Keys (configure Option as Meta)

P 切换模型
T 切换扩展思考
O 切换快速模式

输入

\Enter 换行(快速)
v Vim 可视模式(字符选择 + operators)NEW
V Vim 可视行模式NEW

前缀

/ 斜杠命令
! 直接执行 bash
@ 文件引用 + 自动补全

🔌 MCP 服务器

添加服务器

--transport http 远程 HTTP(推荐)
--transport stdio 本地进程
--transport sse 远程 SSE

作用域

Local settings.local.json(仅你自己)
Project .mcp.json(共享 / 版本控制)
User ~/.claude.json(全局)

管理

/mcp 管理 MCP 服务器
claude mcp list 列出所有服务器
alwaysLoad: true Keep server connected across all sessions (server config)NEW
maxResultSizeChars _meta 注解覆盖(最多 500K)NEW

⚡ 斜杠命令

会话

/clear 清空对话
/compact [focus] 按焦点压缩上下文
/branch [name] 分叉对话(/fork 别名)
/usage 套餐限制与速率状态NEW
/context 可视化上下文(网格)
/diff 交互式 diff 查看器
/copy [N] 复制最后一条(或第 N 条)回复
/recap 返回会话时获取上下文摘要NEW
/undo /rewind 的别名NEW
/rewind 回退对话 / 代码检查点
/export 导出对话
/plan [desc] 计划模式(+ 自动开始)
/resume [session] 按 ID/名称恢复
/focus 切换聚焦视图(全屏,仅显示最终消息)NEW

配置

/config [key [value]] 查看/设置配置(持久化到 ~/.claude/settings.json)NEW
/model [model] 切换模型(←→ effort)NEW
/fast [on|off] 切换快速模式
/theme [name] 创建并切换命名的自定义主题;包含 "Auto (match terminal)" 深色/浅色NEW
/permissions 查看/更新权限
/effort [level] 设置 effort(low/med/high/max/auto)
/color [color] 设置输入栏颜色
/keybindings 自定义键盘快捷键
/terminal-setup 配置终端快捷键

工具

/init 创建 CLAUDE.md
/memory 编辑 CLAUDE.md 文件
/mcp 管理 MCP 服务器
/hooks 管理 hooks
/skills 列出可用 skills
/agents 管理 agentsNEW
/review [PR] 在本地审查 PR
/ultrareview [PR#] 云端代码审查 — 并行多 agent 分析
/simplify [focus] 代码审查 + 修复(3 个 agents)NEW
/security-review 对改动做安全分析
/less-permission-prompts 添加 allowlist 以减少提示NEW
/loop [interval] [prompt] 周期性任务(/proactive 别名)NEW
/chrome Chrome 集成
/ide IDE 集成状态
/reload-plugins 热重载 plugins
/add-dir <path> 添加工作目录

特殊项

/btw <question> 旁支提问(不占上下文)
/extra-usage 限流时的额外用量
/voice 开启按住说话
/doctor 诊断安装问题
/insights 分析会话报告
/desktop 转到 Desktop 应用继续
/rename [name] 为当前会话命名
/help 显示帮助与命令
/feedback 提交反馈(别名:/bug)

📁 记忆与文件

CLAUDE.md 位置

./CLAUDE.md or ./.claude/CLAUDE.md 项目(团队共享)
./CLAUDE.local.md 本地个人项目笔记(gitignored)
~/.claude/CLAUDE.md 个人(所有项目)
/etc/claude-code/CLAUDE.md 托管策略(Linux/WSL,全组织)

规则与导入

.claude/rules/*.md 项目规则
~/.claude/rules/*.md 用户规则
paths: frontmatter 路径定向规则
@path/to/file 在 CLAUDE.md 中导入

自动记忆

~/.claude/projects/<proj>/memory/ MEMORY.md + 主题文件,自动加载(最大 25KB/200 行)

🧠 工作流与技巧

计划模式

ShiftTab 轮换权限模式
--permission-mode plan 以 plan 模式启动
Plan file naming 文件按你的 prompt 命名(例如 fix-auth-race-snug-otter.md)

思考与推理强度

AltT 切换思考模式
"ultrathink" 当前轮次的最大 effort
CtrlO 切换详细输出
/effort ○ 低 · ◐ 中 · ● 高 · ★ 最大

自动模式被拒绝时

/permissions → Recent 用 R 重试被拒绝的操作NEW

Git 工作树

--worktree name 每个功能一个隔离分支
isolation: worktree 在自己的 worktree 中运行 Agent
sparsePaths 仅检出所需目录
workspace.git_worktree 状态行 JSON:已链接的 worktree 路径NEW
/batch 自动创建 worktree

语音模式

/voice 开启按住说话
Space (hold) 按住录音,松开发送
20 languages EN、ES、FR、DE、CZ、PL…

上下文管理

/context 可视化上下文(网格)
/compact [focus] 按焦点压缩上下文
Auto-compact ~95% 容量(抖动检测:3x)NEW
1M context Opus 4.6(Max/Team/Ent)
CLAUDE.md 压缩后仍保留!

会话高效技巧

claude -c 继续上一次对话
claude -r "name" 按名称恢复
/btw question 侧边提问,不消耗上下文

SDK / 无头模式

claude -p "query" 非交互式
--output-format json 结构化输出
--max-budget-usd 5 成本上限
cat file | claude -p 管道输入

调度与远程

/loop 5m msg 周期性任务
--remote claude.ai 上的 Web 会话

⚙️ 配置与环境变量

配置文件

~/.claude/settings.json 用户设置
.claude/settings.json 项目级(共享)
.claude/settings.local.json 仅本地
~/.claude.json OAuth、MCP、状态
.mcp.json 项目 MCP 服务器
managed-settings.d/ 可直接放入的策略片段

关键设置

modelOverrides 将模型选择器映射到自定义 ID
autoMemoryDirectory 自定义 memory 目录
worktree.sparsePaths 稀疏检出目录
sandbox.failIfUnavailable sandbox 失败时退出
hooks: if 条件 hooks(permission rule 语法)
DISABLE_PROMPT_CACHING* 禁用 prompt caching 时的启动警告NEW
Monitor tool 从后台脚本流式输出事件NEW
PermissionDenied Hook:自动模式拒绝NEW
showThinkingSummaries 可选启用(现默认关闭)NEW
allowedChannelPlugins 管理员 channel plugin 允许列表
hooks: "defer" 暂停 headless → 稍后恢复
type: "mcp_tool" Hook 步骤直接调用 MCP toolNEW
PostToolUse → hook_output Return hook_output from hook to replace tool resultNEW
disableSkillShellExec 阻止 skills/plugins 中的 !`cmd`NEW
forceRemoteSettings… 阻塞直到获取最新配置NEW
refreshInterval 每 N 秒重新运行自定义状态行NEW

关键环境变量

ANTHROPIC_API_KEY
ANTHROPIC_MODEL
ANTHROPIC_BASE_URL 代理/网关覆盖
ANTHROPIC_BETAS 额外的 beta headers
ANTHROPIC_CUSTOM_MODEL_OPTION 自定义 /model 条目
MAX_THINKING_TOKENS 0=关闭
ENABLE_PROMPT_CACHING_1H 启用 1h prompt cache TTLNEW
FORCE_PROMPT_CACHING_5M 强制 5 分钟 prompt cache TTLNEW
CLAUDE_CODE_ENABLE_AWAY_SUMMARY 在 telemetry 禁用时强制生成摘要NEW
CLAUDECODE 检测 CC shell (=1)
CLAUDE_CODE_DISABLE_CRON 禁用计划任务
CLAUDE_CODE_FORK_SUBAGENT 在外部构建中启用 forked subagents (=1)NEW
DISABLE_UPDATES 阻止所有更新路径NEW
API_TIMEOUT_MS API 超时(默认:600000ms)
MCP_TIMEOUT MCP server 启动超时(ms)
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE
CLAUDE_CODE_AUTO_COMPACT_WINDOW
CLAUDE_CODE_DISABLE_AUTO_MEMORY
CLAUDE_CODE_DISABLE_1M_CONTEXT

🔧 Skills 与 Agents

内置 Skills

Skill tool 发现内置 slash commands(/init、/review、/security-review…)NEW
/simplify 代码审查(3 个并行 agent)
/batch 自动创建 worktree
/debug [desc] 从调试日志排查问题
/loop [interval] 创建周期任务
/claude-api 加载 API + SDK 参考

自定义 Skill 位置

.claude/skills/<name>/ 项目技能
~/.claude/skills/<name>/ 个人 skills

Skill 头信息

description 自动调用触发器
allowed-tools 跳过权限提示
model 为 skill 覆盖模型
effort 覆盖 effort 级别
paths: [globs] 路径定向(YAML 列表)NEW
context: fork 在子代理中运行
$ARGUMENTS 用户输入占位符
${CLAUDE_SKILL_DIR} skill 自身目录
${CLAUDE_EFFORT} 当前 effort 级别(skill 变量)NEW
!`cmd` 动态上下文注入
plugin bin/ 为 Bash 工具随附可执行文件NEW

内置 Agents

Explore 快速只读(Haiku)
Plan 用于 plan 模式的研究
General 全工具,适合复杂任务
Bash 终端独立上下文

Agent 头信息

permissionMode default/acceptEdits/plan/dontAsk/bypassPermissions
isolation: worktree 在自己的 worktree 中运行 Agent
memory: user|project|local 持久化记忆
background: true 后台任务
maxTurns 限制 agentic 轮数
initialPrompt 自动提交首轮
SendMessage 恢复代理(替代 resume)
@agent-name 提及已命名的子 agentNEW

🖥️ CLI 与参数

核心命令

claude 交互式
claude "q" 带 prompt
claude -p "q" 无头模式
claude -c 继续上一次对话
claude -r "n" 恢复
claude update 更新
claude auth login 登录(--sso, --console)
claude agents 列出 agents
claude mcp MCP 配置
claude plugin 插件管理
claude plugin prune Remove unused/orphaned pluginsNEW
claude ultrareview [target] 非交互式代码审查(PR / 分支 / 路径)NEW

关键参数

--model 设置模型
-n / --name 会话名称
--resume, -r 恢复会话
--continue, -c 继续最近一次会话
--add-dir 添加目录
--agent 使用 agent
--agents 通过 JSON 定义 agents
--allowedTools 预先批准
--disallowedTools 移除 tools
--allow-danger… 为 ⇧Tab 循环添加 bypassPerms
--output-format json/stream
--json-schema 结构化
--max-turns 限制轮数
--max-budget-usd 成本上限
--exclude-dyn… 打印:更好的 prompt 缓存NEW
--bare 最小化无头模式(无 hooks/LSP)
--channels 权限中继 / MCP 推送
--remote claude.ai 上的 Web 会话
--rc / --remote-control Remote Control 模式
--effort low/medium/high/max
--permission-mode plan/default/…
--dangerously-skip-permissions 跳过所有提示 ⚠️
--chrome / --no-chrome 开启/关闭 Chrome
--debug [filter] 调试日志
--system-prompt 自定义 system prompt
--settings <file> 加载 settings JSON
--from-pr 加载 PR 上下文(GitHub / GitLab / Bitbucket / GHE)NEW

补充参考