Claude Code命令速查手册

一、最高频：每天必用

1.1 启动与进入会话 [高频]

管道用法示例：cat error.log \| claude -p "分析这个报错并给出修复建议"

1.2 上下文引用（@ 与 !）[高频]

在对话输入框中直接使用，无需斜杠前缀。

示例：

@src/main.py 帮我分析这个文件的入口逻辑
@https://docs.example.com/api 根据这个文档生成 SDK
!find . -name "*.py" | head -20

1.3 上下文与费用管理 [高频]

会话过长 → 用 /compact 保信息；切换任务 → 用 /clear 防混淆；大文件 → 用 @ 引用而非直接粘贴。

1.4 最高频快捷键 [高频]

更完整的快捷键见 第四章。

二、高频：开发工作流

2.1 提交与代码审查 [高频]

审查指定文件：@src/api.py 审查这个文件的安全性和性能问题
审查最近提交：!git diff HEAD~1 后让 Claude 检查安全问题

2.2 配置与切换 [中频]

三、中频：安装、配置与权限（终端 / Shell）

3.1 安装 / 更新 / 版本 [中频]

3.2 配置管理（claude config）[中频]

3.3 权限与安全（启动参数）[低频]

四、完整快捷键速查表（REPL 交互界面）

适用于 claude 启动后的终端交互界面。Mac 上部分 Ctrl 组合以 ⌘ 为准；REPL 快捷键跨平台一致。

4.1 输入与发送

4.2 会话控制 / 中断 / 退出

4.3 历史与导航

4.4 权限与模式切换

4.5 任务与后台

4.6 粘贴与图片

4.7 任务执行中的确认

当 Claude 展示差异并询问「Apply?」时，通常只需输入首字母 + Enter：

4.8 Vim 模式快捷键（启用 /vim 后）

五、中低频：其余斜杠命令

六、CLAUDE.md 项目配置文件

在项目根目录创建 CLAUDE.md，Claude Code 启动时会自动读取。

6.1 常用配置内容

# 项目说明

## 技术栈
- 语言：Python 3.12
- 框架：FastAPI
- 数据库：PostgreSQL

## 代码规范
- 使用 Black 格式化
- 类型注解必须完整
- 函数必须有 docstring

## 禁止事项
- 不要修改 config/ 目录下的配置文件
- 不要直接操作生产数据库

6.2 配置层级

七、实用技巧与工作流

7.1 上下文管理

• 会话过长：/compact 压缩上下文，保留关键信息
• 切换任务：/clear 清除上下文，避免混淆
• 大文件处理：用 @文件路径 引用而非直接粘贴，减少 token 消耗

7.2 Git 集成

# 查看变更并审查
!git diff HEAD~1
审查最近的提交变更，检查是否有安全问题

# 生成分支说明
!git log --oneline main..feature-branch
为这个 feature 分支生成 PR 描述

7.3 调试与诊断

/status      # 查看会话状态
/cost        # 查看费用
/doctor      # 诊断安装与配置（注意是斜杠命令）

7.4 批量文件处理

# 引用整个目录批量操作
@src/components/ 给所有组件添加 TypeScript 类型声明

# 管道模式批量处理
!find . -name "*.py" -type f | head -20
分析这些 Python 文件的 import 依赖关系

7.5 导出历史会话

# 安装导出工具
pipx install claude-conversation-extractor
# 导出全部会话
claude-extract --all --detailed --output ~/claude-markdown-exports

八、环境变量

备注：命令可能随版本更新变化，建议定期执行 /help 查看最新可用命令。完整文档参考：https://docs.anthropic.com/en/docs/claude-code