claude-howto/zh/resources.md

优质资源清单

官方文档

资源	说明	链接
Claude Code 文档	Claude Code 官方文档	code.claude.com/docs/en/overview
Anthropic 文档	Anthropic 完整文档	docs.anthropic.com
MCP Protocol	Model Context Protocol 规范	modelcontextprotocol.io
MCP Servers	官方 MCP server 实现	github.com/modelcontextprotocol/servers
Anthropic Cookbook	代码示例和教程	github.com/anthropics/anthropic-cookbook
Claude Code Skills	社区技能仓库	github.com/anthropics/skills
Agent Teams	多 agent 协作与协调	code.claude.com/docs/en/agent-teams
Scheduled Tasks	使用 /loop 和 cron 的周期性任务	code.claude.com/docs/en/scheduled-tasks
Chrome Integration	浏览器自动化	code.claude.com/docs/en/chrome
Keybindings	键盘快捷键自定义	code.claude.com/docs/en/keybindings
Desktop App	原生桌面应用	code.claude.com/docs/en/desktop
Remote Control	远程会话控制	code.claude.com/docs/en/remote-control
Auto Mode	自动权限管理	code.claude.com/docs/en/permissions
Channels	多通道通信	code.claude.com/docs/en/channels
Voice Dictation	Claude Code 语音输入	code.claude.com/docs/en/voice-dictation

Anthropic Engineering Blog

文章	说明	链接
Code Execution with MCP	如何通过代码执行解决 MCP 上下文膨胀问题，Token 数量减少 98.7%	anthropic.com/engineering/code-execution-with-mcp

---

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 月新增功能与能力

关键功能资源

功能	说明	了解更多
Auto Memory	Claude 会自动学习并记住你跨会话的偏好	记忆指南
Remote Control	通过外部工具和脚本以编程方式控制 Claude Code 会话	高级功能
Web Sessions	通过基于浏览器的界面访问 Claude Code，实现远程开发	CLI 参考
Desktop App	Claude Code 的原生桌面应用，界面更强大	Claude Code 文档
Extended Thinking	通过 Alt+T / Option+T 或 MAX_THINKING_TOKENS 环境变量切换深度推理	高级功能
Permission Modes	精细权限控制：default、acceptEdits、plan、auto、dontAsk、bypassPermissions	高级功能
7-Tier Memory	Managed Policy、Project、Project Rules、User、User Rules、Local、Auto Memory	记忆指南
Hook Events	25 个事件：PreToolUse、PostToolUse、PostToolUseFailure、Stop、StopFailure、SubagentStart、SubagentStop、Notification、Elicitation 等	Hooks 指南
Agent Teams	协调多个 agent 共同处理复杂任务	Subagents 指南
Scheduled Tasks	用 /loop 和 cron 工具设置周期性任务	高级功能
Chrome Integration	使用无头 Chromium 做浏览器自动化	高级功能
Keyboard Customization	自定义按键绑定，包括组合键序列	高级功能