Claude Code 用户常见问题解答

问题

答案

1.1 我如何安装它？

macOS/Linux: curl -fsSL https://claude.ai/install.sh | bash
​Windows PowerShell: irm https://claude.ai/install.ps1 | iex
​Homebrew: brew install --cask claude-code
​WinGet: winget install Anthropic.ClaudeCode
然后从任何仓库运行 claude。

参考：快速开始

1.2 已安装，但显示"claude: command not found"

原生安装程序将二进制文件放在 ~/.local/bin/claude（Windows：%USERPROFILE%\.local\bin）。将该目录添加到您的 PATH，例如在 ~/.zshrc 或 ~/.bashrc 中运行 export PATH="$PATH:$HOME/.local/bin"，然后重启终端。

参考：故障排除：PATH

1.3 登录在错误的机器上打开浏览器 / 我在 SSH 上

在登录提示符处按 c 复制认证 URL。在本地浏览器中打开它，然后将代码粘贴回终端。

参考：故障排除：认证

1.4 登录后立即出现认证错误，但我有访问权限

400"组织已禁用"：一个杂散的 ANTHROPIC_API_KEY 环境变量正在覆盖您的登录。取消设置它，从 shell 配置文件中删除，然后重启。运行 /status 确认哪个认证处于活动状态。
​403 禁止访问：您的管理员尚未为您的工作区启用 Claude Code，或公司代理正在干扰。

参考：故障排除：认证

1.5 Claude Code 包含在我的计划中吗？

是的。它包含在 Team 和 Enterprise 席位以及 Console（API）访问中。使用您的工作账户登录；SSO 会自动处理。登录后的 403 通常意味着您的管理员仍需为工作区启用它。

参考：认证

1.6 Claude Code vs. 桌面应用 vs. claude.ai？

Claude Code：终端代理，读取您的仓库、编辑文件、运行命令。
​桌面 / claude.ai：用于对话和一次性问题的聊天界面。
底层使用相同的模型系列，工具形式不同。

参考：概述

1.7 它在我的 IDE 中工作吗？

是的。VS Code 和 JetBrains IDE（IntelliJ、PyCharm 等）都有扩展。功能相同，嵌入在编辑器中而不是单独的终端。

参考：VS Code · JetBrains

1.8 这与 Copilot/Cursor 自动完成有什么不同？

自动完成建议接下来的几行。Claude Code 是一个代理：给它一个任务（"修复失败的测试"），它会读取文件、运行命令并进行多文件编辑直到完成。不是"完成我的句子"，而是"这是一个问题，去处理它"。

参考：概述

1.9 我应该先尝试什么？

指向一个您一直在推迟的繁琐但不难的 bug。例如：

参考：常见用例

1.10 我如何更新它？

原生安装在后台自动更新。要立即强制更新，运行 claude update。
Homebrew/WinGet 不会自动更新：定期运行 brew upgrade claude-code 或 winget upgrade Anthropic.ClaudeCode。

参考：设置：更新

问题

答案

2.1 它一直要求对相同命令的权限

默认情况下，批准仅在当前会话期间有效。要使其持久化：
• 在提示符处选择"始终允许"
• 将模式添加到 .claude/settings.json 中的 permissions.allow
• 或运行 /permissions 以交互方式管理

参考：权限

2.2 权限模式及如何切换

按 Shift+Tab 循环切换模式：

参考：权限模式

2.3 /init 是什么，我何时运行它？

在任何你会多次使用的仓库中，早期运行一次。它会扫描项目并写入 CLAUDE.md，包含构建命令、架构和约定。每个后续会话都会自动加载它，所以 Claude 开始时已有上下文。

参考：内存和 CLAUDE.md

2.4 CLAUDE.md 中应该包含什么？

工具无法强制执行的内容，新队友第一天会出错的东西："从 release 部署，不从 main 部署"、"所有 ID 都是字符串"、"永远不要从路由处理程序直接调用数据库"。保持在两屏以内；更长的内容会被跳过。

