排错、术语表
与进一步学习

常见问题与翻车点

安装问题

macOS：无法打开应用

症状：双击 dmg 拖入 Applications 后，启动提示"无法打开"。

解决：

系统设置 → 隐私与安全性 → 安全性
→ 找到"Claude 仍要打开" → 点击

macOS：提示"已损坏"

症状：启动时提示"Claude 已损坏，无法打开"。

解决：

# 在终端执行
xattr -cr /Applications/Claude.app

或者：

系统设置 → 隐私与安全性
→ 完全磁盘访问权限 → 添加 Claude

Windows：MSIX 安装失败

症状：双击 Claude.msix 提示"无法安装"。

解决：

# 管理员 PowerShell
Add-AppxPackage -Path "C:\path\to\Claude.msix"

或者检查：

• 是否启用了 Virtual Machine Platform（Cowork 需要）
• AppLocker 是否阻止了 MSIX
• 是否有遗留版本未卸载

Linux：怎么办

症状：找不到 Linux 版。

解决：见 系统要求 → 关于 Linux：

• 网页版（推荐）
• ChromeOS 版
• iOS / Android 客户端

登录问题

收不到验证邮件

收不到 SMS 验证码

1. 确认手机号正确（含 +86）
2. 等待 1-2 分钟（短信有延迟）
3. 重发（最多 5 次/小时）
4. 仍不行 → 改用 Google 一键登录

提示"账号已存在"

登录后白屏

症状：登录成功但主界面是白屏。

解决：

忘记两步验证恢复码

解决：

1. 联系 Anthropic 支持
2. 提供账号信息证明（注册邮箱、历史对话标题、付款记录等）
3. 等待人工审核（可能需要 1-3 天）

对话问题

Claude 答非所问

flowchart TD
    A[答非所问] --> B{够上下文?}
    B -->|否| C[补充再问]
    B -->|是| D{太宽泛?}
    D -->|是| E[拆细]
    D -->|否| F{模型问题?}
    F -->|可能| G[Retry]
    F -->|反复| H[换强模型]

图 7-1 展示“答非所问”时的排查顺序：先补上下文，再收窄问题范围，最后再考虑重试或切换模型。

Claude "忘记" 早期对话

原因：上下文窗口满了。

解决：

• 详见 对话管理 → 上下文长度管理
• 用 Project 续接

上下文已满

症状：Claude 报"上下文窗口已满"或"对话太长"。

解决：

flowchart LR
    A[上下文已满] --> B{还重要?}
    B -->|是| C[导出 + 新建]
    B -->|否| D[直接新建]

图 7-4 展示当对话上下文过长时，应该在“导出后新建”与“直接新建”之间如何取舍。

重新生成结果一样

症状：点 Retry 后输出几乎一致。

原因：模型有一定随机性，但有时确实"卡住"了。

解决：

1. 改写用户消息（用 Edit）
2. 换模型
3. 在问题里加"请换个角度"
4. 明确"不要重复之前的回答"

中文支持

症状：Claude 答英文。

解决：

1. 消息里加 "用中文回答"
2. Settings → Profile → Preferred Language → 中文
3. Style 描述里加 "始终用中文"

Artifact 问题

Artifact 没出现

症状：长代码 / 长文档没成为 Artifact。

解决：

1. 明确说 "做成 Artifact" 或 "独立成一个文档"
2. 内容要够长（通常超过 ~300 字）
3. 必须是结构化内容（代码、文档、SVG）

Artifact 不能编辑

症状：Edit 按钮灰着。

原因：可能是只读类型（某些 HTML 类型）。

解决：

1. 让 Claude 重新生成一个可编辑版本
2. 或者下载源代码到本地编辑

发布链接无效

症状：分享的链接 404。

解决：

1. 重新发布（Artifact → Publish）
2. 检查是否被设为 Private
3. 联系支持（如果反复失败）

Project 问题

知识库不检索

症状：上传了文件，Claude 答"我不知道"。

