快速定位

最短路径

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/: 测试

新功能模块（v2.1+）

v2.1.90（2026-04-01）

v2.1.89（2026-04-01）

v2.1.86（2026-03-27）

v2.1.85（2026-03-26）

v2.1.84（2026-03-26）

v2.1.83（2026-03-25）

v2.1.81（2026-03-20）

v2.1.80（2026-03-19）

v2.1.79（2026-03-18）

v2.1.78（2026-03-17）

v2.1.77（2026-03-17）

v2.1.76（2026-03-14）

v2.1.74（2026-03-12）

v2.1.73（2026-03-11）

v2.1.72（2026-03-10）

v2.1.71（2026-03-07）

v2.1.69（2026-03-05）

v2.1.63（2026-02-28）

v2.1.59（2026-02-26）

v2.1.51（2026-02-24）

v2.1.50（2026-02-20）

v2.1.41（2026-02-13）

Hooks 系统

配置文件

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

事件类型

Hook 条件语法

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

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,
    "filesystem": {
      "allowWrite": ["/tmp/build"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

子代理（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"]
  }
}

远程控制（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
---

用途

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