这是 Claude Code 2026 年版的完整速查手册，涵盖 v2.1.x（Opus 4.7 / Sonnet 4.6 / Haiku 4.5）的键盘快捷键、Slash 命令、CLI 参数、权限模式、环境变量和文件结构。更新至 2026 年 4 月，含 xhigh 努力等级、Auto Mode、/ultrareview、/loop、/schedule 等最新功能。
# macOS/Linux（通用）
curl -fsSL https://claude.ai/install.sh | bash
# macOS Homebrew
brew install --cask claude-code
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# 验证和登录
claude --version
claude auth login
键盘快捷键#
核心快捷键#
| 快捷键 | 功能 |
|---|
Ctrl+C | 取消当前生成或输入 |
Ctrl+D | 退出 Claude Code |
Ctrl+L | 清屏 |
Ctrl+R | 反向搜索命令历史 |
Esc + Esc | 回退到上一个 Checkpoint（撤销） |
Shift+Tab | 循环切换权限模式（default/plan/yolo） |
Ctrl+G | 在外部编辑器里打开输入框（vim 等） |
Ctrl+O | 切换详细输出 |
Ctrl+T | 切换任务列表 |
Ctrl+F | 终止所有后台 Agent（按两次） |
输入和编辑#
| 快捷键 | 功能 |
|---|
\ + Enter | 换行（多行输入）- 全平台 |
Shift+Enter | 换行（iTerm2、WezTerm、Ghostty、Kitty、Windows Terminal） |
Ctrl+K | 删除到行尾 |
Ctrl+U | 删除整行 |
Ctrl+Y | 粘贴删除的文字 |
Cmd+V / Ctrl+V | 粘贴剪贴板图片 |
↑/↓ | 浏览命令历史 |
模型和模式切换#
| 快捷键 | 功能 |
|---|
Option+P / Alt+P | 切换模型（Sonnet/Opus/Haiku） |
Option+T / Alt+T | 切换扩展推理 |
Shift+Tab / Alt+M | 循环切换权限模式 |
? | 显示所有快捷键 |
快速前缀#
| 前缀 | 功能 |
|---|
/ | 打开 Slash 命令菜单 |
! | 直接运行 Bash 命令 |
@ | 自动补全文件路径 |
Slash 命令完整参考#
会话和上下文管理#
| 命令 | 功能 |
|---|
/clear | 清除对话历史，释放上下文窗口 |
/compact [焦点] | 压缩对话历史，可选指定保留重点 |
/cost | 显示当前会话的 Token 用量和 API 费用 |
/context | 可视化上下文窗口各部分占比 |
/resume | 选择并恢复之前的会话 |
/rename [名称] | 为当前会话命名，方便后续恢复 |
/rewind | 回退到之前的 Checkpoint |
/diff | 查看所有变更的交互式 diff |
/copy | 复制最近一次回复到剪贴板 |
/export [文件] | 将对话导出为文本文件 |
配置和模型#
| 命令 | 功能 |
|---|
/model [名称] | 切换模型（sonnet/opus/haiku） |
/effort [等级] | 设置推理努力等级（low/medium/high/xhigh/max） |
/config | 打开设置界面 |
/permissions | 查看和管理工具权限 |
/mcp | 管理 MCP 服务器连接 |
/terminal-setup | 配置终端键绑定 |
/theme | 更改颜色主题 |
/vim | 切换 Vim 键绑定模式 |
项目和代码工具#
| 命令 | 功能 |
|---|
/init | 初始化项目，自动生成 CLAUDE.md |
/memory | 查看和编辑 CLAUDE.md 文件 |
/security-review | 扫描变更中的安全漏洞 |
/simplify | 检查代码质量，建议简化 |
/pr-comments [PR] | 获取并处理 GitHub PR 审查意见 |
/add-dir [路径] | 添加目录到工作上下文 |
/plan | 进入 Plan Mode（只读探索） |
/ultraplan [任务] | 云端异步规划，浏览器审阅 |
/ultrareview | 云端并行多 Agent 代码审查 |
/batch [任务] | 在 5-30 个并行 worktree 上执行大规模变更 |
/debug [描述] | 调试当前会话中的问题 |
系统和账户#
| 命令 | 功能 |
|---|
/help | 显示所有可用命令 |
/doctor | 诊断安装、设置、认证和 MCP 问题 |
/insights | 生成会话分析报告（模式、效率、建议） |
/status | 显示版本、模型、账户信息 |
/usage | 显示计划用量和速率限制细分 |
/release-notes | 查看当前版本的更新日志 |
/loop [间隔] [提示词] | 定期重复执行某个命令 |
/voice | 切换推送说话模式（按住 Space） |
/schedule | 创建/管理/运行定时远程 Agent（cron 任务） |
/hooks | 查看和管理已配置的 Hooks |
/teleport | 把 Web/iOS 会话拉回终端 |
/desktop | 把当前会话移交到桌面应用 |
CLI 参数#
会话启动#
# 基础启动
claude # 交互式会话
claude "重构 auth 模块" # 带初始提示词
claude -c # 继续最近一次会话
claude -r "auth-refactor" # 恢复指定名称的会话
claude -n "feature-payments" # 以指定名称开始
# 工作区
claude -w feature-branch # 在独立 git worktree 里运行
claude -w feature-branch --tmux # worktree + tmux 分屏
# 特殊模式
claude --permission-mode auto # Auto Mode（AI 决策权限）
claude --bare # 裸模式（跳过 hooks、插件、自动记忆）
claude --from-pr 42 # 恢复关联某个 PR 的会话
claude -c --fork-session # Fork 当前会话（新 ID，继承上下文）
Print 模式（非交互 / 管道）#
# 基础 print 模式
claude -p "解释 server.log 里的错误"
# 管道输入
cat error.log | claude -p "这个崩溃是什么原因？"
git diff main | claude -p "做安全审查"
# 输出格式
claude -p "列出所有 TODO 注释" --output-format json
# 带 Schema 验证的结构化输出
claude -p "提取 auth.py 里的函数名" \
--output-format json \
--json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}}}'
# 工具控制
claude -p "运行测试并修复失败" --allowedTools "Bash,Read,Edit"
claude -p "重构 auth 模块" --disallowedTools "Bash(rm:*),Bash(sudo:*)"
# 预算和限制
claude -p "重构 API 层" --max-budget-usd 5.00
claude -p "修复这个 Bug" --max-turns 3
# 系统提示
claude -p "审查这段代码" --system-prompt "你是一个安全审计员，只关注漏洞"
claude -p "解释这个函数" --append-system-prompt "永远包含时间复杂度分析"
# 调试
claude -p "修复构建" --debug
claude -p "修复构建" --debug-file /tmp/claude-debug.log
# CI/CD 优化
claude -p "运行 lint 检查" --no-session-persistence # 不保存会话
claude -p "检查开放 Issues" --mcp-config ./ci-mcp.json
模型和努力等级#
claude --model opus # Claude Opus 4.7（最强，适合复杂任务）
claude --model sonnet # Claude Sonnet 4.6（平衡性能）
claude --model haiku # Claude Haiku 4.5（最快最省钱）
claude --effort xhigh # xhigh 推理（Opus 4.7 默认）
claude --effort high # 深度推理
claude --effort low # 快速轻量
权限模式#
| 模式 | 行为 | 适用场景 |
|---|
default | 首次使用每个工具时询问 | 常规交互工作 |
plan | 只读，不能编辑文件或运行命令 | 安全探索和规划 |
acceptEdits | 自动批准文件编辑，命令仍需询问 | 受信任的编辑会话 |
dontAsk | 自动拒绝，除非预先批准 | 严格控制 |
auto | AI 分类器决定每个工具调用的允许/拒绝 | 有明确 CLAUDE.md 规则的受信任项目 |
bypassPermissions | 跳过所有提示（危险） | 仅限容器/沙盒 |
# 在 settings.json 里预批准工具
{
"permissions": {
"allow": [
"Read",
"Bash(git *)",
"Bash(npm run *)",
"Bash(docker compose *)"
],
"deny": [
"Bash(rm -rf *)"
]
}
}
模型和努力等级#
| 模型 | 情况 | 最适合 |
|---|
| Opus 4.7 | 最强推理 | 复杂架构、长时间 Agent 任务 |
| Sonnet 4.6 | 性价比最高 | 日常开发 |
| Haiku 4.5 | 最快最省 | 简单查询、大量 CI 调用 |
努力等级（/effort）：
| 等级 | 推理深度 | Token 消耗 |
|---|
low | 最轻 | 最少 |
medium | 标准 | 中等 |
high | 深度推理 | 较多 |
xhigh | 更深（Opus 4.7 默认） | 多 |
max / ultrathink | 最大思考预算 | 最多 |
环境变量速查#
# 核心配置
ANTHROPIC_API_KEY # API 密钥
ANTHROPIC_MODEL # 默认模型
ANTHROPIC_BASE_URL # API 端点（自定义路由）
CLAUDE_CODE_MAX_THINKING_TOKENS # 最大思考 Token 数
# 性能优化
ENABLE_PROMPT_CACHING_1H # 开启 1 小时缓存 TTL
CLAUDE_CODE_NO_FLICKER # 禁用终端闪烁（v2.1.96+）
# Auto Mode
CLAUDE_CODE_AUTO_MODE # 启用 Auto Mode
CLAUDE_CODE_AUTO_DENY_ACCUMULATE_LIMIT # 累积拒绝上限（默认 20）
# Subagents
CLAUDE_CODE_FORK_SUBAGENT # 使 Subagent 继承父会话上下文（v2.1.114）
# 调试
CLAUDE_CODE_DEBUG # 启用调试日志
ANTHROPIC_LOG # API 调用日志（默认 off）
关键文件结构#
你的项目/
├── CLAUDE.md # 项目指令（git 提交）
├── CLAUDE.local.md # 个人覆盖（gitignore）
└── .claude/
├── settings.json # 项目设置（权限、MCP、hooks）
├── settings.local.json # 个人设置（gitignore）
├── commands/ # 自定义 Slash 命令
│ ├── review.md
│ └── deploy-check.md
├── agents/ # 自定义 Subagent 定义
│ └── code-reviewer.md
└── skills/ # 可复用的复杂 Prompt 模板
└── security-audit.md
用户全局/
~/.claude/
├── CLAUDE.md # 全局用户指令（所有项目）
├── settings.json # 全局用户设置
└── projects/ # 会话历史存储
└── {project-id}/
├── sessions/
└── memory/
诊断命令#
/doctor # 诊断安装、认证、MCP、设置问题
/insights # 生成会话分析报告（效率、模式、建议）
/stats # 查看使用统计、连续使用天数、会话历史
/usage # 计划用量和速率限制细分
# 命令行检查
claude --version # 版本信息
claude status # 认证状态
claude config show # 当前配置
来源：computingforgeeks.com - Claude Code Cheat Sheet 2026 | 整理：ClaudeEagle