官方文档

Anthropic Engineering Blog

30 分钟掌握 Claude Code

视频: https://www.youtube.com/watch?v=6eBSHbLKuN0

全部技巧

• 探索高级功能和快捷键

  • 定期查看 Claude 发布说明中的新代码编辑与上下文功能。
  • 学习键盘快捷键，在聊天、文件和编辑器视图之间快速切换。

• 高效设置

  • 为项目创建带有清晰名称和描述的会话，便于之后查找。
  • 将最常用的文件或文件夹固定住，让 Claude 随时可访问。
  • 配置 Claude 的集成，例如 GitHub 和常见 IDE，以简化你的编码流程。

• 高效的代码库问答

  • 向 Claude 询问架构、设计模式和具体模块的细节问题。
  • 在问题里使用文件和行号引用，例如：“app/models/user.py 里的逻辑是在做什么？”
  • 对于大型代码库，提供摘要或清单，帮助 Claude 聚焦。
  • 示例提示词：“你能解释一下 src/auth/AuthService.ts:45-120 里实现的认证流程吗？它是如何与 src/middleware/auth.ts 里的中间件集成的？”

• 代码编辑与重构

  • 使用代码块中的内联注释或请求来获得更聚焦的编辑结果（例如：“把这个函数重构得更清晰一些”）。
  • 让 Claude 给出并排的修改前后对比。
  • 在重大修改后，让 Claude 生成测试或文档，以保证质量。
  • 示例提示词：“把 api/users.js 里的 getUserData 函数从 promises 改成 async/await。给我一个修改前后对比，并为重构后的版本生成单元测试。”

• 上下文管理

  • 只粘贴当前任务真正需要的代码和上下文。
  • 使用结构化提示词（“这里是文件 A，这里是函数 B，我的问题是 X”）通常效果最好。
  • 在提示窗口里移除或折叠大文件，避免超出上下文限制。
  • 示例提示词：“这里是 models/User.js 里的 User 模型，以及 utils/validation.js 里的 validateUser 函数。我的问题是：如何在保持向后兼容的前提下添加邮箱验证？”

• 接入团队工具

  • 将 Claude 会话连接到你们团队的代码仓库和文档。
  • 使用内置模板，或为重复出现的工程任务创建自定义模板。
  • 通过和队友共享会话记录与提示词来协作。

• 提升性能

  • 给 Claude 清晰、面向目标的指令，例如：“用五个要点总结这个类”。
  • 从上下文窗口中删掉不必要的注释和样板代码。
  • 如果 Claude 的输出跑偏了，重置上下文或重新表述问题，以获得更好的对齐。
  • 示例提示词：“用五个要点总结 src/db/Manager.ts 里的 DatabaseManager 类，重点说明它的核心职责和关键方法。”

• 实用场景示例

  • 调试：粘贴错误和堆栈信息，然后询问可能的原因和修复方式。
  • 生成测试：为复杂逻辑请求属性测试、单元测试或集成测试。
  • 代码审查：请 Claude 识别风险变更、边界情况或代码异味。
  • 示例提示词：
    • “我遇到这个错误：TypeError: Cannot read property 'map' of undefined at line 42 in components/UserList.jsx。这是堆栈信息和相关代码。是什么原因导致的？我该怎么修复？”
    • “为 PaymentProcessor 类生成完整的单元测试，包括失败交易、超时和无效输入等边界情况。”
    • “审查这个 pull request diff，找出潜在的安全问题、性能瓶颈和代码异味。”

• 工作流自动化

  • 用 Claude 提示词为格式化、清理、批量重命名等重复任务编写脚本。
  • 用 Claude 基于代码 diff 起草 PR 描述、发布说明或文档。
  • 示例提示词：“根据 git diff，生成一份详细的 PR 描述，包含变更摘要、修改文件列表、测试步骤和潜在影响。同时为 2.3.0 版本生成发布说明。”

提示：想要获得最佳效果，可以把这些实践组合起来使用。先固定关键文件并总结目标，再使用聚焦的提示词和 Claude 的重构工具，逐步改进你的代码库和自动化流程。

与 Claude Code 配合使用的推荐工作流

Claude Code 推荐工作流

新仓库场景

1. 初始化仓库并接入 Claude

   • 建立新仓库的基础结构：README、LICENSE、.gitignore、根配置文件。
   • 创建 CLAUDE.md，说明架构、高层目标和编码规范。
   • 安装 Claude Code，并将其连接到仓库，用于代码建议、测试脚手架和工作流自动化。

2. 使用计划模式和规格说明

   • 在实现功能之前，使用计划模式（shift-tab 或 /plan）先写详细规格。
   • 让 Claude 给出架构建议和初始项目布局。
   • 保持清晰、面向目标的提示词序列，依次询问组件轮廓、主要模块和职责。