参考：内存和 CLAUDE.md

2.5 Claude 没有遵循我的 CLAUDE.md

• 太长或太模糊：精简到真正重要的规则
• 埋在散文中：把硬规则放在顶部，使用祈使语言（"永远不要 X。总是 Y。"）

参考：最佳实践

2.6 指向特定文件而不粘贴它

输入 @ 然后是路径（制表符自动完成）。提及的文件在 Claude 响应前被读取。

参考：常见工作流

2.7 将截图粘贴到提示中

将图像拖入终端，或按 Ctrl+V。在 Mac 上是 Ctrl，不是 Cmd（Cmd+V 粘贴文本）。适用于错误对话框、UI 模型、白板照片。

参考：使用图像

2.8 从终端复制 Claude 的响应

/copy 将最后的响应放在你的剪贴板上。/export 将整个对话写入文件。

2.9 恢复之前的会话

claude --continue 恢复最近的一个。claude --resume 打开列表供选择。会话按项目目录本地存储。

参考：常见工作流：恢复

2.10 切换模型

/model 打开选择器。如果你想每个会话都使用相同的模型，在 .claude/settings.json 中设置默认值。

参考：模型配置

2.11 扩展思考

默认启用。推理本身在正常视图中隐藏；按 Ctrl+O 切换到详细记录（如果你想阅读）。使用 /effort 调整深度。对于棘手的调试或架构决策值得额外延迟。

参考：扩展思考

2.12 在任务中途停止它

按 Ctrl+C 取消当前生成，然后告诉它改为做什么。无需重新开始对话。

问题

答案

3.1 MCP 是什么？

MCP 将 Claude Code 连接到你的外部工具：GitHub、Linear、Slack、你的数据库、你的可观测性堆栈。一个 .mcp.json 配置，Claude 就可以读取你的问题、查询你的数据，并使用与你相同的工具。常见的第一个连接器：你的问题跟踪器。

参考：MCP

3.2 连接你的第一个 MCP 服务器

• 在项目根目录添加 .mcp.json，或使用 claude mcp add
• 每个条目命名一个服务器包加上任何环境变量（通常是认证令牌）
• 重启 Claude Code 并运行 /mcp 确认已连接

参考：MCP 设置

3.3 钩子有什么用？

在事件上触发的 Shell 脚本（工具运行前、文件编辑后、Claude 等待你时）。常见的第一个钩子：一个通知钩子，在 Claude 需要输入时 ping 你的桌面。相同的机制可以在每次编辑后运行你的 linter、发布到 Slack，或阻止对受保护路径的编辑。

参考：钩子指南

3.4 制作可重用的提示 / 技能

创建 .claude/skills/ship/SKILL.md，文件夹名称变成命令：/ship。纯英文，无特殊语法。最简单的方法：让 Claude 为你写。（旧版 .claude/commands/ship.md 路径仍然有效。）

参考：技能

3.5 技能 vs. 旧版命令

相同的机制；命令已合并到技能中。.claude/commands/foo.md 和 .claude/skills/foo/SKILL.md 都创建 /foo。技能形式是首选的，并为你提供一个支持文件的文件夹（参考文档、模板、辅助脚本）。

参考：技能

3.6 子代理有什么用？

并行工作：搜索代码库的不同部分、沿着不同维度审查差异，或同时生成竞争实现。主会话聚合结果。

参考：子代理

3.7 非交互式运行 (CI / 脚本)

claude -p "your prompt" 运行一次并打印结果。适用于 CI 钩子、预提交检查或管道传输到其他工具。通过已登录会话或 ANTHROPIC_API_KEY 进行身份验证。

参考：Unix 风格用法

3.8 撤销其操作

/rewind 回滚到较早的检查点。每次发送提示时都会自动创建检查点。对于已提交的任何内容，请使用常规 git revert。

