拆解 Claude Code 官方文档助手的系统提示词从查询路由到故障排查的完整设计【免费下载链接】system_prompts_leaksExtracted system prompts from Anthropic - Claude Fable 5.1, Opus 5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro, Antigravity. xAI - Grok, Grok Bot, Cursor, Kimi and more! Updated regularly.项目地址: https://gitcode.com/GitHub_Trending/sy/system_prompts_leaks本文基于开源仓库 system_prompts_leaks 中逐字抓取的 Claude Code 文档助手系统提示词完整解析 Anthropic 如何为一个文档问答型 Agent设计行为边界、查询路由规则、安装故障排查流程和回答风格约束。读完后你将掌握一套可直接复用于构建支持型 AI 助手的提示词工程方法论如何界定回答范围、如何做意图消歧、如何按错误字符串路由到对应文档锚点以及如何用分步诊断代替一次性信息倾倒。一、这个提示词服务于什么产品提示词开篇即定义了产品形态该助手帮助开发者在 Claude Code 官方文档站code.claude.com/docs中查找答案。Claude Code 是 Anthropic 的命令行智能编码工具agentic coding CLI同时提供 VS Code、JetBrains、Claude Desktop 与 Web 端集成。从提示词本身可以提取三条关键的产品设计假设该助手是主要支持面primary support surface。官方没有实时聊天或工单系统因此提示词明确要求倾向于帮忙而不是推诿lean toward helping rather than deflecting——任何与安装、配置或使用相关的问题哪怕只是沾边都应尝试回答。它负责两个产品Claude CodeCLI 及其各端集成和 Claude Agent SDK用于在相同 harness 上构建自研 Agent 的 Python / TypeScript 库。Agent SDK 的文档页位于/en/agent-sdk/路径下其余页面均属于 Claude Code。有明确的外溢边界涉及 Claude API、Claude.ai 或 Claude 模型本身的问题指向平台文档订阅套餐价格Pro、Max、Team、Enterprise指向定价页账号、账单、退款问题指向支持站点。真正无法回答且疑似 bug 时才引导用户运行/feedback或在 Claude Code 的 issues 仓库提交报告需附claude --version输出与精确报错——且提示词强调只在你尝试回答之后才提供这个建议而不是作为第一响应。这种先兜底、再分流、最后才上报的三层结构是构建客服类 Agent 时的一个值得借鉴的默认行为框架。二、语言与首轮响应策略2.1 多语言回答与文档本地化提示词要求用用户所用的语言回答。链接文档页时应使用读者当前的语言前缀/ko/、/ja/、/de/、/zh-CN/等而非/en/——提示词文件中出现的/en/只是示例语言回复时应替换为读者所在语言。文档共翻译为 10 种语言德、西、法、印尼、意、日、韩、葡、俄、简体中文、繁体中文。一个容易踩坑的细节被显式点出荷兰语等未被翻译列表覆盖的语言只要问题主题相关定时运行 prompt、安装 Claude Code、配置权限等同样在回答范围内绝不能仅因语言不是英语就推诿。2.2 首轮不反问先答最可能的解读这是整个提示词中最有产品味的一段规则首轮不要求用户澄清。查询短或模糊时先回答最可能的 Claude Code 解读再附一两个备选。提示词给出了具体的映射示例agent→ subagents 页context→ context window 页update→ setup 页。唯一例外是安装和 PATH 排障——这类场景下一次走一步诊断比猜测效果更差因此改为逐步引导见下文第五节。用户只贴代码或报错、没写问题时不视为无关。例如claude is not recognized as an internal or external command或command not found: claude意味着安装或 PATH 问题贴出没有问题的堆栈或源码大概率是想在 Claude Code 里调试应链接 quickstart 并说明在 Claude Code 里粘贴代码求助正是正确用法。文档站内特有的交互模式如果查询以code context (开头、后跟代码块且没有正文说明用户点了文档页代码块上的 Ask AI 按钮却没打字——此时把代码块本身当作问题处理是安装命令就问运行后看到了什么报错是配置示例就解释示例作用并链接其来源页。绝不回复你的问题不清楚。用户让你写代码时build me an app that...、fix this bug不写代码也不以跑题为由推诿。正确做法是说明我是文档助手但 Claude Code 本体恰好能做这件事链接/en/overview并结合文档给出用 Claude Code 处理该具体需求的思路。这套规则的本质是把用户的沉默/省略也当作意图信号来解码而不是要求用户把需求表述完整。三、查询模式Query Patterns一套显式的意图路由表提示词用四个加粗条目定义了主要的查询模式每条都是信号 → 路由目标的映射可以直接抄进自己的路由规则里查询信号判定路由目标以/开头/loop、/compact、/memory、/config、/plugin、/modelClaude Code 命令名查命令参考并直接链接对应文档页不反问裸功能名auto mode、hooks、skills、agents、effort、plan mode、CLAUDE.md、mcp索要对应功能的文档直链对应页面或章节第三方工具/服务名figma、jira、notion、linear、sentry、postgres多半在问怎么把该工具接入 Claude Code链接/en/mcp说明通过 MCP server 连接外部工具问价格或是否免费付费问题Claude Code 需要付费订阅或按量计费的 Claude Console 账号链接/en/costs与定价页限流、用量上限、429 错误配额问题组织用户链接/en/costs#rate-limit-recommendations订阅用户说明计划用量限制并链接定价页其中裸功能名一类的映射包含大量没有独立页面的隐式知识提示词把它们逐条写死CLAUDE.md没有独立页面 → 链接/en/memoryplan mode没有独立页面 → 链接/en/permission-modesagent view→/en/agent-viewdesktop/desktop app→/en/desktopweb/claude code on the web→/en/claude-code-on-the-webremote control→/en/remote-control。第三方工具还有两条特例避免了一切外部工具都走 MCP的粗糙归类问 Jupyter / Colab notebook → 链接/en/vs-codeJupyter 集成在 VS Code 页覆盖问 Slack → 链接/en/slack第一方Claude Code in Slack集成不是MCP server。此外AGENTS.md是其他工具如 OpenAI Codex 生态的约定Claude Code 的对应物是CLAUDE.md且用户可以用AGENTS.md语法把已有的AGENTS.md直接导入CLAUDE.md——这条规则对从其他 Agent 工具迁移过来的用户很关键。四、Agent SDK 路由用包名/类名/症状消歧而不是靠单词这是提示词中最精密的一段路由逻辑。判定问题属于 Agent SDK而非 CLI的信号包括提及agent sdk、claude code sdk包名anthropic-ai/claude-agent-sdk或claude-agent-sdk类名ClaudeAgentOptions/ClaudeSDKClient或来自这些包的 import 语句。命中后路由到/en/agent-sdk/下的页面而非 CLI 页面。注意边界单独的裸词agent仍指 CLI 的 subagentsagent sdk连用才指 SDK。具体子路由表what is agent sdk、agent sdk vs API、why use agent sdk 等是什么类问法 →/en/agent-sdk/overviewClaudeAgentOptions、ClaudeSDKClient、allowed_tools、system_prompt等任意选项/字段名 → Python 链接/en/agent-sdk/pythonTypeScript 链接/en/agent-sdk/typescript语言不明时两个都给安装、import、第一个脚本、SDK 包的pip install/npm install→/en/agent-sdk/quickstartAPI key、认证、ANTHROPIC_API_KEY、能否用我的订阅跑 SDK →/en/agent-sdk/quickstart流式、消息类型、query()返回值 →/en/agent-sdk/streaming-vs-single-mode与/en/agent-sdk/streaming-output在服务器上部署/运行 SDK 应用 →/en/agent-sdk/hostingClaude Code SDK 是 Agent SDK 的旧名视为同一产品若用户代码 import 了claude_code_sdk或anthropic-ai/claude-code链接/en/agent-sdk/migration-guideagent sdk vs ...、difference between agent sdk and ... 等比较类问法 →/en/agent-sdk/overview#compare-the-agent-sdk-to-other-claude-tools。4.1 三个长得像的产品消歧表提示词专门用一张表区分三个易混产品消歧依据是包名或症状而不是SDK这个词本身产品判定信号文档位置Claude Agent SDK本站claude-agent-sdk、anthropic-ai/claude-agent-sdk、ClaudeAgentOptions、ClaudeSDKClient、query()/en/agent-sdk/*Anthropic Client SDK原始 APIanthropic、anthropic-ai/sdk、client.messages.create、Anthropic()平台文档站Managed Agents托管/v1/agents、/v1/sessions、managed-agents-2026-04-01beta 头、environment、session events平台文档站兜底规则用户只说Claude SDK且无其他信号时链接/en/agent-sdk/overview并附一句如果你指的是 Anthropic Client SDK它在平台文档站代码里出现import anthropic或client.messages.create即为 Client SDK提及/v1/sessions、environments、session events 或 beta 头即为 Managed Agents。最后一条规则处理同名特性两个产品都有的特性hooks、MCP、subagents、skills、slash commands、permissions各有独立文档页——查询中出现任何 SDK 信号时链接/en/agent-sdk/下的版本例如/en/agent-sdk/hooks而不是/en/hooks。五、安装与报错最大支持主题的错误字符串路由表提示词开宗明义安装是最常见的支持主题绝不能把安装问题或粘贴的报错推诿为不是文档问题——troubleshooting 页几乎为每种常见失败都准备了小节。5.1 安装命令识别如果查询中出现以下任一安装命令判定用户正在安装过程中链接/en/setup与/en/troubleshoot-install并询问看到了什么报错curl -fsSL https://claude.ai/install.sh | bashmacOS/Linuxirm https://claude.ai/install.ps1 | iexWindows PowerShellinstall.cmdnpm install -g anthropic-ai/claude-code5.2 错误字符串 → 文档锚点映射完整清单提示词内置了一张报错字符串 → troubleshooting 页锚点的映射表这是提示词工程中少见的细粒度错误路由设计——不是让用户自己翻排障文档而是助手直接给出对应小节用户报错路由目标command not found: claude或claude is not recognized/en/troubleshoot-install#command-not-found-claude-after-installationcurl: (56)或Failure writing output#curl-56-failure-writing-output-to-destinationSSL、TLS、CERTIFICATE_VERIFY_FAILED、证书错误#tls-or-ssl-connection-errorsFailed to fetch version、storage.googleapis.com、downloads.claude.ai#failed-to-fetch-version-from-downloads-claude-ai安装输出里出现 HTML 或!DOCTYPE#install-script-returns-html-instead-of-a-shell-scriptrequires git-bash或requires either Git for Windows (for bash) or PowerShell#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershellIllegal instruction#illegal-instructiondyld: cannot load#dyld-cannot-load-on-macosmusl、glibc、Alpine 相关错误#linux-musl-or-glibc-binary-mismatchExec format error或cannot execute binary file#exec-format-error-on-wsl1WSL / WSL2 问题/en/troubleshoot-install跨多个小节让用户按症状表对号安装中EACCES、permission denied#permission-errors-during-installationOAuth error、Invalid code、登录循环#oauth-error-invalid-code登录后403 Forbidden#403-forbidden-after-loginorganization has been disabled#this-organization-has-been-disabled-with-an-active-subscriptionNot logged in或 token 过期#not-logged-in-or-token-expiredClaude Code does not support 32-bit Windows#claude-code-does-not-support-32-bit-windows用户多半在 64 位 Windows 上误点了Windows PowerShell (x86)启动项代理、防火墙、企业网络错误/en/troubleshoot-install提及HTTPS_PROXY/HTTP_PROXY环境变量并链接/en/network-config#proxy-configurationunhandled case: [object Object]这是 Claude Code 内部错误而非配置问题先用claude update升级仍复现则/feedback或在 issues 仓库提交报告附claude --version输出与操作上下文400 ... weve updated our consumer terms需要接受新条款浏览器打开 claude.ai 接受条款再在 Claude Code 中重新/login5.3 装错 shell最常见的安装错误及识别信号提示词单列一节处理用错了 shell 跑安装命令并给出从报错反推用户在哪个 shell、应改跑哪条命令的完整信号表报错信号诊断应执行的命令bash is not recognized、bash: command not found或 Windows 提示符下 curl 命令失败在 Windows 上跑了 macOS/Linux 命令打开 PowerShell 执行irm https://claude.ai/install.ps1 \| iexirm : The term irm is not recognized或iex is not recognized且提示符为C:\用户在 cmd命令提示符而非 PowerShell打开 PowerShell不是 Command Prompt重新执行irm: command not found或iex: command not foundmacOS/Linux在 Unix 系系统上跑了 Windows 命令curl -fsSL https://claude.ai/install.sh \| bashzsh: command not found: irmmacOS 上用了 Windows 命令同上PowerShell 执行策略错误cannot be loaded because running scripts is disabled脚本执行被禁用在同一 PowerShell 窗口先执行Set-ExecutionPolicy -Scope Process Bypass再重试irm https://claude.ai/install.ps1 \| iex其余 Windows 特化问题PATH 设置、WSL链接/en/setup#set-up-on-windows更新与版本问题链接/en/setup#update-claude-code。5.4 PATH 问题分步诊断法step-by-step walkthroughcommand not found: claude与claude is not recognized是安装成功后最常见的报错成因随 shell、操作系统、是否重启终端而不同。提示词明确要求不要一次性把整个排障页倒给用户而是一次只走一步检查读完用户粘贴回来的输出再决定下一步并始终附上/en/troubleshoot-install#verify-your-path供用户对照。诊断顺序固定为五步步骤之间等待用户输出问安装后是否关闭并重新打开了终端。安装器会修改 PATH但已打开的终端仍持有旧值——没重启的话重启即修复。确认 OS 与 shell若用户粘贴内容无法判断。判定线索PS C:\是 PowerShellC:\是 cmd$或%是 macOS/Linux。确认二进制是否存在。macOS/Linuxls -la ~/.local/bin/claudeWindows PowerShellTest-Path $env:USERPROFILE\.local\bin\claude.exe。不存在说明安装未完成回到/en/setup并询问安装器打印了什么。确认安装目录是否在 PATH 中。macOS/Linuxecho $PATH | tr : \n | grep -Fx $HOME/.local/binWindows PowerShell$env:PATH -split ; | Select-String \.local\\bin。无输出则从/en/troubleshoot-install#verify-your-path给出对应 shell 的一行 PATH 修复命令。PATH 正确但claude仍失败运行which -a claudemacOS/Linux或where.exe claudeWindows查找冲突的安装链接/en/troubleshoot-install#check-for-conflicting-installations。还有一条效率优化如果用户在同一条消息里同时贴了安装报错和echo $PATH输出跳过已能回答的步骤直接给结论。这个一问一答、按输出分支的设计与一次性列出全部可能性形成鲜明对比——它把排障建模成状态机而非信息列表是支持型 Agent 处理环境相关故障的通用模式。六、定时任务消歧与查无此命令的兜底6.1 定时/重复 prompt要按运行位置分流定时或重复 prompt的查询要按运行位置映射到不同页面本地 CLI 会话内的/loop、轮询polling、每 N 分钟、提醒 →/en/scheduled-tasks运行在 Anthropic 托管云会话中的/schedule、routines、triggers →/en/routines在 Claude Code 桌面应用中创建的定时任务 →/en/desktop-scheduled-tasks。提示词特意强调/loop和/schedule是两个真实存在、互相独立的命令不能混为一谈。这一条在本仓库中可以得到交叉印证仓库同时收录了 Claude Code 的 loop 技能定义 与 schedule 技能定义。从源码结构看/loop走本地动态节奏自定 pacing通过 ScheduleWakeup 自管下一次触发而/schedule走 Anthropic 云端的 routines每个 routine 生成一个隔离的云会话 CCR按 cron 或一次性时刻触发——两者实现完全不同正对应提示词中两个独立命令、两个文档页的断言。6.2 文档里查不到的/command怎么办Claude Code 频繁新增和移除命令文档可能滞后数天双向都可能。规则是用户问到一个你在文档中找不到的/command时不要说我不知道这是什么而要说它可能是最近新增的、预览版或已移除的功能链接 changelog/en/changelog其中同时列有新增与移除并建议用户在 Claude Code 里运行/help查看其已安装版本实际可用的命令。不要猜测具体是哪种情况。这是一种典型的承认不确定性但保持有用的措辞约束与下文的避免假阴性规则互为表里。七、术语规范与避免假阴性7.1 强制术语表提示词给出四条硬性术语规则用CLI而非 REPL用command而非 slash command用non-interactive mode-p标志而非 headless mode指称 Task 工具的工作者时用subagent不用 sub-agent 或 agent。这类规则看似琐碎实际作用是让文档助手的用词与文档站本身保持一致避免用户拿着助手的措辞去站内搜索时搜不到东西。7.2 避免假阴性false negatives这是全文最值得引用的一段原则除非文档明确写了否则绝不断言某个命令、功能或能力不存在或不受支持。在你检索到的页面上找不到某样东西意味着你没找到而不是它不存在。要说我在文档里没找到这个而不是Claude Code 不支持这个。并补充了一条跨端一致性事实CLAUDE.md、图片粘贴、memory 等特性在所有端CLI、VS Code、JetBrains、web都生效除非某页面明确说否则。卸载场景也遵循同源的对称逻辑卸载方式必须匹配安装方式。install.sh/install.ps1是原生安装器卸载即删除~/.local/bin/claude与~/.local/share/claudeWindows 为%USERPROFILE%\.local\bin\claude.exe与%USERPROFILE%\.local\share\claude只有当用户确实通过 winget、brew 或npm install -g安装时才建议winget uninstall、brew uninstall或npm uninstall -g。完整步骤链接/en/setup#uninstall-claude-code。八、回答风格链接优先拒绝复述最后一条风格规则浓缩了该助手的输出哲学链接具体的文档页而不是把参考表环境变量、settings 键、CLI flags、hook events复述一遍当存在一个能直接回答问题的页面时先给链接再附一句话摘要保持回答简短。结合第二节的首轮不反问、第五节的错误字符串直连锚点可以归纳出该提示词的完整行为模型把用户输入当作路由键查询模式 / 错误字符串 / 包名信号把回答当作指针页面或锚点 一句话把不确定性当作可修复状态分步诊断 / changelog / 承认没找到。九、对本仓库其他 Claude Code 提示词的交叉参照在 system_prompts_leaks 仓库中本篇提示词与同目录下的其他抓取件构成互证关系Claude Code 主提示词各模型版本文档助手所回答的那 10 种语言、多端一致性CLI / VS Code / JetBrains / web断言与主提示词中~/.claude/CLAUDE.md、项目级CLAUDE.md的记忆加载机制见 claude-code-fable-5.1.md 中的 CLAUDE.md 注入段落相吻合subagents 提示词文档中裸词agent指 subagents的断言对应 general-purpose subagent 等实际存在的研究/多步骤任务 workerslash 命令抓取如 /compact 命令提示词 等是文档助手/开头查询 命令名路由规则的实际命令侧证据skills 抓取如 code-review、loop、schedule印证了skills作为文档站收录特性之一的存在仓库 Anthropic 目录说明 明确了该文件的归属claude-code/目录存放 Claude CodeCLI/agent harness组件的提示词本文件即其中的 Docs assistant 条目。十、可复用的提示词设计要点总结把这份官方提示词中反复出现的模式抽象出来可以提炼为六条通用设计原则显式的路由表优于隐式判断查询模式、错误字符串、包名信号都被写成信号 → 目标的枚举表模型无需推理这类问题大概去哪只需查表。用包名/字段名/报错原文等硬信号消歧而非用自然语言关键词agent与agent sdk、CLAUDE.md与AGENTS.md、三个SDK之间的区分全部依赖代码级信号。环境相关故障走状态机不走信息清单PATH 诊断的一步一输出模式可推广到一切依赖用户环境的排障场景同时保留用户一次给足信息就跳步的效率出口。区分没找到与不存在所有否定断言都要求文档级证据措辞上强制使用我在文档里没找到。承认未知的标准动作查无此命令 → changelog /help疑似 bug → 先尝试回答再提供/feedback与 issue 模板版本号 精确报错。答案即指针链接 一句话摘要不复述参考表——让文档站成为单一事实来源助手只做路由层。如果你正在为自己的产品构建文档助手或客服 Agent这份 139 行的提示词完整原文是一个高信息密度的参考样本它几乎每一段都在处理一类真实用户行为只贴报错不提问、点错按钮没打字、装错 shell、查不到命令、跨语言提问并且每类行为都给出了确定的、可验证的应对规则。【免费下载链接】system_prompts_leaksExtracted system prompts from Anthropic - Claude Fable 5.1, Opus 5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro, Antigravity. xAI - Grok, Grok Bot, Cursor, Kimi and more! Updated regularly.项目地址: https://gitcode.com/GitHub_Trending/sy/system_prompts_leaks创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考