Claude Code 功能手册

本文档旨在详细介绍 Claude Code 在软件开发场景中的各项功能和使用方法。内容涵盖基础操作、会话管理、高级技巧及自动化集成，以帮助开发者高效利用此工具。

---

1. 基础操作

本章节介绍 Claude Code 的基本设置和核心命令。

1.1 IDE 插件安装

为实现在 IDE 与终端间的协同工作，可以安装 Claude Code 插件。

• 支持平台：VS Code, Cursor, JetBrains 系列 IDE。
• 功能：在 IDE 中快速启动和管理 Claude Code 会话。

1.2 常用命令

以下是 Claude Code 的核心命令列表：

命令	功能	示例
claude	启动交互式会话	claude
claude "task"	运行一次性任务并退出	claude "refactor this function"
claude -p "query"	运行一次性查询并退出	claude -p "explain this regex"
claude -c	继续最近的会话	claude -c
claude -r	从历史列表中选择并恢复会话	claude -r
claude commit	使用 Claude 生成 Git 提交信息	claude commit
/clear	清除当前会话的上下文	在会话中输入 /clear
/help	显示所有可用命令	在会话中输入 /help
exit 或 Ctrl+C	退出当前会话	在会话中输入 exit

1.3 CLAUDE.md 项目配置

CLAUDE.md 文件用于定义项目级的规范和上下文，指导 AI 的行为。您可以在其中指定代码风格、构建命令、开发环境信息等。

配置层级与优先级：

文件路径	作用
~/.claude/CLAUDE.md	全局默认配置：适用于所有项目。
项目根目录/CLAUDE.md	项目级配置：团队共享，应提交至版本控制。
项目根目录/CLAUDE.local.md	本地个人配置：覆盖项目配置，应加入 .gitignore。
子目录/CLAUDE.md	子模块配置：仅对该子目录生效，优先级最高。

动态添加配置：
在会话中，输入 # 后跟上配置内容，可将其动态添加至当前上下文的 CLAUDE.md 文件中。

1.4 图像处理