解决：

1. 确认文件状态为 "Ready"（不是 "Processing"）
2. 在自定义指令中明确"用知识库回答"
3. 关键问题直接引用文件名
4. 重启 Project 对话

Project 知识库配额已满

症状：上传文件时提示配额已满。

解决：

1. 删除不用的文件
2. 合并相似文件
3. 检查当前账号的可用容量与官方限制说明
4. 拆分 Project

自定义指令不生效

症状：设了指令，Claude 不遵守。

解决：

1. 检查指令是否保存成功
2. 指令放在 Project Settings，不在 Style
3. 指令要具体（避免空泛）
4. 在对话里明确"按我项目指令的要求"

Cowork 问题

Cowork 拒绝执行

症状：Cowork 说"无法执行"。

原因：

Cowork 卡住

解决：

1. 取消任务（Stop 按钮）
2. 检查 Cowork 日志
3. 简化任务重试
4. 反馈给 Anthropic

Claude Code 问题

Claude Code 看不到代码

症状：让 Claude 看 main.py 它说找不到。

解决：

1. 确认工作目录正确
2. 检查权限（File Read 必须允许）
3. 文件名写完整路径
4. 试着用 `ls` 命令确认

Claude Code 改动太大

症状：让 Claude 改一行，它改了 50 行。

解决：

flowchart LR
    A[改动过大] --> B[撤销]
    B --> C[用 Edit]
    C --> D[明确范围]
    D --> E[重做]

图 7-5 展示 Claude Code 改动范围失控时的修正路径：先撤回，再缩小范围，最后重新执行。

Claude Code 提 PR 失败

性能问题

启动慢

症状：点开 Claude Desktop 要等 10-30 秒。

解决：

1. 检查网络
2. 关闭其它占用内存的应用
3. 重启电脑
4. 升级到 SSD
5. 升级内存到 16GB+

响应慢

占用内存大

症状：Claude Desktop 占用 > 1GB 内存。

解决：

flowchart LR
    A[占用大] --> B[关多余窗口]
    A --> C[归档旧对话]
    A --> D[清缓存]
    A --> E[升级内存]

图 7-6 展示桌面端内存占用过高时的常见缓解手段，从关闭窗口到归档内容再到硬件升级。

账单与账号问题

升级或变更后权限没更新

1. 退出桌面端并重新登录
2. 检查账户页或原购买渠道中的当前状态
3. 核对是否仍在生效时间切换窗口内
4. 仍异常时，带上订单号与脱敏截图联系官方支持

取消续费后仍有扣款记录

1. 先核对是否是上一个计费周期的正常续费或税费补扣
2. 在原购买渠道查看订单时间线
3. 保留取消记录、订单号和扣款时间
4. 带上这些信息联系官方支持

移动端问题

iOS 推送不到

1. 检查 iOS 系统设置 → 通知 → Claude → 允许
2. 退出重新登录
3. 重装 App

Android 移动数据不能用

1. 检查 Android 权限 → 移动数据
2. 关省电模式
3. 切 Wi-Fi 试试

跨设备同步问题

一台设备看不到对话

1. 退出重新登录
2. 检查网络
3. 等待 1-2 分钟（同步有延迟）
4. 仍不行 → 联系客服

同步到一半卡住

1. 断网 30 秒 → 重连
2. 退出 → 重登
3. 重装（最后手段）

升级问题

更新后界面变了

正常！Claude Desktop 持续更新，UI 偶尔调整。

1. 看官方更新日志
2. 适应新界面
3. 反馈问题（Help → Send Feedback）

自动更新失败

1. 手动下载最新版
2. 完全卸载旧版（包括 ~/Library/Application Support/Claude 等残留）
3. 重装

还有问题怎么办

按这个顺序排查：

flowchart TD
    A[有问题] --> B[查 FAQ]
    B --> C{解决?}
    C -->|是| D[完成]
    C -->|否| E[问 Claude]
    E --> F{解决?}
    F -->|是| D
    F -->|否| G[Help Center]
    G --> H{解决?}
    H -->|是| D
    H -->|否| I[联系客服]

