CC Switch · Claude Code 环境

在 VS Code 中管理 Claude Code 的环境预设，替代 Skyrain Claude Code Env Switcher。当前版本：1.1.1。

日常使用

• 点击状态栏的 Claude · 环境名，在中央编辑器标签页打开完整管理界面。快捷键 Ctrl+Alt+Shift+E（Mac：Cmd+Alt+Shift+E）。
• 点击左侧 CC Switch 图标查看环境列表；视图顶部和标题栏的「在编辑器中打开」也能打开完整管理界面。
• Ctrl+Alt+E（Mac：Cmd+Alt+E）仍可快速切换环境。
• 命令面板执行 CC Switch: 在编辑器中打开 (Open Panel)。重复打开会聚焦已有标签页，关闭后可再次打开。
• VS Code 的「Move View to Panel」将视图移动到终端所在的 Panel 区域（默认底部），与中央编辑器不同。视图根据宽度自动采用列表或卡片网格，移动到宽面板后能利用横向空间。
• 可搜索名称/地址、新建、编辑、删除环境，或将当前配置保存为预设。
• 「编辑预设文件」打开 ~/.claude/envs.json；「打开当前配置」打开 ~/.claude/settings.json。
• 命令面板提供「CC Switch: 导入/导出配置」。导入只新增不存在的 ID，保留已有环境；导出文件包含认证信息，请只放在自己的安全目录。

从 Skyrain 迁移

使用相同的 ~/.claude/envs.json：

{
  "presets": [
    {
      "id": "example",
      "label": "示例环境",
      "description": "我的 API 配置",
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.example.com/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "在本机填写",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "模型名"
      }
    }
  ]
}

安装后自动读取已有预设，不自动切换当前环境。新建/编辑使用 VS Code 原生输入框，认证值不送往 Webview。修改前保留备份于 .claude/cc-switch-vscode-backups/。

切换会保留 hooks、权限和无关环境变量，同时清除上一供应商的旧变量。切换对新会话生效，已运行的 Claude Code 会话需要重启。若桌面版 CC Switch 正在接管代理，请先关闭接管。

安装与开发

从安装包：

code --install-extension artifacts/cc-switch-1.1.1.vsix --force

从源码：

npm ci
npm run build
npm test
npm run package

按 F5 可启动扩展开发宿主。包内含 Webview 与 SQLite WASM 资源，无需用户安装依赖。插件 ID：Cooperiano.cc-switch。本版界面聚焦 Claude Code 环境切换；其他客户端请继续使用 CC Switch 桌面版或官方 CLI。通过 Remote SSH 使用时，管理的是扩展宿主所在机器的配置。

迁移来源见 MIGRATION.md，验证记录见 VALIDATION.md，更新内容见 CHANGELOG.md。

MIT License。