Claude Code 支持图像输入。您可以粘贴图片（如UI设计稿、错误截图），并要求 Claude 基于图像内容执行任务。上传后，图片在终端中会以 [Image #id] 占位符显示。

1.5 跳过权限确认 (Safe YOLO Mode)

默认情况下，Claude Code 在执行文件修改或系统命令等敏感操作时会请求用户确认。为实现自动化，可以使用以下启动参数跳过所有确认提示：

claude --dangerously-skip-permissions

注意：请在确认操作安全性的前提下使用此模式。

---

2. 交互与会话管理

本章节介绍如何高效地管理会话和交互流程。

• /clear：清除当前对话上下文，以开始一个干净的对话，避免历史信息干扰。
• /compact：压缩对话历史，保留摘要信息，以减少 token 消耗并保持上下文的精确性。
• 快捷键：
  • /：显示可用命令列表。
  • 方向键 (上/下)：浏览历史输入。
  • Tab：自动补全命令或文件名。
  • Option+Enter (macOS) / Alt+Enter (Windows/Linux)：在输入框中换行。
  • ESC：立即中断 AI 正在执行的任务。
• 会话恢复：
  • claude -c：继续上一次的会话。
  • claude -r：列出历史会话供选择恢复。
  • /resume：在当前会话中切换到另一个历史会话。

2.1 自定义命令

您可以将常用的指令集或工作流封装为自定义命令，以简化重复性任务。

• 用户级命令：
  • 路径：~/.claude/commands/
  • 调用：/user:<命令名>
  • 适用范围：所有项目通用。
• 项目级命令：
  • 路径：.claude/commands/ (项目根目录)
  • 调用：/project:<命令名>
  • 适用范围：仅当前项目。

示例：
在 .claude/commands/ 目录下创建一个 fix-issue.md 文件，内容如下：

请根据以下步骤修复 GitHub Issue：$ARGUMENTS。

1. 使用 `gh issue view` 查看 Issue 详情。
2. 分析并定位相关代码。
3. 实施修复。
4. 编写并运行测试。
5. 提交代码并创建 PR。

之后，您可以在 Claude Code 中运行 /project:fix-issue 123，$ARGUMENTS 会被自动替换为 123，并执行预设流程。

---

3. 提示策略

本章节介绍如何通过优化提示词来提升 AI 输出质量。

• 结构化提示：使用类似 XML 的标签来组织提示，可以帮助 AI 更好地区分指令、上下文和示例。

  <instruction>
  主要任务或目标。
  </instruction>
  <context>
  任务相关的背景信息，如框架、规范等。
  </context>
  <code_example>
  可供参考的代码片段。
  </code_example>
  

• 预激活 (提供上下文)：在分配具体任务前，先让 Claude 阅读和理解相关代码或文档。例如，先让它“总结 /src/api/ 目录的结构和功能”，再要求它“在该目录中添加一个新的端点”。
• 强制深度思考：在提示中加入特定关键词，可以引导模型进行更深入的思考，从而提高输出质量，尽管响应时间可能会增加。常用关键词包括 think harder, ultrathink, step-by-step reasoning。
• 提供清晰需求：需求描述越详细、明确，AI 的执行结果就越准确。应包含功能点、接口定义、边界条件等信息。

---

4. 软件开发实践

本章节介绍 Claude Code 在具体开发任务中的应用方法。

• 任务拆解：
  • 简单任务：对于“格式化文件”、“添加注释”等小任务，可直接下达指令。
  • 复杂任务：对于“实现一个新功能”等大任务，建议手动拆分为多个步骤（如“创建API接口”、“添加数据验证”、“编写测试用例”），分步引导 Claude 完成。
• Linux 命令辅助：您可以用自然语言描述需求，让 Claude 生成对应的复杂 Linux/Bash 命令，并提供解释。例如：“查找当前目录下过去24小时内修改过的所有 .ts 文件”。

---

5. 成本与模型管理

本章节介绍如何管理模型和监控使用成本。

• /model：切换使用的模型。例如，在 Claude Sonnet 4 (默认) 和 Claude Opus (性能更强) 之间切换。
• /cost：查看当前会话的 token 消耗和费用统计。
• ccusage 工具：一个用于更精细化成本监控的命令行工具。
  • 安装：sudo npm install -g ccusage
  • 常用命令：

    ccusage daily      # 查看每日报告
    ccusage monthly    # 查看月度报告
    ccusage session    # 按会话统计
    ccusage blocks --live # 实时监控仪表盘
    

---

6. 进阶功能

本章节介绍 Claude Code 的高级用法和集成能力。

6.1 并行会话 (Git Worktrees)

通过 Git Worktrees，您可以在同一仓库的不同分支上同时运行多个相互隔离的 Claude Code 会话，适合并行处理多个任务（如新功能开发和 Bug 修复）。

1. 创建 Worktree：git worktree add ../project-feature-a -b feature-a
2. 进入目录并启动 Claude：cd ../project-feature-a && claude
3. 管理 Worktree：使用 git worktree list 查看，git worktree remove <path> 删除。

6.2 MCP (Meta-protocol for Claude)

MCP 允许 Claude Code 与外部系统（如数据库、Web API）进行交互。

• claude mcp add <name> <command>：添加一个 MCP 服务。
• claude mcp list：查看已配置的服务。
• claude mcp remove <name>：删除一个服务。

6.3 GitHub Action 集成

通过集成的 GitHub App，您可以在 GitHub 的 Issues 和 Pull Requests 中直接调用 Claude。

1. 安装：在 Claude Code 中运行 /install-github-app 并按提示操作。
2. 使用：在 Issue 或 PR 的评论区 @claude 并下达指令，例如：@claude implement this feature 或 @claude please review this PR。

6.4 作为类 Unix 程序使用

Claude Code 可以通过管道 (|) 和重定向 (>) 融入命令行工作流，像一个标准的 Unix 工具一样处理输入和输出。

• 管道输入：

  cat error.log | claude -p 'explain the root cause of this error'
  

• 指定输出格式：使用 --output-format 参数。
  • text (默认)：纯文本输出。
  • json：输出包含元数据（如成本）的 JSON 对象。
  • stream-json：实时逐条输出 JSON 消息，适合处理长流。
• 集成到构建脚本：
  可以在 package.json 中定义一个脚本，将 Claude 作为代码审查或分析工具。

  "scripts": {
    "lint:claude": "claude -p 'review staged files for potential typos and report them'"
  }