个人开发者工具组合教程

本教程介绍如何搭建 Claude Code + CC Switch + Serena 的个人开发环境，实现高效的 AI 辅助编程工作流。

---

🎯 组合优势

工具	作用	解决的问题
Claude Code	AI 编程助手	代码生成、调试、重构
CC Switch	配置管理	多 API 快速切换、MCP 管理
Serena	语义分析	大型代码库导航、精确编辑

组合效果：

• 🚀 开发效率提升 3-5 倍
• 🎯 代码理解准确率 95%+
• ⚡ 多 API 配置秒级切换

---

📦 第一步：安装 Claude Code

macOS / Linux

# 方式一：官方脚本（推荐）
curl -fsSL https://claude.ai/install.sh | bash

# 方式二：Homebrew
brew install --cask claude-code

# 方式三：npm
npm install -g @anthropic-ai/claude-code

🎬 安装验证演示

claude --versionclaude-code v1.0.33claudeWelcome to Claude Code!

Windows

# PowerShell 安装
irm https://claude.ai/install.ps1 | iex

# 或使用 npm
npm install -g @anthropic-ai/claude-code

验证安装

claude --version
# 输出类似：Claude Code v1.x.x

首次配置

# 进入项目目录
cd your-project

# 启动 Claude Code（首次会引导登录）
claude

---

🖥️ 第二步：安装 CC Switch

下载安装

1. 访问 CC Switch Releases
2. 下载对应平台的安装包：
   • Windows: CC-Switch-x.x.x-setup.exe
   • macOS: CC-Switch-x.x.x.dmg
   • Linux: CC-Switch-x.x.x.AppImage

初始配置

1. 启动 CC Switch
2. 添加 Provider：
   • 点击"添加 Provider"
   • 选择预设或自定义配置

配置示例

官方 API 配置

{
  "name": "Anthropic 官方",
  "baseUrl": "https://api.anthropic.com",
  "apiKey": "sk-ant-xxx..."
}

第三方 API 配置

{
  "name": "自定义 API",
  "baseUrl": "https://api.whaty.org",
  "apiKey": "your-api-key"
}

切换 Provider

方式一：主界面

1. 选择 Provider
2. 点击"启用"
3. 重启终端

方式二：系统托盘（推荐）

1. 点击托盘图标
2. 直接选择 Provider
3. 即时生效

---

🔧 第三步：安装 Serena

前置要求

安装 uv 包管理器：

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

配置 MCP 服务器

方式一：通过 CC Switch 配置

1. 打开 CC Switch
2. 点击右上角"MCP"按钮
3. 添加新服务器：

{
  "name": "serena",
  "command": "uvx",
  "args": ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--workspace", "${workspaceFolder}"]
}

方式二：手动配置

编辑 ~/.claude/settings.json：

{
  "mcpServers": {
    "serena": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/oraios/serena",
        "serena", "start-mcp-server",
        "--workspace", "/path/to/your/project"
      ]
    }
  }
}

验证 Serena

# 启动 Claude Code
claude

# 测试 Serena 工具
> 使用 find_symbol 查找 main 函数

---

🚀 第四步：工作流实践

日常开发流程

1. 启动 CC Switch（系统托盘常驻）
2. 选择合适的 API Provider
3. 进入项目目录
4. 启动 Claude Code
5. 利用 Serena 进行代码导航

场景一：新功能开发

# 1. 进入项目
cd my-project

# 2. 启动 Claude Code
claude

# 3. 让 Claude 理解项目结构（Serena 自动增强）
> 分析这个项目的架构，找到用户认证相关的代码

# 4. 开发新功能
> 在 UserService 类中添加一个 resetPassword 方法

场景二：代码重构

# 1. 使用 Serena 的符号查找
> 使用 find_referencing_symbols 查找所有调用 oldMethod 的地方

# 2. 批量重构
> 将所有 oldMethod 重命名为 newMethod，并更新调用处

场景三：Bug 调试

# 1. 描述问题
> 用户登录时报错 "Invalid token"，帮我定位问题

# 2. Serena 帮助定位
> 使用 find_symbol 查找 validateToken 函数

# 3. 修复并测试
> 修复这个 bug 并编写测试用例

---

⚙️ 高级配置

CC Switch 云同步

1. 进入设置 → "自定义配置目录"
2. 选择云同步文件夹（如 Dropbox）
3. 重启应用
4. 在其他设备重复操作

Serena 多语言支持

Serena 通过 LSP 支持 30+ 语言，确保安装对应的 Language Server：

语言	Language Server
Python	pylsp / pyright
JavaScript/TypeScript	typescript-language-server
Go	gopls
Rust	rust-analyzer
Java	jdtls

性能优化

# 大型项目建议配置
# 在 CLAUDE.md 中添加：

## 项目配置
- 使用 Serena 进行代码导航
- 优先使用符号级操作而非全文搜索
- 每次只处理一个模块

---

🔍 常见问题

Q: CC Switch 切换后不生效？

A: 需要重启终端或 Claude Code：

# 关闭当前 Claude Code
exit

# 重新启动
claude

Q: Serena 连接失败？

A: 检查 uv 是否正确安装：

uv --version
# 如果报错，重新安装 uv

Q: 如何查看当前使用的 API？

A: 在 Claude Code 中：

> /config
# 或查看环境变量
echo $ANTHROPIC_BASE_URL

---

📊 效果对比

指标	仅 Claude Code	完整组合
API 切换时间	手动编辑配置	1 秒
代码定位准确率	70%	95%
大型项目导航	较慢	快速
配置管理	分散	统一

---

🎓 下一步

• 团队协作组合教程 - 多人协作开发
• 企业部署组合教程 - 企业级部署方案
• Claude Code 中文社区技巧 - 更多技巧

---

最后更新：2025年12月