快速定位

最短路径

claude                    # 启动交互模式
claude "修复这个 bug"     # 单次任务
claude -p "审查代码"       # 打印输出后退出

核心场景速查

最小工作流

起手式

cd 项目目录
claude                    # 启动交互模式

核心命令链

claude "添加用户认证"      # 自然语言任务
claude exec "重构这块逻辑" # 非交互自动化
claude -p "审查 PR"       # 打印输出

收尾动作

/exit                     # 退出
/checkpoint                # 保存检查点

高频场景 Recipes

代码生成与重构

添加 RESTful API 端点
将这个 class 改为 TypeScript
为这个函数添加单元测试
重构这段 SQL 查询

调试与修复

修复空指针异常
解决 500 错误
为什么这个 API 超时
修复 CSS 在 Safari 的问题

代码审查

审查这段代码的安全性
检查这个函数的性能
分析项目架构和技术栈
优化这个复杂查询

DevOps 与自动化

设置 Docker 容器化
创建 GitHub Actions 流水线
更新所有依赖到最新版本
配置 Nginx 反向代理

Unix 哲学组合

git diff | claude -p "审查变更并生成报告"
tail -f app.log | claude -p "发现异常立即通知"
find . -name "*.js" -exec claude -p "优化此文件" {} \;

CLI 命令速查

基础命令

CLI 选项

CLI 子命令速查

认证管理

其他子命令

内置斜杠命令速查

基本操作

账户与模型

文件与代码

Git 与版本控制

开发工具

调试与排障

自动化与计划

输出与界面

IDE 与集成

安装与升级

其他

内置 Bundled Skills

Auto Memory 系统

基础命令

配置

# 设置自动记忆目录 (user/local 级别)
autoMemoryDirectory: "~/my-memory-dir"

# memory frontmatter - 持久记忆 (v2.1.33+)
---
memory: 记住这个项目的技术栈是 Next.js + TypeScript
---

记忆文件位置

.claude/memory.md      # 项目级记忆
~/.claude/memory.md    # 全局记忆
autoMemoryDirectory/   # 自定义自动记忆目录

记忆语法

# 项目记忆
## 代码规范
- 使用 TypeScript 严格模式
- 函数必须类型注解

## 项目结构
- src/: 源代码
- tests/: 测试

版本历史速记

• worktree.baseRef sandbox.bwrapPath/socatPath parentSettingsBehavior：设置、 托管设置、 管理级 key、Hooks effort 级别传递
• CLAUDE_CODE_SESSION_ID CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN：环境变量、 禁用选项、剪贴板粘贴提示
• v2.1.131（2026-05-06）：VS Code 扩展激活修复、Mantle 端点认证修复
• v2.1.122（2026-04-28）：OAuth 认证 401 重试循环修复
• /teleport：Skills 热重载、Agent 上下文分叉、Hooks 生命周期、、语言设置等百项更新
• v2.1.50（2026-02-20）：Worktree 隔离支持
• v2.1.59（2026-02-26）：Auto Memory 自动记忆
• /simplify /batch：、 命令
• /loop：+ cron 调度
• /effort：MCP elicitation、
• /branch /fork：（旧 ）、Opus 4.6 token 限额
• rate_limits effort：statusline、 frontmatter
• --bare：flag
• managed-settings.d/ CwdChanged FileChanged：、/ hooks
• TaskCreated：PowerShell 工具预览、 hook
• v2.1.85（2026-03-26）：MCP headersHelper、时间戳标记
• v2.1.86（2026-03-27）：Session-Id header、Read 工具优化
• defer PermissionDenied：权限决策、 hook
• /powerup：、PowerShell 强化

Hooks 系统

配置文件

.claude/hooks.json        # 项目级
~/.claude/hooks.json      # 全局

事件类型

Hook 条件语法

{
  "pre-edit": {
    "if": "file.endsWith('.js')",
    "script": "console.log('编辑 JS')"
  }
}

Hooks 传递 Effort 级别（v2.1.133+）

// hooks 现在通过 effort.level JSON 字段和 $CLAUDE_EFFORT 环境变量接收 effort 级别
{
  "PreToolUse": {
    "if": "tool.name == 'Bash' && effort.level == 'high'",
    "script": "console.log('高 effort 级别执行 Bash')"
  }
}

defer 权限决策（v2.1.89+）

{
  "PreToolUse": {
    "if": "tool.name == 'Bash'",
    "script": "return { defer: true }"
  }
}

MCP 集成

管理命令

CLI 子命令

claude mcp                    # MCP 配置

环境变量

Settings 配置速查

配置作用域

常用设置

权限设置