参考：检查点

3.9 与团队共享您的设置

将 .claude/ 检入仓库（CLAUDE.md、命令、MCP 配置）。任何克隆仓库的人都会自动获得相同的设置。技能也可以打包为团队通过 /plugin 安装的 插件。

参考：插件

问题

答案

4.1 找不到文件 / 搜索返回空结果

Claude Code 附带了 ripgrep 的捆绑副本，因此您无需安装它。捆绑的二进制文件在 Alpine/musl 系统上可能会失败；在这种情况下，安装系统副本（apk add ripgrep）并设置 USE_BUILTIN_RIPGREP=0 以便 Claude 使用它。

参考：故障排除：搜索

4.2 通过 SSH 或在 tmux 中复制/粘贴和滚动损坏

终端 UI 捕获鼠标事件。选择时按住 Shift 以绕过它，或配置 tmux 以传递鼠标事件。/copy 和 /export 完全规避了这个问题。

4.3 WSL 上速度缓慢

通过 /mnt/c/ 读取 Windows 文件是已知的性能损失。将仓库移到 WSL 文件系统（~/ 而不是 /mnt/c/...）。速度差异很明显。

参考：故障排除：WSL

4.4 Mac 上的图像粘贴不起作用

使用 Ctrl+V，而不是 Cmd+V。Cmd+V 粘贴文本；Ctrl+V 是从剪贴板粘贴图像的方式。

4.5 通配符权限规则不匹配

逐步构建规则：首先以交互方式批准命令，检查写入设置的内容，然后进行泛化。

参考：权限模式

4.6 非交互式 -p 模式行为不同

对于非交互式/CI 运行，优先使用 API 密钥身份验证和配置了环境变量令牌的 MCP 服务器。

4.7 任务中途上下文用尽

/compact 总结早期对话以释放空间。/clear 在保持 CLAUDE.md 和设置加载的情况下重新开始。对于长任务，使用 /clear 在各阶段之间分解步骤。

参考：管理上下文

问题

答案

5.1 Anthropic 会在我的代码上进行训练吗？

不会。根据您组织的团队/企业条款，您的代码和对话不用于训练模型。

参考：数据使用

5.2 我的代码实际上去了哪里？

Claude Code 在您的机器上运行。源文件在本地读取，只有当前任务所需的部分才会发送到 API 以生成响应。没有任何内容被索引、作为整个仓库上传或用于训练。

参考：数据使用

5.3 其他人可以看到我的对话吗？

不会。会话存储在您机器上的本地，按项目目录存储，不与队友共享或在任何仪表板中可见。如果您 想 共享对话，请使用 /export。

参考：数据使用

5.4 我如何将秘密和 .env 文件排除在对话之外？

Claude 只读取任务所需的文件；它不会扫描您的整个仓库。要硬阻止特定文件，请在 .claude/settings.json 中添加读取拒绝规则（例如 "Read(.env*)"）。即使您不小心要求，被拒绝的文件也无法读取。

参考：权限

5.5 "acceptEdits" 模式在不询问我的情况下可以做什么？

文件编辑无需提示即可进行。在运行 shell 命令、进行网络调用或触及工作目录外的任何内容之前，它仍会询问。为了更严格的控制，请保持默认模式。

参考：权限

资源

用途

/help

内置命令，列出您会话中可用的功能

/feedback

从终端提交问题（/bug 的别名）

完整文档

此处的所有内容，详细说明

您团队的 #claude-code 频道

小成功和奇怪的错误都可以在那里讨论

页面

链接

快速入门

code.claude.com/docs/en/quickstart

故障排除

code.claude.com/docs/en/troubleshooting

权限

code.claude.com/docs/en/permissions

内存和 CLAUDE.md

code.claude.com/docs/en/memory

MCP

code.claude.com/docs/en/mcp

数据使用

code.claude.com/docs/en/data-usage