常见问题 FAQ
汇总 Claude Code 使用过程中最常见的问题和解答。
🚀 安装与配置
Q: 如何安装 Claude Code？
A: 有多种安装方式：
bash
# 方式一：官方安装脚本（推荐）
curl -fsSL https://claude.ai/install.sh | bash
# 方式二：Homebrew (macOS)
brew install --cask claude-code
# 方式三：npm
npm install -g @anthropic-ai/claude-codeQ: 可以在浏览器中使用吗？
A: 可以！2025年11月推出的 Claude Code 网页版 支持：
- 无需安装，直接在浏览器使用
- 连接 GitHub 仓库
- 并行运行多个任务
- Pro、Max 和企业用户可用
Q: 如何安装 VS Code 扩展？
A:
- 打开 VS Code 扩展市场
- 搜索 "Claude Code"
- 安装 Anthropic 官方扩展
- 重启 VS Code
🤖 模型相关
Q: 支持哪些模型？
A: 当前支持：
| 模型 | 特点 | 切换命令 |
|---|---|---|
| Opus 4.6 | 最强大，深度思考 | /model opus |
| Sonnet 4.5 | 平衡性能 | /model sonnet |
| Haiku 4.5 | 快速响应 | /model haiku |
Q: Opus 4.6 的思考模式是什么？
A: Opus 4.6 默认启用深度思考模式，会在回答前进行更深入的推理。适合：
- 复杂架构设计
- 疑难 bug 调试
- 算法优化
⏪ Checkpoints 检查点
Q: 什么是 Checkpoints？
A: 检查点是 2025年9月推出的新功能，自动保存代码状态：
- 每次修改前自动创建检查点
- 按两次
Esc快速回退 - 使用
/rewind命令回退到指定版本
Q: 如何使用检查点？
A:
bash
# 回退到上一个检查点
/rewind
# 查看所有检查点
/checkpoints
# 回退到指定检查点
/rewind <checkpoint-id>🎬 检查点使用演示
💰 费用与订阅
Q: Claude Code 如何收费？
A: Claude Code 本身免费，费用来自 API/订阅：
- Pro ($20/月)：基础使用量
- Max 5X ($100/月)：5倍使用量
- Max 20X ($200/月)：20倍使用量
- API 直接使用：按 token 计费
Q: 网页版需要额外付费吗？
A: 不需要，网页版包含在现有订阅中：
- Pro、Max 订阅用户可直接使用
- 企业用户需要 premium seats
🔧 使用问题
Q: 如何让 Claude 读取整个项目？
A: Claude Code 会自动分析项目。你也可以：
- 创建
CLAUDE.md描述项目上下文 - 使用
/add添加特定文件 - 使用
@文件名引用文件
Q: 上下文太长怎么办？
A:
/compact- 压缩对话历史/clear- 清除当前会话- 使用 Explore 子代理进行搜索（节省 token）
🎬 上下文管理演示
Q: 如何撤销 Claude 的修改？
A: 多种方式：
- Checkpoints：按两次
Esc或/rewind - Git：
git checkout -- <file> - IDE：使用编辑器撤销功能
📊 新功能
Q: 什么是快速模式？
A: 快速模式（v2.1.36+）使用相同的 Opus 4.6 模型，但输出速度更快：
- 输入
/fast切换快速模式 - 再次输入
/fast切换回普通模式 - 适合日常编码、快速修复等场景
- 不会切换到更弱的模型
Q: 什么是代理团队？
A: 代理团队（v2.1.32+）是研究预览功能，允许多个 Claude Code 实例协同工作：
bash
# 启用代理团队
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
claude目前为实验性功能，建议在非关键项目中试用。
Q: 什么是自动记忆？
A: 自动记忆（v2.1.32+）让 Claude 跨会话记住重要信息：
- 自动识别值得记住的模式和偏好
- 存储在
~/.claude/projects/目录下 - 可手动要求记住或忘记特定内容
Q: /stats 命令显示什么？
A: 使用统计信息：
- 最常用的模型
- 使用量图表
- 连续使用天数
- Token 消耗统计
Q: 如何使用命名会话？
A:
bash
# 重命名会话
/session rename "重构认证模块"
# 列出所有会话
/sessions
# 恢复会话
/session resume <name>🎬 会话管理演示
Q: Slack 集成怎么用？
A: 2025年12月推出的测试功能：
- 在 Slack 工作区安装 Claude 应用
- 在对话中 @Claude 分配任务
- Claude 自动完成并反馈结果
⚠️ 错误排查
Q: "Rate limit exceeded" 怎么办？
A:
- 等待几分钟后重试
- 检查订阅计划的使用限制
- 考虑升级到 Max 计划
- 企业用户可购买额外用量
Q: "Context length exceeded" 怎么办？
A:
/compact压缩上下文/clear开始新会话- 减少一次性添加的文件数量
Q: 网络连接问题？
A:
- 检查代理设置
- 设置
HTTPS_PROXY环境变量 - 参考 企业代理配置
🛡️ 安全与隐私
Q: 我的代码安全吗？
A: Anthropic 保证：
- API 数据不用于模型训练
- 网页版使用隔离沙盒环境
- Git 操作通过安全代理
- 详见 数据使用说明