xhj的博客

Claude Code 最佳实践 从配置环境到跨并行会话扩展，充分利用 Claude Code 的提示和模式。 Claude Code 是一个代理式编码环境。与等待回答问题的聊天机器人不同，Claude Code 可以读取你的文件、运行命令、进行更改，并在你观看、重定向或完全离开的情况下自主解决问题。 这改变了你的工作方式。与其自己编写代码并要求 Claude 审查，不如描述你想要什么，让 Claude 弄清楚如何构建它。Claude 会探索、规划和实现。 但这种自主性仍然伴随着学习曲线。Claude 在某些约束条件下工作，你需要理解这些约束。 本指南涵盖了在 Anthropic 内部团队和在各种代码库、语言和环境中使用 Claude Code 的工程师中已被证明有效的模式。有关代理循环如何在幕后工作的信息，请参阅 Claude Code 如何工作。 大多数最佳实践都基于一个约束：Claude 的 context window 填充速度很快，随着填充，性能会下降。 Claude 的 context window 保存你的整个对话，包括每条消息、Claude 读取的每个文件和每...

并行运行代理 比较 Claude Code 同时处理多个任务的方式：子代理、代理视图、代理团队和动态工作流。 子代理、代理视图、代理团队 和 动态工作流 各自以不同的方式并行化工作。正确的选择取决于您是否想在每个对话中保持参与、交付任务并稍后检查，或让 Claude 为您协调一组工作人员。 方法 它提供什么 何时使用 子代理 在一个会话内的委派工作人员，在自己的上下文中执行辅助任务并返回摘要 辅助任务会用搜索结果、日志或文件内容淹没您的主对话，而您不会再次引用这些内容 代理视图 一个屏幕来分派和监控在后台运行的会话，使用 claude agents 打开。研究预览 您有多个独立任务，想要交付它们，一目了然地检查状态，并仅在需要时介入 代理团队 多个协调的会话，具有共享任务列表和代理间消息传递，由主导者管理。实验性功能，默认禁用 您希望 Claude 将项目分成多个部分、分配它们，并保持工作人员同步 动态工作流 一个脚本，运行许多子代理并交叉检查其结果，用于一个太大而无法一次协调的工作或需要多次处理的工作。研究预览 一个任务对于少数几个子代理来说太大了，或...

使用 agent view 管理多个代理 从一个屏幕调度和管理多个 Claude Code 会话。Agent view 显示每个会话正在做什么以及哪些会话需要你的输入。 Agent view 通过 claude agents 打开，是所有后台会话的一个屏幕：什么正在运行、什么需要你的输入、什么已完成。调度新会话，一目了然地查看它们的状态而不是滚动浏览记录，只在需要时才介入。每个后台会话都是一个完整的 Claude Code 对话，在没有终端连接的情况下继续运行，所以你可以随时打开它、回复并离开。 当你有多个独立任务 Claude 可以在不需要你观看每一步的情况下处理时，使用 agent view。调度一个 bug 修复、一个拉取请求审查和一个不稳定测试调查作为三行，在另一个窗口中继续工作，当一行显示它需要你或有结果时检查回来。 当你想在任何代理的会话中更直接地工作时，附加到该行以进入完整对话。 要比较 agent view 与 subagents、agent teams 和 worktrees，请参阅 并行运行代理。 Agent view 是研究预览版，需要 Cl...

为您的组织设置 Claude Code 针对部署 Claude Code 的管理员的决策地图，涵盖 API 提供商、托管设置、策略执行、使用情况监控和数据处理。 Claude Code 通过托管设置强制执行组织策略，这些设置优先于本地开发人员配置。您可以从 Claude 管理控制台、移动设备管理 (MDM) 系统或磁盘上的文件传递这些设置。这些设置控制 Claude 可以访问的工具、命令、服务器和网络目标。 本页按顺序介绍部署决策。每一行都链接到下面的部分和该区域的参考页面。 SSO、SCIM 预配和座位分配在 Claude 账户级别配置。有关这些步骤，请参阅 [Claude 企业管理员指南](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide) 和 [座位分配](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan)。 ...

