FAQ 大全
FAQ 大全
Section titled “FAQ 大全”把大家最常问的问题拣成一份清单，分八大类。每个问题给一句话能看懂的答案。命令与参数以官方 docs.claude.com 文档为准，社区经验标注来源。
1. Claude Code 装哪去？
macOS / Linux / WSL 用 curl -fsSL https://claude.ai/install.sh | bash，Windows 用 irm https://claude.ai/install.ps1 | iex。也支持 npm i -g @anthropic-ai/claude-code（需 Node 18+）。
2. 怎么检查装好了没？
跑 claude doctor，体检安装、版本、配置、网络。绿色就绪，红色有指引。
3. 怎么看当前版本？
claude -v 或 claude --version，交互模式里 /status 也显示。
4. 怎么更新？
claude update 更到最新。claude install stable 上稳定版，claude install latest 上最新版，也可指定版本号。
5. 升级后出问题怎么回退？
claude install <旧版本号> 装回旧版，或 claude install stable 回稳定通道。
6. 装完启动报「command not found」？
PATH 没生效。重开终端，或手动 source ~/.zshrc / source ~/.bashrc。npm 全局装的看 npm config get prefix 是否在 PATH 里。
7. 网络不通怎么办？
检查代理：设 HTTPS_PROXY 环境变量。企业网络走 LLM 网关时配 ANTHROPIC_BASE_URL。
8. 能离线用吗？ 不能。Claude Code 依赖云端模型，需要联网。可配合 Bedrock / Vertex 用企业出口。
9. 怎么换 API key？
claude 启动会引导登录。或设 ANTHROPIC_API_KEY 环境变量。多账号用 --api-key 指定。
10. 支持哪些操作系统？ macOS、Linux、WSL 原生支持。Windows 推荐 WSL 或 Git Bash。
11. Node 版本不够怎么办？ 升到 18+，或改用原生安装脚本（不依赖 Node）。
12. 怎么指定数据目录？
设 CLAUDE_CONFIG_DIR 环境变量，默认 ~/.claude。
13. 配置文件在哪？
项目级 .claude/settings.json，用户级 ~/.claude/settings.json，企业级 managed-settings.json。
14. 怎么初始化项目配置？
在项目根目录跑 claude，用 /init 生成 CLAUDE.md 草稿。
15. IDE 插件怎么装？ VS Code / JetBrains 在扩展市场搜 Claude Code。装完在 IDE 内唤起，和终端共享配置。
16. 怎么启动一次会话？
cd 到项目根目录，敲 claude。
17. 怎么引用文件？
输入框打 @ 会自动补全文件路径。@src/api.ts 把文件喂进上下文。
18. 怎么让它只读不改？
切到 Plan 模式（Shift+Tab），它只出方案不动手。或用 --permission-mode plan。
19. 怎么打断它？
按 Esc 立即停。连按两次 Esc Esc 触发 /rewind 回退。
20. 怎么撤销刚才的改动？
/rewind 回退到上一个检查点，对话和代码都能退。
21. 怎么清空对话历史？
/clear 彻底清空，最省 token。/compact 压缩保留要点。
22. 怎么换模型？
/model sonnet / /model opus / /model haiku，或 /model 看列表。
23. 怎么跑一次性查询？
claude -p "你的问题"，print 模式跑完即退，适合脚本。
24. 怎么接着上次聊？
claude -c 续最近会话，claude -r <name> 恢复命名会话。
25. 怎么让它跑命令但不让我确认？
切到 auto-accept 模式（Shift+Tab），或用 --dangerously-skip-permissions（慎用）。
26. 怎么给它传 stdin？
echo "text" | claude -p "总结"，管道喂进去。
27. 怎么导出对话？
headless 模式 claude -p ... > out.md 重定向到文件。
28. 怎么看花了多少 token？
/cost 看当前会话用量，/status 看全局信息。
29. 它能上网吗？ 能。Claude Code 可以用 WebFetch 之类的工具抓 URL，也可装搜索类 MCP。
30. 怎么让它记住项目约定？
写进 CLAUDE.md，每次会话自动加载。临时记忆用 # 开头写入。
31. 怎么同时改多个文件？
直接说要改哪些，它会用 Edit/Write 逐个改。或用 /batch 批量同类操作。
32. 怎么让它跑测试？ 直接说「跑 npm test」，它会用 Bash 工具执行并读结果。
33. 输出太长截断了怎么办？
让它分文件输出，或 claude -p ... > file.md 重定向到文件再读。
34. 怎么固定它的回答风格？ CLAUDE.md 里写明风格规范，或做成 Skill 按需加载。
35. 怎么让它用中文回答？ CLAUDE.md 里写「用中文回答」，或对话里直接说「请用中文」。
36. 子代理是什么？ 独立上下文的外聘顾问，主代理委托任务给它，它干完只回摘要，不污染主会话。
37. 怎么定义自己的子代理？
在 .claude/agents/ 或 ~/.claude/agents/ 放 <name>.md，含 frontmatter（name/description/tools）+ system prompt。
38. 子代理能再生子代理吗？ 不能。Claude Code 限制子代理不能再调用 Task 工具，避免无限递归。
39. Skill 和 Command 区别？
Command 你主动 /xxx 触发；Skill 是 Claude 看情况自己判断要不要用，渐进式披露。
40. 怎么写一个 Skill？
在 .claude/skills/<name>/SKILL.md，frontmatter 含 name + description，正文写指令。放对位置自动发现。
41. 怎么让 Skill 不自动触发？
frontmatter 加 disable-model-invocation: true，只能 /name 显式调。
42. Hooks 是什么？ 工具调用生命周期的钩子，能在工具执行前/后插脚本，比如保存后自动格式化。
43. Hook 怎么阻止危险操作？
脚本 exit 2 会拦下工具调用并把反馈给 Claude。
44. Plan 模式和默认模式区别？
Plan 模式只读只规划不改文件；默认模式会执行。Shift+Tab 切换。
45. 怎么让审查员子代理不能改代码？
tools: Read, Grep, Glob，只给读权限。
46. 上下文窗口多大？
200K token。但 45% 左右注意力开始衰退，及时 /compact。
47. 怎么并行跑多个子代理？ 代码审查流水线：风格、安全、测试三子代理同时跑，主代理汇总。审查并行、执行串行。
48. MCP 是什么？ Model Context Protocol，让 Claude 连外部工具（数据库、GitHub、Slack）的标准协议。
49. 怎么加一个 MCP？
claude mcp add <name> -- <command>，或在仓库根放 .mcp.json 团队共享。
50. 怎么看已装哪些 MCP？
claude mcp list，交互模式 /mcp 也行。
51. 怎么让 Claude 跑完后通知我？
配 Stop hook 调系统通知命令（macOS 用 osascript）。
52. 怎么固化团队提交规范？
写成 commit-messages Skill，Claude 生成 commit 时自动套规范。
53. statusLine 是什么？
自定义状态栏，在 .claude/settings.json 配 statusLine 脚本，显示分支、用量等。
54. 怎么跨步骤共享上下文？
headless 模式用 --resume <session-id> 续跑，CI 各步骤接力。
55. 怎么输出结构化结果？
--output-format json 让结果机器可读，便于下游脚本处理。
56. 团队配置怎么共享？
.claude/ 目录、.mcp.json、CLAUDE.md 进 git，人人 clone 即一致。
57. 个人偏好放哪？
.claude/settings.local.json，默认在 .gitignore，不进仓库。
58. 企业怎么锁定权限？
managed-settings.json 推企业级 permissions.deny，员工改不了。
59. 怎么统一审查标准？
把审查清单写成 code-review-standards Skill 团队共享，新人也按老规矩审。
60. 怎么禁止改生产配置？
permissions.deny 加 Edit(./prod.env)，或 PreToolUse hook 拦截。
61. 怎么在 CI 里跑审查？
GitHub Actions 里 gh pr diff | claude -p "审查"，PR 一开自动跑。
62. 怎么统一 commit 风格？ CLAUDE.md 写规范 + 配 PreToolUse hook 在 commit 前校验。
63. 怎么让新人快速上手？
CLAUDE.md 写项目结构、依赖、测试命令，新人 clone 后 /init 补全。
64. 怎么管理多账号？
不同项目用不同 API key，设 ANTHROPIC_API_KEY 或 --api-key 切换。
65. 怎么审计团队用量？
企业版有监控面板；自建可让 PostToolUse hook 记日志到 .claude/tool.log。
66. 怎么禁用某个工具？
permissions.deny: ["Bash(rm:*)"] 禁掉危险命令。
67. 团队成员能力参差怎么办？
把高阶流程封装成 Skill / Command，新人敲 /ship 就走完整流程。
68. 怎么共享子代理？
.claude/agents/ 进 git，团队共用一套外聘顾问。
69. 怎么统一 MCP 配置？
.mcp.json 进 git，团队 MCP 一致；个人加的放 ~/.claude/。
70. 怎么做代码审查流水线？ 风格、安全、测试三子代理并行审，主代理汇总——参考 Subagents 深入。
71. 怎么看花了多少？
/cost 看当前会话 token 用量。
72. 怎么省钱？
日常用 sonnet 不用 opus；/clear 比续聊省；重活外包子代理；规则写 Skill 不塞 CLAUDE.md。
73. 上下文越聊越贵吗？
是。每轮把历史带上，token 线性涨。/compact 压缩、/clear 清空能省。
74. 子代理省钱吗？ 省。子代理在独立上下文跑，只回摘要给主代理，主会话 token 增长少。
75. headless 模式省钱吗？ 省交互往返的 token，跑完即退不留会话。
76. CLAUDE.md 写长会贵吗？ 会。它每次全量进上下文。写长了费钱，规则多就拆成 Skill。
77. 怎么按模型计费？ opus 最贵、sonnet 中等、haiku 最便宜。日常 sonnet，难题 opus。
78. API 计费和订阅区别？ 订阅（Pro/Max）按月固定额度；API 按 token 付费。Claude Code 两种都支持。
79. 怎么设成本上限？ API 后台设 spend limit；订阅用满会限速。企业版可配网关做配额。
80. 训练数据会上传吗？ 不会用于训练。企业版和 Trust Center 有数据使用政策，详见官方文档。
81. 我的代码会被训练吗？ 不会。Anthropic 不用 Claude Code 的输入输出训练模型，详见 Trust Center。
82. 数据存哪？ 按账号区域存储，企业版可选区域。详见 Anthropic Trust Center。
83. 怎么不让它碰密钥？
.gitignore 密钥文件 + permissions.deny 禁 Claude 访问 + 别写进 CLAUDE.md。
84. 沙箱怎么开？
/sandbox 启用沙箱模式，或用 devcontainer / Docker 隔离。
85. 怎么防误删文件？
permissions.deny: ["Bash(rm -rf:*)"]，或 PreToolUse hook 拦截 rm -rf /。
86. 子代理会乱跑吗？
tools 字段限权。审查员只给读，执行代理才给 Edit/Bash。最小权限原则。
87. 怎么审计它做了什么？
PostToolUse hook 记日志；/rewind 能回看每步；.claude/tool.log 留痕。
88. MCP 服务器安全吗？
官方推荐的安全，第三方自辨。只装可信来源，tools 限权。
89. 企业数据合规？ 企业版支持 Bedrock / Vertex，数据不出企业网络。Trust Center 有合规认证。
90. 怎么彻底卸载？
删 ~/.claude 目录 + 卸载二进制。会话历史也在 ~/.claude。
MCP 与集成
Section titled “MCP 与集成”91. 怎么加 GitHub MCP？
claude mcp add github -- npx -y @modelcontextprotocol/server-github。
92. 怎么加数据库 MCP？
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres "postgresql://localhost/mydb"。
93. .mcp.json 放哪？
仓库根目录，团队共享。格式 {"mcpServers": {...}}。
94. MCP 怎么连 IDE？ Claude Code 的 MCP 配置和 IDE 插件共享，装一处即可。
95. 怎么调试 MCP？
claude mcp get <name> 看详情，claude mcp list 看状态。
96. MCP 能连 Slack 吗？ 能。装 slack MCP 后 Claude 能搜消息、发通知。
97. 怎么用 MCP 抓网页？ 装 puppeteer 或 playwright MCP，Claude 能开浏览器截图、点击。
98. MCP 多了会卡吗？
启动时扫描，连接多会慢。不用的 claude mcp remove 掉。
99. 怎么让 MCP 在所有项目可用？
加 --scope user（用户级），存到 ~/.claude/。
100. MCP 工具要权限吗？ 要。首次调用会问授权，可在 permissions 配置白名单免确认。
101. 怎么用 MCP 操作文件系统？
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path，限定可访问目录。
102. 能连 Notion 吗？ 能。Notion MCP 让 Claude 读写页面，适合文档自动化。
103. MCP 和 Hooks 区别？ MCP 是连外部服务的数据通道；Hooks 是工具调用生命周期的脚本钩子。
104. 怎么列出某 MCP 提供的工具？
claude mcp get <name> 看详情，或交互模式 /mcp。
105. MCP 断了怎么办？
claude mcp list 看状态，重启 MCP 进程或重连。
Hooks 与 Skills
Section titled “Hooks 与 Skills”106. Hook 配在哪？
.claude/settings.json 的 hooks 字段，按事件（PreToolUse/PostToolUse/SessionStart/Stop）组织。
107. Hook 的 matcher 怎么写？
正则匹配工具名。Edit|Write 匹配编辑类，Bash 匹配命令，.* 匹配全部。
108. Hook 怎么阻止操作？
脚本 exit 2 拦下并把 stderr 反馈给 Claude；exit 0 放行。
109. Hook 能拿到什么环境变量？
$CLAUDE_TOOL_NAME、$CLAUDE_TOOL_INPUT、$CLAUDE_FILE_PATHS 等，看官方文档字段表。
110. 怎么保存后自动格式化？
PostToolUse hook，matcher Edit|Write，跑 npx prettier --write $CLAUDE_FILE_PATHS。
111. Skill 放哪？
.claude/skills/<name>/SKILL.md（项目级）或 ~/.claude/skills/<name>/SKILL.md（用户级）。
112. Skill 必填字段？
name 和 description。description 决定 Claude 何时自动触发它。
113. Skill 怎么带脚本？
SKILL.md 同目录放 scripts/、templates/，正文里引用，Claude 按需读。
114. 怎么强制只显式调用 Skill？
frontmatter 加 disable-model-invocation: true，只能 /name 调。
115. 内置 Skill 有哪些？
/simplify、/debug、/loop、/batch、/claude-api 等，开箱即用。
116. Skill 和 CLAUDE.md 怎么分工？ 每次都要遵守的规矩进 CLAUDE.md；特定场景才用的能力写成 Skill 按需加载。
117. 怎么让 Skill 限制工具？
frontmatter 加 allowed-tools: Read, Grep, Glob，审查类只读。
118. Hook 和 Skill 区别？ Hook 是硬编码脚本（确定性）；Skill 是模型按指令走（柔性）。要绝对发生用 Hook，要按情况用 Skill。
119. 怎么调试 Hook？
手动跑 hook 脚本看输出；exit 2 时 stderr 会显示给 Claude。
120. Skill 能在子代理里跑吗？ 能。复杂 Skill 可把重活外包给子代理，主会话保持清爽。
来源：本 FAQ 综合官方
docs.claude.com的 troubleshooting、common-workflows、best-practices 页，以及社区踩坑整理（best-practice 仓库等）。具体命令以官方文档为准。要查完整示例看 代码示例库，要查技巧看 技巧集。🚀