图 7-7 展示从自助排查到官方支持的升级路径：先查 FAQ，再问 Claude，再查帮助中心，最后联系客服。

反馈与建议

桌面端 → Settings → Help → Send Feedback

或者：

• 官方 Help Center：https://support.claude.com/
• Discord 社区：https://www.anthropic.com/discord
• 邮件：121280003@qq.com

继续阅读

• 想要看术语：术语表
• 想要更多资源：参考资料

术语表

A

Agent

能自主完成多步任务的 AI 程序。Claude Code 就是一个 coding agent。

Anthropic

Claude 的开发公司。成立于 2021 年，总部在美国旧金山。

API（Application Programming Interface）

应用编程接口。Anthropic 提供 Claude API 让开发者把 Claude 集成到自己的产品中。

Artifact（工件）

Claude 在对话中生成的独立、可编辑、可发布的内容块。详见 Artifacts（工件）深入。

B

Beta（公测）

未正式发布的功能。Claude 部分高级能力（如 Extended thinking）可能先以 Beta 形式推出。

C

Chat 模式

Claude Desktop 的对话问答模式。与 Cowork / Claude Code 并列。

Claude

Anthropic 开发的 AI 助手。本指南主角。

Claude Code

Computer Use（计算机操作）

让 Claude 直接操作你的电脑：打开应用、操作浏览器、点击 UI。是 Cowork 的一部分。

Context Window（上下文窗口）

模型一次请求能处理的消息、附件与输出总量。上限取决于具体模型和产品入口。

Conversation（对话）

你与 Claude 之间一次完整的交流。详见 核心概念 → 对话。

Cowork

Claude Desktop 的自主任务模式。详见 Cowork 简介。

Custom Instructions（自定义指令）

放在账号或项目级别的长期提示词。

D

Dashboard（仪表板）

团队或组织账号常见的管理界面。

Data Controls（数据控制）

控制 Anthropic 是否使用你的对话训练模型的设置。

E

Enterprise（企业版）

Anthropic 面向企业组织提供的使用方式，通常包含管理、权限和采购流程。具体能力以官方说明和合同为准。

Extended Thinking（扩展思考）

让 Claude “多想一会儿”的模式。是否可用取决于当前产品入口与账号权限。

F

Few-shot（少样本）

在提示词里给几个例子，让 Claude 模仿例子的格式和风格。

Free（免费版）

Anthropic 面向个人用户提供的免费使用方式。

G

Generated Content（生成内容）

Claude 输出的内容。注意：可能不准确，需要人工核对。

GitHub / GitLab

代码托管平台。Claude Code 可以与它们集成，读取 Issue、提 PR。

H

Haiku

Claude 的轻量模型系列，通常侧重速度，适合短任务。具体版本与限制以模型菜单为准。

I

IDE（Integrated Development Environment，集成开发环境）

写代码的工具。Claude Code 可与 VS Code、JetBrains 等 IDE 集成。

L

LLM（Large Language Model，大语言模型）

Claude 所属的技术类别——用海量文本训练的语言模型。

Linux

开源操作系统。Claude Desktop 不支持 Linux。详见 系统要求 → 关于 Linux。

M

Max（高用量版）

Anthropic 面向高频个人用户提供的一种高用量使用方式。具体权益以官方说明为准。

MCP（Model Context Protocol）

Anthropic 提出的"模型上下文协议"。让 Claude 连接外部工具和数据源。

Model（模型）

Claude 的"大脑"。常见系列包括 Haiku、Sonnet 和 Opus，具体版本会持续更新。

Mermaid

一种用文本描述图表的语法。Claude 可生成 Mermaid 图。

MSIX

Windows 10/11 的一种应用打包格式。Claude Desktop 在 Windows 上用 MSIX 分发。

O

Opus

