Claude Code 从入门到精通
本指南全面介绍 Claude Code CLI 工具的使用方法，涵盖从基础安装到企业级应用的完整路径。支持多模型切换、配置管理和自动化工作流。
目录
- [初识 Claude Code](#初识 Claude Code)
- 安装与环境配置
- [ccswitch 工具详解](#ccswitch 工具详解)
- 基础使用入门
- 配置管理
- 多模型切换
- 项目协作与团队配置
- 高级用法与技巧
- 集成与扩展
- 最佳实践
- 常见问题与排错
1. 初识 Claude Code
1.1 什么是 Claude Code
Claude Code = AI 驱动的命令行开发助手
Claude Code 是 Anthropic 官方提供的 CLI 工具，通过自然语言交互帮助开发者完成代码编写、调试、重构和解释等任务。
| 对比 | 传统开发 | 使用 Claude Code |
|---|---|---|
| 代码查找 | 手动搜索文件 | 智能语义搜索 |
| 代码解释 | 查阅文档 | 即时对话解答 |
| Bug 修复 | 逐行排查 | AI 辅助分析定位 |
| 代码生成 | 手动编写 | 自然语言描述生成 |
| 重构优化 | 凭经验 | AI 提供方案建议 |
1.2 核心能力
┌─────────────────────────────────────────────────────────────┐
│ Claude Code 核心能力 │
├─────────────────────────────────────────────────────────────┤
│ 代码生成 │ 自然语言描述 → 高质量代码 │
│ 代码审查 │ 自动检测代码问题与优化点 │
│ Bug 修复 │ 智能定位根因并提供修复方案 │
│ 解释文档 │ 代码即文档，理解成本降低 │
│ 重构优化 │ 安全重构建议与实施 │
│ 多模型支持 │ Opus/Sonnet/Haiku 按需切换 │
│ MCP 集成 │ 工具调用与外部系统交互 │
└─────────────────────────────────────────────────────────────┘1.3 支持的场景
- 代码编写 - 快速生成函数、类、模块
- 代码审查 - PR review、代码质量检查
- 调试排错 - 错误分析、堆栈解读
- 技术解答 - 架构设计、性能优化建议
- 学习辅助 - 代码讲解、技术深挖
- 自动化脚本 - 快速生成 Shell/Python 脚本
1.4 Claude Code vs 其他工具
| 特性 | Claude Code | GitHub Copilot | Cursor |
|---|---|---|---|
| 交互方式 | CLI 对话 | IDE 补全 | GUI 对话 |
| 上下文理解 | 深度对话 | 补全建议 | 会话上下文 |
| 模型选择 | 多模型切换 | 固定模型 | 固定模型 |
| 工具调用 | MCP 集成 | 基础补全 | 基础补全 |
| 配置文件 | ccswitch | 无 | 无 |
2. 安装与环境配置
2.1 系统要求
最低系统要求
- 操作系统：Windows 10/11、macOS 12+、Linux (Ubuntu 20.04+)
- 内存：4GB RAM
- 磁盘：200MB 可用空间
- 网络：需要访问 Anthropic API2.2 安装 Claude Code Cli
Windows 安装方法：
bash
# 方法一：npm 安装（官方包名）
npm install -g @anthropic-ai/claude-code
# 或使用 npx 直接运行
npx @anthropic-ai/claude-code
# 方法二：官网下载
# 访问 https://claude.ai/download 下载 Windows/macOS 安装包
# 双击安装包完成安装
# 方法三：Scoop（如果可用，需先确认源）
# 添加官方或社区维护的 bucket
scoop bucket add extras
# 注意：需确认 bucket 中是否有 claude-code，目前可能不存在
scoop install claude-codemacOS 安装方法：
bash
# 使用 Homebrew
brew install --cask claude-code
# 或访问官网下载 .dmg 安装包Linux 安装方法：
bash
# 使用官方安装脚本
curl -fsSL https://downloads.anthropic.com/cli/install.sh | sh
# 或访问官网下载 .deb/.rpm 包2.3 启动 Claude Code
bash
# Windows
# 开始菜单 → Claude Code
# 或双击桌面快捷方式
# macOS
# 应用程序 → Claude Code
# 或使用 Spotlight 搜索
# 命令行启动（如已安装 CLI）
claude3. ccswitch 工具详解
3.1 什么是 ccswitch
ccswitch = Claude Code 配置切换工具（桌面版）
ccswitch 是 Claude Code 的图形化配置管理工具，无需命令行操作，通过可视化界面快速切换不同的模型、角色和设置。
注意：ccswitch 是桌面版工具，不是命令行工具，适合不熟悉命令行的用户使用。
| 核心功能 | 说明 |
|---|---|
| 可视化配置 | 图形界面管理配置 |
| 一键切换 | 快速切换模型/角色 |
| 场景预设 | 预置开发、审查等场景 |
| 配置导入/导出 | 团队配置共享 |
4. 基础使用入门
4.1 启动 Claude Code
Windows：
- 开始菜单 → Claude Code
- 或双击桌面快捷方式
- 或使用命令提示符输入：claude
macOS：
- 应用程序文件夹 → Claude Code
- 或使用 Spotlight 搜索 Claude Code
桌面版界面：
┌─────────────────────────────────────────────────────────────┐
│ Claude Code │
├─────────────────────────────────────────────────────────────┤
│ [模型选择 ▼] [场景预设 ▼] [设置] │
├─────────────────────────────────────────────────────────────┤
│ │
│ 对话输入区 │
│ │
├─────────────────────────────────────────────────────────────┤
│ [文件浏览器] [历史记录] [配置管理] │
└─────────────────────────────────────────────────────────────┘4.2 模型选择
界面操作：
1. 点击左上角模型选择下拉框
2. 选择需要的模型：
- Claude Opus 4（复杂任务）
- Claude Sonnet 4（日常开发）
- Claude Haiku 4（快速任务）
或使用 ccswitch 可视化切换4.3 场景预设
ccswitch 内置场景：
- 开发（Development） - 日常编码辅助
- 审查（Review） - 代码审查优化
- 安全（Security） - 安全漏洞检测
- 学习（Learning） - 代码解释学习
- 重构（Refactor） - 代码重构优化
选择方式：
1. 打开 ccswitch 面板
2. 选择场景标签
3. 开始对话4.4 文件操作
基础操作：
- 点击"打开文件"选择要编辑的文件
- 直接拖拽文件到界面
- 使用右侧文件浏览器导航
编辑操作：
- 选中代码后右键选择"解释/优化/重构"
- 使用快捷键 Ctrl+E（解释）Ctrl+R（重构）
- 批注功能添加评论4.5 项目管理
新建项目：
1. 点击"新建项目"
2. 选择项目模板或空项目
3. 添加项目文件
打开项目：
1. 点击"打开项目"
2. 选择项目文件夹
3. 自动识别项目类型
项目设置：
- 右键项目文件夹 → 项目设置
- 配置项目级模型和场景4.6 第一个任务：代码审查
操作步骤：
1. 打开 ccswitch
2. 选择"审查"场景
3. 打开要审查的项目/文件
4. 在对话框输入：
"帮我审查 src/ 目录下的代码，重点关注：
- 潜在的 Bug
- 性能问题
- 安全漏洞
- 代码风格"
5. 查看审查结果
6. 点击问题跳转到对应代码位置
7. 一键修复或手动修改5. 配置管理（ccswitch 可视化）
5.1 打开 ccswitch 配置面板
方式一：从 Claude Code 菜单打开
- 点击右上角设置图标
- 选择"ccswitch 配置"
方式二：快捷键
- Ctrl+Shift+P（Windows）
- Cmd+Shift+P（macOS）
方式三：系统托盘
- 双击桌面右下角 ccswitch 图标5.2 ccswitch 主界面
┌─────────────────────────────────────────────────────────────┐
│ ccswitch - 配置管理器 │
├─────────────────────────────────────────────────────────────┤
│ │
│ [场景] [模型] [角色] [团队配置] │
│ ▼ ▼ ▼ ▼ │
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │开发环境 │ │Opus 4 │ │程序员 │ │团队A │ │
│ │审查 │ │Sonnet 4 │ │教师 │ │团队B │ │
│ │安全 │ │Haiku 4 │ │运维 │ │个人 │ │
│ │学习 │ │ │ │测试 │ │ │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ │
│ 当前配置：开发环境 + Sonnet 4 │
│ [应用到 Claude Code] │
│ │
└─────────────────────────────────────────────────────────────┘5.3 创建自定义配置
1. 点击"+"按钮
2. 选择配置类型：
- 场景配置
- 模型配置
- 角色配置
3. 填写配置信息：
名称：我的配置
描述：自定义用途
模型：Sonnet 4
温度：0.7
最大 Token：8192
4. 点击"保存"
5. 在列表中选中使用5.4 配置模板
内置模板：
┌─────────────────────────────────────────────────────────────┐
│ ccswitch 配置模板 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 开发环境（Development） │
│ ├── 模型：Sonnet 4 │
│ ├── 温度：0.7 │
│ ├── 上下文：中等 │
│ └── 适用：日常编码、简单问题 │
│ │
│ 代码审查（Review） │
│ ├── 模型：Opus 4 │
│ ├── 温度：0.3 │
│ ├── 上下文：完整 │
│ └── 适用：深度审查、安全检测 │
│ │
│ 快速任务（Quick） │
│ ├── 模型：Haiku 4 │
│ ├── 温度：0.5 │
│ ├── 上下文：简洁 │
│ └── 适用：简单解释、批量处理 │
│ │
└─────────────────────────────────────────────────────────────┘5.5 配置导入/导出
导出配置：
1. 在配置列表中选择要导出的配置
2. 点击"导出"按钮
3. 选择保存位置
4. 生成 .ccsw 格式文件
导入配置：
1. 点击"导入"按钮
2. 选择 .ccsw 文件
3. 配置解析预览
4. 确认导入
团队共享：
1. 导出配置到共享目录
2. 团队成员导入使用
3. 确保版本一致5.6 配置优先级
界面操作优先级：
┌─────────────────────────────────────────────────────────────┐
│ 高 │ 项目级配置（当前项目 .ccswitch.json） │
│ ↓ │
│ 中 │ ccswitch 主界面当前选择 │
│ ↓ │
│ 低 │ 默认配置（系统设置） │
└─────────────────────────────────────────────────────────────┘6. 多模型切换（ccswitch 可视化）
6.1 可用模型
| 模型 | 特点 | 适用场景 | 速度 |
|---|---|---|---|
| Claude Opus 4 | 最强能力 | 复杂任务、深度分析 | 慢 |
| Claude Sonnet 4 | 平衡之选 | 日常开发、代码生成 | 中 |
| Claude Haiku 4 | 快速响应 | 简单任务、批量处理 | 快 |
6.2 通过 ccswitch 切换模型
操作步骤：
1. 打开 ccswitch 配置面板
2. 点击"模型"标签页
3. 选择需要的模型
4. 点击"应用"
或使用快捷操作：
1. 在 Claude Code 界面点击左上角模型选择
2. 下拉选择新模型
3. 立即生效6.3 按场景选择模型
| 场景 | 推荐模型 | 原因 |
|---|---|---|
| 代码审查 | Opus | 深度分析、安全漏洞检测 |
| 简单修改 | Haiku | 速度快、成本低 |
| 新功能开发 | Sonnet | 平衡速度和能力 |
| 重构优化 | Opus | 需要深度理解代码 |
| 学习辅导 | Sonnet | 解释清晰、速度快 |
6.4 自动化模型选择
在 ccswitch 中配置自动选择规则：
1. 打开 ccswitch → 自动选择
2. 点击"添加规则"
3. 配置规则条件：
- 文件类型：*.md → Haiku
- 文件路径：security/** → Opus
- 项目类型：test → Sonnet
4. 保存规则
5. 启用自动选择开关
规则说明：
┌─────────────────────────────────────────────────────────────┐
│ 自动选择规则示例 │
├─────────────────────────────────────────────────────────────┤
│ 规则1：*.md 文件 → 使用 Haiku（文档任务简单快速） │
│ 规则2：**/test*.py → 使用 Sonnet（测试代码平衡选择） │
│ 规则3：security/** → 使用 Opus（安全相关需要深度分析） │
│ 规则4：complex/** → 使用 Opus（复杂架构需要强模型） │
└─────────────────────────────────────────────────────────────┘6.5 模型参数调优
在 ccswitch 模型配置中调整：
1. 打开 ccswitch → 模型 → 高级设置
参数说明：
┌─────────────────────────────────────────────────────────────┐
│ 模型参数配置 │
├─────────────────────────────────────────────────────────────┤
│ Temperature │ 创造性参数（0-1） │
│ │ 0.3 = 精确，0.7 = 平衡，1.0 = 创造 │
│ ───────────────┼────────────────────────────────────────── │
│ Max Tokens │ 最大输出长度 │
│ │ 2048 = 短回复，8192 = 中等，16384 = 长文 │
│ ───────────────┼────────────────────────────────────────── │
│ Top P │ 核采样参数（0-1） │
│ │ 控制输出多样性 │
│ ───────────────┼────────────────────────────────────────── │
│ 思考模式 │ 启用逐步推理 │
│ │ 复杂问题启用，简单问题关闭 │
└─────────────────────────────────────────────────────────────┘7. 项目协作与团队配置
7.1 团队配置共享（ccswitch）
导出配置：
1. 在 ccswitch 中选择要分享的配置
2. 点击"导出" → 选择保存位置
3. 生成 .ccsw 文件
4. 发送给团队成员
导入配置：
1. 收到 .ccsw 文件
2. ccswitch → 导入
3. 选择文件 → 预览配置
4. 点击"确认导入"
团队仓库：
1. 将配置上传到团队 Git 仓库
2. 团队成员拉取后导入
3. 确保版本一致性7.2 团队配置示例
ccswitch 团队配置：
┌─────────────────────────────────────────────────────────────┐
│ 公司统一开发环境配置 │
├─────────────────────────────────────────────────────────────┤
│ 模型：Sonnet 4 │
│ 温度：0.7 │
│ 工具：读写文件、搜索、代码执行 │
│ │
│ 规则： │
│ - 代码风格：团队统一标准 │
│ - 文件大小限制：1MB │
│ - 敏感信息过滤：password/api_key/secret │
│ - 审查要求：重要项目必须审查 │
│ │
│ MCP 服务： │
│ - GitHub（代码管理） │
│ - Jira（任务跟踪） │
│ - PagerDuty（告警） │
└─────────────────────────────────────────────────────────────┘7.3 项目级配置
在项目中创建配置：
1. 在项目根目录创建 .ccswitch 文件
2. 配置项目专属设置
3. 打开项目时自动加载
示例：my-project/.ccswitch
{
"name": "my-project",
"model": "sonnet",
"temperature": 0.7,
"rules": {
"max_file_size": 512000,
"confirm_before_write": true
}
}7.4 环境隔离
多项目配置管理：
1. 每个项目独立配置
2. ccswitch 自动识别当前项目
3. 配置隔离互不干扰
切换项目时：
- ccswitch 自动加载对应配置
- 模型和场景随之切换
- 无需手动操作
查看当前配置：
- ccswitch 主界面显示当前项目配置
- 状态栏显示当前使用的模型和场景8. 高级用法与技巧
8.1 上下文管理
在桌面版中管理上下文：
1. 打开侧边栏"上下文"面板
2. 将文件/文件夹拖入
3. 或点击"+"添加文件
查看当前上下文：
- 在上下文面板查看已加载的文件
- 显示文件数量和总大小
- 支持移除不需要的文件
常用操作：
- 右键文件 → 移除出上下文
- 右键文件 → 在编辑器中打开
- 右键文件 → 查看文件信息8.2 快捷操作
鼠标快捷操作：
- Ctrl+单击：打开定义
- Ctrl+右键：快速操作菜单
- 中键点击：关闭标签页
键盘快捷键：
┌─────────────────────────────────────────────────────────────┐
│ Ctrl+L │ 清空对话 │
│ Ctrl+Enter │ 发送消息 │
│ Ctrl+/ │ 打开命令面板 │
│ Ctrl+Shift+P │ 打开 ccswitch │
│ Ctrl+E │ 解释选中代码 │
│ Ctrl+R │ 优化选中代码 │
└─────────────────────────────────────────────────────────────┘8.3 多标签页操作
标签页功能：
- 支持多个对话并行
- 点击"+"新建标签
- 拖拽排序标签顺序
- 右键关闭/固定/复制标签
标签页管理：
┌─────────────────────────────────────────────────────────────┐
│ [对话1] [对话2] [审查] [+] │
│ │
│ 右键菜单： │
│ - 新建标签 │
│ - 关闭标签 │
│ - 关闭其他标签 │
│ - 固定标签（不会被关闭） │
│ - 复制标签（新建相同上下文） │
└─────────────────────────────────────────────────────────────┘8.4 对话历史
历史记录管理：
1. 点击左侧"历史"面板
2. 查看所有历史对话
3. 支持搜索历史
4. 支持按项目筛选
操作：
- 双击打开历史对话
- 右键删除/重命名
- 导出对话记录
- 清空历史8.5 MCP 工具使用
在桌面版中配置 MCP：
1. 打开设置 → MCP
2. 点击"添加服务器"
3. 选择或创建 MCP 配置
常用 MCP 服务：
┌─────────────────────────────────────────────────────────────┐
│ GitHub │ 代码管理、PR 审查 │
│ GitLab │ 代码管理、项目集成 │
│ Jira │ 任务跟踪、项目管理 │
│ Slack │ 团队沟通、通知 │
│ 文件系统 │ 本地文件读写 │
│ 终端 │ 执行命令 │
└─────────────────────────────────────────────────────────────┘
管理 MCP：
- 启用/禁用服务
- 配置连接参数
- 测试连接状态
- 查看使用日志8.6 高级设置
在设置中配置高级选项：
1. 打开设置 → 高级
可配置项：
┌─────────────────────────────────────────────────────────────┐
│ 思考模式 │
│ ├── 启用思考模式：复杂问题逐步推理 │
│ └── 最大思考 Token：4096 │
│ │
│ 输出控制 │
│ ├── 流式输出：实时显示响应 │
│ ├── 语法高亮：代码块高亮显示 │
│ └── Markdown 预览：渲染格式 │
│ │
│ 性能 │
│ ├── 上下文压缩：自动压缩长对话 │
│ ├── 预加载模型：加速切换 │
│ └── 缓存策略：配置缓存行为 │
└─────────────────────────────────────────────────────────────┘9. 集成与扩展
9.1 文件编辑器集成
支持的文件类型：
- 代码文件：Python, JavaScript, TypeScript, Go, Java, etc.
- 配置文件：JSON, YAML, TOML, XML, etc.
- 文档文件：Markdown, TXT, PDF, HTML, etc.
- 数据文件：CSV, Excel, SQL, etc.
编辑功能：
- 语法高亮
- 代码补全
- 错误提示
- 格式化9.2 Git 集成
在 Claude Code 中使用 Git：
1. 打开 Git 面板
2. 查看变更列表
3. 进行提交/推送
操作说明：
┌─────────────────────────────────────────────────────────────┐
│ Git 操作 │
│ ───────────────────────────────────────────────────── │
│ 查看差异：点击文件 → 显示变更内容 │
│ 提交：输入提交信息 → 点击提交 │
│ 拉取：点击拉取按钮 │
│ 推送：点击推送按钮 │
│ 分支：切换分支/创建分支 │
└─────────────────────────────────────────────────────────────┘9.3 终端集成
内置终端：
1. 点击底部"终端"标签
2. 打开集成终端
3. 直接执行命令
功能：
- 支持 bash/powershell
- 历史命令记录
- 多终端标签
- 输出重定向到对话9.4 自定义 MCP 服务器
通过 ccswitch 添加 MCP：
1. 打开 ccswitch → MCP
2. 点击"添加服务器"
3. 选择服务器类型
4. 填写配置信息
配置示例：
┌─────────────────────────────────────────────────────────────┐
│ 添加自定义 MCP 服务器 │
├─────────────────────────────────────────────────────────────┤
│ 服务器名称：my-server │
│ 命令：node │
│ 参数：/path/to/server.js │
│ 环境变量：API_KEY=xxx │
│ │
│ 测试连接 → 保存 │
└─────────────────────────────────────────────────────────────┘9.5 Webhook 集成
在 ccswitch 中配置 Webhook：
1. 打开 ccswitch → Webhook
2. 点击"添加 Webhook"
3. 配置触发条件和目标
配置示例：
┌─────────────────────────────────────────────────────────────┐
│ Webhook 配置 │
├─────────────────────────────────────────────────────────────┤
│ 名称：Slack 通知 │
│ 触发事件：审查完成 │
│ 目标 URL：https://hooks.slack.com/xxx │
│ 请求方式：POST │
│ Body 模板：{"text": "审查完成: {{result.summary}}"} │
│ │
│ 测试 → 保存 │
└─────────────────────────────────────────────────────────────┘10. 最佳实践
10.1 开发效率
常用配置技巧：
┌─────────────────────────────────────────────────────────────┐
│ 场景预设 │
│ ───────────────────────────────────────────────────── │
│ 开发模式：Sonnet 4 + 中等温度 │
│ 审查模式：Opus 4 + 低温度（精确） │
│ 快速模式：Haiku 4 + 高响应速度 │
│ │
│ 快捷切换：使用 ccswitch 一键切换场景 │
└─────────────────────────────────────────────────────────────┘
日常使用建议：
1. 根据任务类型选择合适场景
2. 重要项目使用 Opus 进行深度分析
3. 简单任务使用 Haiku 提升速度
4. 善用上下文管理控制成本10.2 代码质量
审查配置建议：
1. 打开 ccswitch → 审查场景
2. 选择 Opus 模型（深度分析）
3. 启用安全检测规则
4. 配置自动审查（可选）
审查检查项：
- 潜在 Bug 检测
- 性能问题识别
- 安全漏洞扫描
- 代码风格检查
- 最佳实践建议
输出格式：支持 Markdown 报告10.3 安全实践
敏感信息处理：
1. ccswitch 配置敏感词过滤
2. 审查时自动检测泄露
3. 配置阻断规则
ccswitch 安全规则：
┌─────────────────────────────────────────────────────────────┐
│ 敏感信息过滤 │
│ ───────────────────────────────────────────────────── │
│ 过滤模式： │
│ - password │
│ - api_key │
│ - secret │
│ - token │
│ - private_key │
│ │
│ 发现敏感信息时： │
│ - 提示警告 │
│ - 建议脱敏 │
│ - 记录审计日志 │
└─────────────────────────────────────────────────────────────┘10.4 性能优化
使用适当模型：
- 简单任务：Haiku（快速、成本低）
- 日常开发：Sonnet（平衡）
- 复杂任务：Opus（深度分析）
上下文优化：
1. 及时清理不需要的文件
2. 使用项目级配置隔离
3. 启用上下文压缩（设置）
4. 长对话定期新建标签页
ccswitch 性能设置：
- 启用预加载模型
- 配置缓存策略
- 限制最大上下文大小10.5 团队协作
团队配置管理：
1. 统一使用 ccswitch 管理配置
2. 将配置存储在团队仓库
3. 新成员一键导入
交接流程：
1. 导出当前配置 → 生成 .ccsw 文件
2. 发送给新成员
3. 新成员导入配置
4. 验证配置生效
角色定义建议：
┌─────────────────────────────────────────────────────────────┐
│ 角色 │ 模型 │ 适用场景 │
│ ──────────────┼────────────┼──────────────────────────── │
│ 开发者 │ Sonnet 4 │ 日常编码 │
│ 审查者 │ Opus 4 │ 代码审查 │
│ 安全工程师 │ Opus 4 │ 安全检测 │
│ 运维工程师 │ Sonnet 4 │ 运维脚本 │
│ 学习者 │ Haiku 4 │ 快速解释 │
└─────────────────────────────────────────────────────────────┘11. 常见问题与排错
11.1 安装问题
问题：安装失败
排查步骤：
1. 检查系统要求
- Windows 10/11
- 足够的磁盘空间
- 网络连接正常
2. 检查权限
- 以管理员身份运行安装程序
- 杀毒软件允许安装
3. 重新安装
- 卸载旧版本
- 清理残留文件
- 重新下载安装11.2 启动问题
问题：Claude Code 无法启动
解决方案：
1. 检查系统要求
- 最低 4GB 内存
- 200MB 可用空间
2. 清理缓存
- 删除 %APPDATA%/claude-code 缓存
- 重启应用
3. 重新安装
- 卸载当前版本
- 下载最新版本安装11.3 配置问题
问题：配置不生效
排查步骤：
1. 检查当前配置
- ccswitch 主界面显示当前配置
- 确认配置已选中
2. 检查项目级配置
- 查看 .ccswitch 文件是否存在
- 检查配置语法
3. 重新加载
- 关闭 ccswitch
- 重启 Claude Code
- 重新打开 ccswitch
4. 验证配置
- ccswitch → 诊断 → 检查配置状态11.4 模型切换问题
问题：模型切换失败
解决方案：
1. 检查网络连接
- 确保可以访问 Anthropic API
2. 检查模型配额
- 登录 Anthropic 账户查看配额
3. 重置设置
- ccswitch → 设置 → 重置模型选择
4. 更新应用
- 确保使用最新版本 Claude Code11.5 MCP 连接问题
问题：MCP 服务器无法连接
排查步骤：
1. 检查 MCP 配置
- ccswitch → MCP → 查看服务器列表
- 测试连接状态
2. 检查网络
- 确保目标服务可访问
- 检查防火墙设置
3. 检查认证
- API Key 是否有效
- 权限是否足够
4. 查看日志
- ccswitch → 日志 → 查看 MCP 错误11.6 性能问题
问题：响应缓慢
优化方案：
1. 使用更快的模型
- 简单任务切换到 Haiku
2. 减少上下文
- 清理不需要的文件
- 新建对话标签页
3. 启用缓存
- ccswitch → 设置 → 启用缓存
4. 检查网络
- 测试到 Anthropic API 的延迟
- 考虑使用代理
5. 更新版本
- 确保使用最新版本附录：资源汇总
官方资源
| 资源 | 地址 |
|---|---|
| Claude Code 官网 | https://claude.ai/code |
| Anthropic 文档 | https://docs.anthropic.com |
| GitHub 仓库 | https://github.com/anthropics/claude-code |
| ccswitch GitHub | https://github.com/ccswitch/ccswitch |
社区资源
| 资源 | 地址 |
|---|---|
| Discord 社区 | https://discord.gg/anthropic |
| https://reddit.com/r/ClaudeAI | |
| 中文社区 | https://claude.cn/community |
相关工具
| 工具 | 说明 |
|---|---|
| Claude for Slack | Slack 集成 |
| Claude for VS Code | VS Code 插件 |
| Claude for GitHub | GitHub Actions |
学习建议：从第 4 章"基础使用入门"开始动手，先熟悉日常命令，再逐步使用 ccswitch 管理配置。1 周可入门，2-3 周可熟练掌握高级功能。