故障排除 修复 Claude Code 中的高 CPU 或内存使用、挂起、自动压缩抖动和搜索问题，并找到其他问题的正确页面。 本页涵盖 Claude Code 运行后的性能、稳定性和搜索问题。对于其他问题，请从与您遇到的问题相匹配的页面开始： 症状 转到 command not found、安装失败、PATH 问题、EACCES、TLS 错误 故障排除安装和登录 登录循环、OAuth 错误、403 Forbidden、”organization disabled”、Bedrock/Vertex/Foundry 凭据 故障排除安装和登录 设置未应用、hooks 未触发、MCP 服务器未加载 调试您的配置 API Error: 5xx、529 Overloaded、429、请求验证错误 错误参考 model not found 或 you may not have access to it 错误参考 VS Code 扩展未连接或未检测到 Claude VS Code 集成 JetBrains 插件或 IDE 未检测到 JetB...

排查安装和登录问题 修复安装或登录 Claude Code 时出现的命令未找到、PATH、权限、网络和身份验证错误。 如果安装失败或无法登录，请在下面找到您的错误。有关 Claude Code 正常工作后的运行时问题，请参阅 Troubleshooting。有关配置问题（例如设置未应用或 hooks 未触发），请参阅 Debug your configuration。 查找您的错误将您看到的错误消息或症状与解决方案相匹配： 您看到的内容 解决方案 command not found: claude 或 'claude' is not recognized 修复您的 PATH syntax error near unexpected token '<' 安装脚本返回 HTML curl: (22) The requested URL returned error: 403 安装脚本返回 403 curl: (23) 或 curl: (56) Failure writing output to destination 检...

企业部署概览 了解 Claude Code 如何与各种第三方服务和基础设施集成，以满足企业部署需求。 export const ContactSalesCard = ({surface}) => { const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}; const iconArrowRight = (size = 13) => ; const STYLES = .cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30,...

创建自定义 subagents 在 Claude Code 中创建和使用专门的 AI subagents，用于特定任务的工作流和改进的上下文管理。 Subagents 是处理特定类型任务的专门 AI 助手。当一个辅助任务会用搜索结果、日志或文件内容充斥您的主对话，而您不会再次引用这些内容时，请使用一个 subagent：该 subagent 在自己的上下文中完成这项工作，仅返回摘要。当您不断生成相同类型的工作者并使用相同的指令时，定义一个自定义 subagent。 每个 subagent 在自己的 context window 中运行，具有自定义系统提示、特定的工具访问权限和独立的权限。当 Claude 遇到与 subagent 描述相匹配的任务时，它会委托给该 subagent，该 subagent 独立工作并返回结果。要在实践中看到上下文节省，context window 可视化 演示了一个 subagent 在自己的独立窗口中处理研究的会话。 Subagents 在单个会话中工作。要在并行运行许多独立会话并从一个地方监控它们，请参阅 [background agen...

Slack 中的 Claude Code 直接从 Slack 工作区委派编码任务 Slack 中的 Claude Code 将 Claude Code 的强大功能直接引入您的 Slack 工作区。当您使用编码任务提及 @Claude 时，Claude 会自动检测意图并在网络上创建 Claude Code 会话，允许您在不离开团队对话的情况下委派开发工作。 此集成基于现有的 Claude for Slack 应用程序构建，但为与编码相关的请求添加了到网络上 Claude Code 的智能路由。 用例 Bug 调查和修复：要求 Claude 在 Slack 频道中报告 Bug 时立即调查和修复。 快速代码审查和修改：让 Claude 根据团队反馈实现小功能或重构代码。 协作调试：当团队讨论提供关键背景信息（例如错误重现或用户报告）时，Claude 可以使用该信息来指导其调试方法。 并行任务执行：在 Slack 中启动编码任务，同时继续其他工作，完成时收到通知。 前置条件在使用 Slack 中的 Claude Code 之前，请确保您具有以下条件： 要求 详情 Clau...

使用 skills 扩展 Claude 创建、管理和共享 skills 以在 Claude Code 中扩展 Claude 的功能。包括自定义命令和捆绑 skills。 Skills 扩展了 Claude 能做的事情。创建一个 SKILL.md 文件，其中包含说明，Claude 会将其添加到其工具包中。Claude 在相关时使用 skills，或者你可以使用 /skill-name 直接调用一个。 当你不断将相同的说明、检查清单或多步骤程序粘贴到聊天中时，或者当 CLAUDE.md 的一部分已经演变成程序而不是事实时，创建一个 skill。与 CLAUDE.md 内容不同，skill 的正文仅在使用时加载，因此长参考资料在你需要它之前几乎不花费任何成本。 对于内置命令（如 `/help` 和 `/compact`）以及捆绑 skills（如 `/debug` 和 `/code-review`），请参阅[命令参考](/zh-CN/commands)。 自定义命令已合并到 skills 中。 .claude/commands/deploy.md 中的文件和 .claud...