Claude 的能力优先模型系列，适合复杂任务。具体版本与可用范围取决于产品更新与当前入口。

P

Package（包）

Claude Desktop 安装包。macOS 是 .dmg 或 .pkg；Windows 是 .msix。

Plan（方案）

账户当前的购买或使用方案。具体名称与层级会随产品变化。

Project（项目）

Claude Desktop 的主题 + 知识 + 指令 + 对话的容器。详见 Projects（项目）深入。

Prompt（提示词）

发给 Claude 的输入文本。

Pro（付费版）

Anthropic 面向个人用户提供的一种付费使用方式。具体权益以官方说明为准。

R

Retry（重试）

让 Claude 用同样输入重新生成回答。

RAG（Retrieval-Augmented Generation）

让模型从外部知识库检索信息再回答。Project 知识库使用类似机制。

S

SaaS（Software as a Service）

软件即服务。Claude 是 SaaS 产品。

Sonnet

Claude 的均衡模型系列，通常兼顾速度与能力，适合大多数日常任务。

SSO（Single Sign-On，单点登录）

用一套账号登录多个系统。是否支持取决于组织身份系统与当前产品入口。

Style（风格）

控制 Claude 默认输出语气的设置。详见 Style（风格）深入。

T

Team（团队版）

面向团队协作的使用方式，通常包含成员、共享和管理能力。具体限制以官方说明为准。

Token

模型处理文本的最小单位。约 1 个英文单词 = 1.3 tokens；1 个中文字 ≈ 1.5-2 tokens。

Tool Calling（工具调用）

让 Claude 调用外部工具（如 API、文件、命令）。Cowork / Claude Code 大量使用。

U

UI（User Interface，用户界面）

应用的外观和交互。Claude Desktop 的 UI 由 Anthropic 持续更新。

V

Voice Input（语音输入）

通过麦克风说话转为文字。Claude Desktop 部分版本支持。

W

Web Search（网络搜索）

让 Claude 联网搜索最新信息。是否可用取决于当前产品入口、账号权限和官方开放范围。

其他缩写

表 7-1 常见缩写速查

继续阅读

• 想要常见问题：常见问题与翻车点
• 想要更多资源：参考资料

参考资料

官方资源（首选）

产品页

帮助文档

法律与政策

公司

社区与支持

官方社区

中文社区

进一步学习路径

想深入了解 Claude 本身

flowchart LR
    A[了解基础] --> B[官方博客]
    B --> C[Prompt 指南]
    C --> D[Models 概览]
    D --> E[论文]
    E --> F[研究动态]

想深入用 Claude 编程

想深入了解 Cowork

第三方推荐阅读

提示词工程

• Anthropic Prompt Engineering Interactive Tutorial
• Claude Prompt Library
• Learn Prompting

AI 工具评测

• 知乎"AI 工具"专栏
• 少数派 Matrix
• Product Hunt 上的 Claude 讨论

行业应用案例

• Anthropic Customer Stories
• 官方 YouTube 上的 case study 视频

学术与研究

商业合作

常用命令速查

反馈与支持

121280003@qq.com       一般支持
121280003@qq.com       隐私问题
121280003@qq.com           数据保护官
121280003@qq.com         销售咨询

工具与扩展

这些扩展的开放范围会变化，使用前请以应用内入口和官方说明为准。

本指南的版本

• 版本日期：2026-06-15
• 基于：Claude Desktop 较新稳定版；模型以当期应用内可见系列为准
• 作者：基于 Claude 官方资料 + 实践经验

如何为本指南做贡献

推荐资源使用顺序

flowchart TD
    A[遇到问题] --> B{本指南?}
    B -->|是| C[按指南]
    B -->|否| D{官方文档?}
    D -->|是| E[按官方]
    D -->|否| F[问 Claude]
    F --> G{解决?}
    G -->|是| H[记录]
    G -->|否| I[Help Center]
    I --> J{解决?}
    J -->|否| K[Discord]
    K --> L{解决?}
    L -->|否| M[联系客服]