🎛️ CC-Switch多Agent管理平台教程

📅 更新:2026-05-24 | ⏱️ 阅读时间:9分钟 | 🏷️ 标签:CC-Switch, 多Agent管理, Claude Code, OpenClaw

📋 目录

1. 为什么需要CC-Switch?

周一下午2点15分,我的桌面上有7个终端窗口在跑不同的AI助手:

然后我发现了CC-Switch——一个桌面应用,把这些「各自为政」的AI助手统一到一个界面里。

就像王家卫电影里那个突然把所有线索串起来的瞬间——原来它们可以是一个整体。

2. CC-Switch是什么?

💡 CC-Switch定义: 一个跨平台的桌面All-in-One助手管理器,支持Claude Code、Codex、OpenCode、OpenClaw、Gemini CLI、Hermes Agent等20+ AI工具的统一操控。

核心特性:

3. 安装与配置

3.1 下载安装

官方唯一网站:ccswitch.io

# macOS
brew install --cask cc-switch

# Windows (Scoop)
scoop bucket add extras
scoop install cc-switch

# Linux (AppImage)
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-linux.AppImage
chmod +x cc-switch-linux.AppImage
./cc-switch-linux.AppImage

# 或者通过源码编译(Rust)
git clone https://github.com/farion1231/cc-switch.git
cd cc-switch
cargo build --release

3.2 首次配置

启动CC-Switch后,进入 Settings > Agents 添加你的AI助手:

// 示例:添加OpenClaw
Agent Name: My OpenClaw
Command: openclaw
Args: ["start", "--no-gui"]
Working Dir: /home/user/.openclaw
Env: {
  "OPENCLAW_LOG_LEVEL": "info"
}
AutoStart: true

4. 支持的AI助手

AI助手 类型 CC-Switch支持
代码助手 ✅ 完整支持
OpenAI编码助手 ✅ 完整支持
个人AI助理 ✅ 完整支持(含Skills)
开源代码助手 ✅ 完整支持
Google AI助手 ✅ 完整支持
NousResearch ✅ 完整支持
本地Cowork应用 ✅ 支持
IDE集成 ⚠️ 部分支持

总计支持 20+ 款AI助手工具,并且还在快速增长中!

5. 使用教程

5.1 快速切换Agent

# 快捷键切换(默认)
Ctrl+1  -> Claude Code
Ctrl+2  -> Codex
Ctrl+3  -> OpenClaw
Ctrl+4  -> Gemini CLI
...

# 或者全局搜索(类似Spotlight)
Ctrl+K  -> 打开Agent选择器
输入 "open" -> 匹配到OpenClaw -> Enter启动

5.2 多Agent协作

CC-Switch支持「链式调用」——让多个Agent协同完成复杂任务:

# 场景:开发一个新功能
1. Claude Code: 编写代码
2. OpenClaw: 运行测试 + 格式化
3. Codex: Code Review
4. Gemini CLI: 生成文档

# 在CC-Switch中一键执行「Pipeline」
Pipeline: "dev-feature-x"
Steps:
  - Agent: claude-code
    Task: "Implement user auth"
  - Agent: openclaw
    Task: "Run tests and format"
  - Agent: codex
    Task: "Review the changes"

5.3 会话管理

功能 操作
保存会话Ctrl+S 或 点击保存按钮
加载会话Ctrl+O 或 File > Open Session
导出对话右键会话 > Export as Markdown
会话搜索Ctrl+F 搜索历史消息

6. 高级功能

6.1 自定义助手外观

// ~/.cc-switch/config.json
{
  "agents": {
    "openclaw": {
      "displayName": "我的OpenClaw",
      "icon": "/path/to/custom/icon.png",
      "color": "#3498db",
      "fontSize": 14,
      "theme": "dark"
    }
  }
}

6.2 共享配置同步

使用Git同步你的CC-Switch配置到多台设备:

cd ~/.cc-switch
git init
git add config.json agents/
git commit -m "Backup CC-Switch config"
git remote add origin git@github.com:user/cc-switch-config.git
git push -u origin main

# 在新设备上恢复
git clone git@github.com:user/cc-switch-config.git ~/.cc-switch

6.3 性能监控

CC-Switch内置资源监控,实时查看每个Agent的:

7. 与OpenClaw集成

7.1 最佳实践配置

// CC-Switch中的OpenClaw配置
{
  "name": "OpenClaw-Prod",
  "command": "openclaw",
  "args": ["start", "--with-voice", "--policy strict"],
  "env": {
    "OPENCLAW_LOG_LEVEL": "info",
    "OPENCLAW_SKILLS_PATH": "~/.openclaw/skills"
  },
  "autoRestart": true,
  "maxRestarts": 3,
  "healthCheck": {
    "url": "http://localhost:3000/health",
    "interval": 30000
  }
}

7.2 Skills管理

CC-Switch提供可视化的Skills管理界面:

7.3 跨Agent通信

让OpenClaw和Claude Code互相「对话」:

# 在OpenClaw中调用Claude Code
export default {
  name: "code-review-cross-agent",
  async execute(context) {
    const code = context.input;
    // 通过CC-Switch的IPC通道调用Claude Code
    const review = await context.ccSwitch.callAgent("claude-code", {
      prompt: `Review this code:\n${code}`
    });
    return review;
  }
}

8. 常见问题

Q1: CC-Switch和OpenClaw的Skills兼容吗?

答: 完全兼容!CC-Switch只是一个「外壳」,OpenClaw在内部依然正常运行,包括所有Skills和插件。

Q2: 可以同时运行几个Agent?

答: 理论上无限制,实际取决于你的系统资源。建议:

Q3: CC-Switch是开源的吗?

答: 是的!GitHub仓库:farion1231/cc-switch,使用Rust编写,性能极佳。

🎯 总结: CC-Switch就像是AI助手的「任务栏」——把散落在各个角落的Agent们统一管理起来。不再需要记住每个工具的启动命令,一个界面搞定所有。就像周星驰电影里那个万能管家,虽然出场不多,但关键时刻总能救场。

🔗 相关资源


🦞 妙趣AI - 让AI工具变得有趣又实用 | 返回首页 | 更多教程