3. 迭代开发与审查

   • 把核心功能拆成小块逐步实现，并在过程中请求 Claude 生成代码、重构和文档。
   • 每增加一小步，都请求单元测试和示例。
   • 在 CLAUDE.md 中维护持续更新的任务列表。

4. 自动化 CI/CD 和部署

   • 用 Claude 搭建 GitHub Actions、npm/yarn 脚本或部署工作流。
   • 通过更新 CLAUDE.md 并请求对应命令/脚本，轻松调整流水线。

graph TD
    A[Start New Repository] --> B[Initialize Repository Structure]
    B --> C[Create README, LICENSE, .gitignore]
    C --> D[Create CLAUDE.md]
    D --> E[Document Architecture & Guidelines]
    E --> F[Install & Link Claude Code]

    F --> G[Enter Plan Mode]
    G --> H[Draft Feature Specification]
    H --> I[Get Architecture Suggestions]
    I --> J[Define Components & Modules]

    J --> K[Implement Feature Chunk]
    K --> L[Generate Code with Claude]
    L --> M[Request Unit Tests]
    M --> N[Review & Refactor]
    N --> O{More Features?}
    O -->|Yes| K
    O -->|No| P[Update Task List in CLAUDE.md]

    P --> Q[Setup CI/CD Pipeline]
    Q --> R[Scaffold GitHub Actions]
    R --> S[Create Deployment Scripts]
    S --> T[Test Automation]
    T --> U[Repository Ready]

    style A fill:#e1f5ff
    style G fill:#fff4e1
    style K fill:#f0ffe1
    style Q fill:#ffe1f5
    style U fill:#90EE90

现有仓库场景

1. 仓库与上下文准备

   • 添加或更新 CLAUDE.md，记录仓库结构、编码模式和关键文件。对于旧仓库，可以使用 CLAUDE_LEGACY.md，其中涵盖框架、版本映射、说明、已知问题和升级笔记。
   • 固定或高亮 Claude 应该用来作为上下文的主文件。

2. 上下文驱动的代码问答

   • 让 Claude 基于具体文件/函数，回答代码审查、 bug 解释、重构或迁移计划。
   • 给 Claude 明确边界，例如“只修改这些文件”或者“不要新增依赖”。

3. 分支、工作区和多会话管理

   • 使用多个 git worktree 做隔离的功能开发或 bug 修复，并为每个 worktree 启动独立的 Claude 会话。
   • 通过终端标签页/窗口按分支或功能组织并行工作。

4. 团队工具和自动化

   • 通过 .claude/commands/ 同步自定义命令，保持团队一致性。
   • 用 Claude 的 slash commands 或 hooks 自动化重复任务、PR 创建和代码格式化。
   • 与团队成员共享会话和上下文，便于协作排障和审查。

graph TD
    A[Start with Existing Repository] --> B{Legacy Codebase?}
    B -->|Yes| C[Create CLAUDE_LEGACY.md]
    B -->|No| D[Create/Update CLAUDE.md]
    C --> E[Document Frameworks & Version Maps]
    D --> F[Document Structure & Patterns]
    E --> G[Pin Key Files for Context]
    F --> G

    G --> H[Identify Task Type]
    H --> I{Task Category}
    I -->|Bug Fix| J[Ask Claude for Bug Analysis]
    I -->|Code Review| K[Request Code Review]
    I -->|Refactor| L[Plan Refactoring Strategy]
    I -->|Migration| M[Create Migration Plan]

    J --> N[Set Explicit Boundaries]
    K --> N
    L --> N
    M --> N

    N --> O{Multiple Features?}
    O -->|Yes| P[Create Git Worktrees]
    O -->|No| Q[Work on Main Branch]
    P --> R[Launch Separate Claude Sessions]
    R --> S[Organize Terminal Tabs]
    Q --> S

    S --> T[Setup Team Automation]
    T --> U[Sync .claude/commands/]
    U --> V[Configure Slash Commands]
    V --> W[Setup Hooks for Automation]
    W --> X[Share Session Context with Team]

    X --> Y{More Tasks?}
    Y -->|Yes| H
    Y -->|No| Z[Workflow Complete]

    style A fill:#e1f5ff
    style C fill:#ffecec
    style D fill:#fff4e1
    style P fill:#f0ffe1
    style T fill:#ffe1f5
    style Z fill:#90EE90

提示：

• 每个新功能或修复都从规格和计划模式提示词开始。
• 对于旧仓库和复杂仓库，把更详细的指导存放在 CLAUDE.md / CLAUDE_LEGACY.md 中。
• 给出清晰、聚焦的指令，把复杂工作拆成多阶段计划。
• 定期清理会话、裁剪上下文，并删除已完成的工作区，避免堆积混乱。

这些步骤概括了在新旧代码库中更顺畅使用 Claude Code 的核心建议。

2026 年 3 月新增功能与能力

关键功能资源