{
  "permissions": {
    "allow": ["Bash(git *)", "Read(./src/**)"],
    "deny": ["Read(./.env)", "Bash(rm -rf *)"],
    "defaultMode": "acceptEdits"
  }
}

沙盒设置

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true,
    "bwrapPath": "/usr/bin/bwrap",     // Linux bwrap 路径（v2.1.133+）
    "socatPath": "/usr/bin/socat",    // Linux socat 路径（v2.1.133+）
    "filesystem": {
      "allowWrite": ["/tmp/build"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

新增环境变量（v2.1.132+）

CLAUDE_CODE_SESSION_ID        # 当前会话 ID
CLAUDE_EFFORT                 # Hooks 传递的 effort 级别
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1  # 禁用 alternate screen 模式

子代理（Subagents）

内置代理

general-purpose        # 通用问题解决
code-reviewer        # 代码审查专家
test-runner          # 测试执行专家
debug-expert        # 调试专家
documentation-writer # 文档专家

调用语法

CLI 调用

claude agents                    # 列出所有子代理
claude --agent my-agent         # 指定子代理
claude --agents '{"reviewer":{"description":"..."}}'  # 动态定义

工作树（Worktree）隔离

CLI 选项

--worktree / -w [name]          # 创建 worktree
--tmux                          # 创建 tmux 会话
--tmux=classic                  # 传统 tmux

设置

{
  "worktree": {
    "symlinkDirectories": ["node_modules", ".cache"],
    "sparsePaths": ["packages/my-app"],
    "baseRef": "origin/main"    // 新建 worktree 的基础分支（v2.1.133+，fresh|head，默认 origin/<default>）
  }
}

远程控制（Remote Control）

CLI

claude remote-control --name "My Project"  # 启动服务器
claude --remote-control                     # 交互模式启用

Web 会话

claude --remote "任务描述"    # 创建 Web 会话
claude --teleport            # 恢复 Web 会话到本地

Chrome 集成

CLI 选项

--chrome                     # 启用 Chrome 集成
--no-chrome                  # 禁用 Chrome 集成

输出风格配置

基础模式

语言风格

/output-style --javascript google
/output-style --python pep8
/output-style --typescript standard

状态行配置

命令

/statusline enable        # 启用
/statusline disable       # 禁用
/statusline reset         # 重置

显示信息

--show model              # 当前模型
--show tokens             # Token 使用
--show time               # 响应时间
--show rate_limits        # 速率限制
--show git-branch         # Git 分支

位置与主题

--position top/bottom     # 位置
--align left/center/right # 对齐
--theme dark/light/auto   # 主题
--style minimal/detailed  # 风格

终端与快捷键

快捷键

终端配置

/terminal-setup --bind "Ctrl+P" /previous
/terminal-setup --preset vim
/terminal-setup --theme monokai

权限管理

基础命令

权限模式

CLI 选项

--permission-mode <mode>           # 指定模式
--enable-auto-mode                  # 启用自动模式
--allow-dangerously-skip-permissions  # 允许跳过

隐私设置

数据保留

/privacy-settings retention 7days
/privacy-settings retention 30days
/privacy-settings retention session
/privacy-settings retention permanent

匿名化

anonymize-on/off           # 开关匿名化
strip-paths                # 移除路径
strip-usernames            # 移除用户名
mask-secrets               # 遮蔽密钥
detect-pii                 # 检测隐私信息

故障排除

诊断

/doctor                    # 健康检查
--debug                    # 调试模式
--debug-file /tmp/claude-debug.log  # 调试日志
--log-level debug          # 详细日志
claude auth status         # 认证状态

常见问题

配置重置

/config reset             # 重置配置
rm -rf .claude/           # 清理项目配置
claude auth logout && claude auth login  # 重新认证

CLAUDE.md 与记忆系统

CLAUDE.md 位置

~/.claude/CLAUDE.md       # 用户级
CLAUDE.md                 # 项目根目录
.claude/CLAUDE.md         # 项目 .claude 目录

frontmatter 支持

---
memory: 项目上下文记忆
effort: medium
agent: code-reviewer
---

用途

• 项目级指令和上下文
• 编码规范和约定
• 常用命令和脚本
• 团队知识共享

🧾 版本变更

v2.1.133（2026-05-08）

• worktree.baseRef fresh head origin/<default>
• sandbox.bwrapPath sandbox.socatPath
• parentSettingsBehavior 'first-wins' | 'merge'
• effort.level $CLAUDE_EFFORT
• Focus mode 行为改进、内存使用优化

v2.1.132（2026-05-07）

• CLAUDE_CODE_SESSION_ID
• CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1
• 剪贴板粘贴提示改进

v2.1.131（2026-05-06）

• 修复 Windows VS Code 扩展激活问题
• 修复 Mantle 终端认证错误