Claude Code 使用时的笔记

2026-04-20·Technical sharing ·Claude Code · Last_modified 2026-04-20

Claude Code 命令

  • /init：Claude Code 会扫描你的代码库，并在项目目录中创建 CLAUDE.md 文件。
  • #：使用 # 可以快速添加一条记忆。当你发现 Claude Code 反复犯同一个错误时非常有用。

管理 Claude Code 的上下文

命令 说明
/clear 清空当前对话历史
/compact 总结当前对话历史
ESC 打断 Claude，用于引导或纠正它
ESC ESC 将对话回退到更早的某个时刻

在 Claude Code 中可以直接使用常规的 bash 命令，只需在命令前加上 !（例如：!pwd）。输入 exit 可退出 Claude Code。

Claude Code 功能与命令汇总

常用命令

命令 说明
@ 使用 @ 引用文件，将其内容一并包含在你的请求中
/mcp 管理 MCP 连接，查看可用的 MCP 服务器及其提供的工具（Claude Code 中的 MCP）

快捷键

快捷键 说明
shift + tab 在规划模式与自动接受模式之间切换
截图 cmd + shift + ctrl + 4（Mac）或 Win + Shift + S（Windows）
粘贴截图 Ctrl + V（在 Windows 上可能无效）

扩展思考模式

对于复杂任务（例如复杂的架构变更、棘手问题的调试），可以使用 “think” 这个关键词来触发扩展思考模式。思考强度分为多个等级：”think” < “think hard” < “think harder” < “ultrathink”，每提升一级都会为 Claude 分配更多的思考预算。

子智能体（subagents）的使用

Claude Code 自带的工具之一是 Task，它可以用来启动子智能体（subagents）去处理复杂的多步任务。你可以显式要求 Claude Code 使用子智能体来进行头脑风暴，或从多个角度调研同一个问题。这些内置的子智能体是通用型的。

你也可以创建自己的专用子智能体。每个子智能体拥有独立的上下文窗口，你可以为它定义自定义的系统提示词和专属工具。本节不会展开讲解这部分内容，详情可以查阅官方文档。

自定义斜杠命令

  • 在项目目录的 .claude 文件夹下，创建一个名为 commands 的文件夹。

  • 在 commands 文件夹中创建一个 Markdown 文件：implement-feature.md。

  • 将以下内容复制到该 Markdown 文件中：

    1
    2
    3
    4
    5
    6
    7
    You will be implementing a new feature in this codebase

    $ARGUMENTS

    IMPORTANT: Only do this for front-end features.
    Once this feature is built, make sure to write the changes you made to file called frontend-changes.md
    Do not ask for permissions to modify this file, assume you can always do it.

  • 再次启动 Claude Code，你现在就可以像使用其他内置命令一样使用这个自定义命令了。

GitHub 集成

Claude Code GitHub Actions 把 Claude 带入了你的 GitHub 工作流。完成配置后，你可以在任意 pull request 或 issue 中提及 @claude，它能够实现代码、创建 pull request，以及审查代码。最简单的配置方式是在终端的 Claude Code 中运行 /install-github-app。

更多关于如何使用这项集成的信息，可以查阅官方文档。

Hooks

Claude Code 的 hooks 是你可以自行定义的 shell 命令，它们会在 Claude Code 生命周期的不同节点被执行（工具调用前、工具调用后、子智能体完成任务时、Claude 完成响应时）。

本节只展示了 hooks 的一个简单示例。如果你想了解更多关于 hooks 的内容与示例，建议查阅：

使用Claude Code的时候常见的工作流程

理解新的代码库

  • 快速获取代码库概览
    1. 从广泛的问题开始，然后缩小到特定领域
    2. 询问项目中使用的编码约定和模式
    3. 请求项目特定术语的词汇表
  • 查找相关代码
    1. 明确说明您要查找的内容
    2. 使用项目中的领域语言
    3. 为您的语言安装代码智能插件，以便 Claude 能够精确地进行”转到定义”和”查找引用”导航
  • 高效修复错误
    1. 告诉 Claude 重现问题的命令并获取堆栈跟踪
    2. 提及重现错误的任何步骤
    3. 让 Claude 知道错误是间歇性的还是持续的
  • 重构代码
    1. 要求 Claude 解释现代方法的优势
    2. 在需要时请求更改保持向后兼容性
    3. 以小的、可测试的增量进行重构
  • 使用专门的 subagents 处理特定的任务
    1. 在 .claude/agents/ 中创建项目特定的 subagents 以供团队共享
    2. 使用描述性的 description 字段来启用自动委派
    3. 限制工具访问权限为每个 subagent 实际需要的内容
    4. 查看subagents 文档了解详细示例

使用 Plan Mode 进行安全的代码分析

Plan Mode 指示 Claude 通过使用只读操作分析代码库来创建计划，非常适合探索代码库、规划复杂更改或安全地审查代码。