Copilot Switch

🔄 GitHub Copilot CLI / Claude Code 代理配置可视化管理工具

图形化管理多套 LLM 提供商配置，一键启动 Copilot CLI / Claude Code 自动注入环境变量。
告别手动 export / set，像切换浏览器标签页一样切换 AI 模型。

• Web GUI — 浏览器访问，可视化增删改查多套提供商配置
• 双页签管理 — 🤖 Copilot BYOK + 🧠 Claude Code 代理配置，一键切换
• 一键启动 — cps / claudes 命令列出所有配置并选择后启动对应 CLI
• CLI 启动器 — cps / claudes 命令支持交互式选择 provider
• 多提供商 — 支持 OpenAI 兼容端点、Azure OpenAI、Anthropic
• 脱机模式 — 支持本地模型（Ollama、vLLM 等）
• API Key 保护 — 密码框 + 👁 切换明文，配置持久化时有掩码
• 实时预览 — 编辑时动态显示将设置的环境变量
• 零依赖前端 — 纯 HTML/CSS/JS，无需 Node.js

• Python 3.8+
• GitHub Copilot CLI 或 Claude Code 已安装
• 至少一个 LLM 提供商的 API Key 或本地模型

git clone https://github.com/YOUR_USERNAME/copilot-switch.git
cd copilot-switch
pip install -r requirements.txt

python copilot_switch.py
# 浏览器打开 http://127.0.0.1:5000

或者双击 run.bat（自动安装依赖 + 启动服务 + 打开浏览器）。

# 将目录加入 PATH
setx PATH "%PATH%;E:\copilot_switch"

# 之后在任意终端：
cps              # 列出所有 Provider，选择后启动 Copilot CLI
cps --help       # 传递参数给 Copilot CLI
claudes          # 列出所有 Provider，选择后启动 Claude Code
claudes --help   # 传递参数给 Claude Code

打开 Web GUI 后，在顶部页签栏点击 🤖 Copilot 或 🧠 Claude 切换管理目标。两个页签的数据完全独立，互不干扰。

点击「+ 添加配置」，填写表单：

Copilot 页签：

• 名称：给这个配置起个名字（如 "OpenAI GPT-4o"）
• 提供商类型：选择 openai / azure / anthropic
• Base URL：API 端点地址
• API Key：你的 API 密钥（支持 👁 切换明文）
• 模型名称：如 gpt-4o、claude-sonnet-4-5、llama3.2
• Max Tokens：可选，不填使用默认值
• 脱机模式：本地模型勾选此项 + COPILOT_OFFLINE=true

Claude 页签：

• 名称：给这个配置起个名字（如 "Claude via DeepSeek"）
• Base URL：代理端点地址
• API Key：你的 API 密钥
• 模型名称：如 claude-sonnet-4-5
• Default Sonnet/Opus/Haiku Model：可选，留空则使用模型名称
• 禁用非必要流量：默认勾选，避免向 Anthropic 发送遥测数据

编辑时可实时预览将设置的环境变量。

在配置卡片上点击 激活，当前使用的配置会有绿色边框和 ✓ 标识。

页面底部「📋 当前配置预览」面板会显示激活配置的完整环境变量设置，API Key 默认掩码可切换。

在任意终端运行 cps 或 claudes，会列出所有已配置的 Provider，当前激活的会用 * 标记。按回车确认默认选择，或输入数字切换到其他 Provider：

可用 Provider 列表：

   [1] Provider A (openai)
 * [2] Provider B (anthropic)
   [3] Provider C (openai)

[*] 表示当前激活的配置

请选择 Provider [直接回车使用默认*2]: _

cps              # 交互式选择 Provider 后启动 Copilot CLI
cps --help       # 传递参数给 Copilot CLI
claudes          # 交互式选择 Provider 后启动 Claude Code
claudes --help   # 传递参数给 Claude Code

copilot-switch/
├── copilot_switch.py       # Flask 后端（Copilot + Claude 双配置 CRUD）
├── cps.py                  # Copilot CLI 启动器
├── cps.bat                 # Copilot CLI Windows 批处理包装器
├── claudes.py              # Claude Code CLI 启动器
├── claudes.bat             # Claude Code Windows 批处理包装器
├── cpss.bat                # 一键启动 GUI（安装依赖 + 启动服务 + 打开浏览器）
├── requirements.txt        # Python 依赖
├── templates/
│   └── index.html          # Web UI 单页（🤖 Copilot / 🧠 Claude 双页签）
├── static/
│   ├── style.css           # 样式
│   └── app.js              # 前端逻辑
└── README.md

Copilot 配置保存在 ~/.copilot/providers.json 中：

{
  "active": "abc123",
  "providers": [
    {
      "id": "abc123",
      "name": "OpenAI GPT-4o",
      "type": "openai",
      "base_url": "https://api.openai.com/v1",
      "api_key": "sk-xxx",
      "model": "gpt-4o",
      "max_output_tokens": null,
      "max_prompt_tokens": null,
      "offline": false
    }
  ]
}

Claude 配置保存在 ~/.claude/providers.json 中：

{
  "active": "abc123",
  "providers": [
    {
      "id": "abc123",
      "name": "Claude via DeepSeek",
      "base_url": "https://api.deepseek.com/anthropic",
      "api_key": "sk-xxx",
      "model": "claude-sonnet-4-5",
      "sonnet_model": null,
      "opus_model": null,
      "haiku_model": null,
      "disable_nonessential_traffic": true
    }
  ]
}

Q: 启动后终端显示乱码？
A: 确保终端编码为 UTF-8，cpss.bat 已自动设置 chcp 65001。

Q: cps / claudes 命令找不到？
A: 需将 copilot-switch 目录加入系统 PATH。运行：

setx PATH "%PATH%;你的目录路径"

Q: Copilot CLI 提示 token 警告？
A: Copilot Switch 始终注入 COPILOT_PROVIDER_MAX_OUTPUT_TOKENS 和 COPILOT_PROVIDER_MAX_PROMPT_TOKENS 环境变量，默认值分别为 128000 和 840000。

Q: 如何同时管理 Copilot 和 Claude 配置？
A: 打开 Web GUI，通过顶部页签 🤖 Copilot / 🧠 Claude 切换。两个页签的数据独立存储在 ~/.copilot/ 和 ~/.claude/ 目录下。

Q: Claude Code 代理需要配置哪些字段？
A: 至少需要 Base URL 和模型名称。Sonnet/Opus/Haiku 模型名可选，留空则统一使用模型名称。建议勾选"禁用非必要流量"以避免遥测。

Q: API Key 安全吗？
A: Key 存储在本地 providers.json 中，不会上传。Web UI 仅监听 127.0.0.1，外网无法访问。建议不要将 providers.json 提交到公共仓库。

MIT License

• GitHub Copilot CLI 官方文档
• BYOK 使用说明