VarSwitch

VarSwitch 是一个面向 Claude Code、Claude Desktop、Codex CLI、Grok CLI、Gemini CLI 和 API 用户的桌面配置管理工具。它通过可视化界面集中管理 API Key / Token、Base URL、模型、编辑器设置、多套应用配置、Skills、Prompts 预设、MCP Server、本机历史会话、Codex 插件市场与移动端控制能力，并提供托盘快速切换、本地代理故障转移、varswitch:// 深链导入与多设备数据同步。

当前应用版本：3.2.12。

主要功能

1. Claude Code 配置管理

• 多配置管理：创建、编辑、删除多套 Claude Code/API 配置。
• 供应商预设：内置 11 个供应商预设（Anthropic 官方、DeepSeek、Kimi、智谱 GLM、MiniMax、阿里云百炼、火山方舟 Coding Plan、百度千帆、美团 LongCat、SiliconFlow、OpenRouter），也支持自定义。
• 配置字段：支持配置名称、Token/API Key、Base URL、可选模型 ID。
• 角色模型映射：每套配置可选填 Sonnet / Opus / Haiku 三个角色模型，分别写入 ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL，留空则不设置并清理旧值。
• OpenAI 兼容供应商：「API 格式」选择 OpenAI Chat Completions 时，ANTHROPIC_BASE_URL 指向本地协议转换代理（127.0.0.1:25789），由代理在 Anthropic 与 OpenAI 协议之间双向翻译（含流式响应与工具调用），可直接接入仅提供 OpenAI 接口的上游；该模式需保持 VarSwitch 运行。
• 导入当前配置：从当前系统环境变量、Claude 设置或编辑器设置中导入已有配置。
• 一键切换：点击配置卡片的切换按钮后，同步写入：
  • 系统环境变量：ANTHROPIC_AUTH_TOKEN / ANTHROPIC_AUTH_KEY、ANTHROPIC_BASE_URL，以及角色模型映射变量
  • 兼容旧变量：读取并清理/兼容 ANTHROPIC_API_KEY
  • Claude 配置：~/.claude/settings.json 的 env
  • 支持的编辑器 settings.json 中的 claudeCode.environmentVariables
• 实时状态检查：首页展示系统环境变量、Claude 设置、各编辑器设置是否与当前配置同步。
• 切换进度与取消：切换过程中显示系统环境变量、编辑器、Claude 等步骤进度，并支持取消切换。
• 手动同步：当前有活动配置时，可使用 Sync Now 重新写入当前配置。
• 接口测速：添加/编辑配置时可对 Base URL 做连通性和延迟测试。
• 余额查询：配置卡片直接显示 API Key 的剩余余额，支持 DeepSeek、Kimi（月之暗面）、SiliconFlow、OpenRouter 官方接口以及 NewAPI / one-api 系中转站的通用计费接口；悬停可查看总额度、已用、充值/赠送明细，可点击刷新，结果本地缓存（10 分钟内不重复自动查询）。Claude / Codex / Grok / Gemini / OpenCode 五个配置列表均支持。
  • 中转站把令牌设为「不限额度」时，其计费接口会返回 1e8 这类占位上限（one-api 源码中 UnlimitedQuota 即固定返回 100000000），直接相减会得出「余额 $99,999,971」的假数字，因此这种情况只展示真实的已用金额。
  • 站点访问令牌：想看中转站账户里真正剩多少钱，可点击余额行的钥匙图标，填入站点后台「个人设置」生成的系统访问令牌（不是 sk- 开头的 API Key）。令牌按站点域名保存，同一中转站的多套配置共用一份；new-api 站点还需填写数字用户 ID（写入 New-Api-User 请求头），one-api 站点留空即可。配置后余额改为读取 /api/user/self 的账户额度，并按站点 /api/status 返回的 quota_per_unit 换算金额。
  • 令牌与 API Key 同等对待：以私有权限原子写入数据目录的 site_balance_tokens.json，界面只回显打码值，日志不记录。令牌查询失败时会退回计费接口，数值标黄并在悬停提示中给出站点返回的原始错误。
  • 查询在后台线程执行并限制并发，不会阻塞界面；识别不出计费接口的站点显示「不支持」，Key 失效则显示具体的 HTTP 错误。
• 拖拽排序：配置卡片提供拖拽手柄，可调整列表顺序并自动保存；Codex、Grok、Gemini 配置列表同样支持。

2. Claude Desktop 第三方 API

• 独立配置列表：在 Claude Desktop 页面维护专用供应商，也可以从 Claude Code 配置复制导入；导入后两边独立管理，后续编辑互不影响。
• 三种连接模式：Official 恢复 Claude 官方连接；Direct 将 Anthropic Messages 上游直接写入 Claude Desktop；Gateway 由 VarSwitch 在本机转换并转发 Anthropic Messages 或 OpenAI Chat Completions 上游。
• 角色模型映射：可分别配置默认、Sonnet、Opus、Haiku 上游模型；Claude Desktop 请求稳定的 Claude 角色模型名称，本地 Gateway 再映射到供应商模型。
• 独立高可用状态：Gateway 使用独立于 Claude Code 的主上游、备用池、熔断器和健康统计，互不覆盖运行状态。
• 本地鉴权：Gateway 使用 VarSwitch 随机生成并持久化的本地路由凭据，不使用 PROXY_MANAGED，也不会把本地路由凭据转发给第三方上游。
• 事务写入：启用或同步配置时保留 Claude Desktop 文件中的未知字段和其他 Profile；任一文件写入失败会恢复全部相关文件及原活动状态。
• 平台限制：Windows 和 macOS 支持写入并启用 Claude Desktop 3P Profile；Linux 可保存供应商，但不支持启用 3P Profile。

3. 本地代理故障转移

针对经本地协议转换代理的 OpenAI 兼容配置，提供高可用能力：

• 备用上游池：在其他 OpenAI 兼容格式的配置中勾选「加入代理故障转移池」，即可作为备用上游。
• 自动故障转移：请求候选顺序为当前激活配置加池内配置（按列表顺序）。在尚未向客户端返回任何数据前，连接失败/超时、5xx、429 会自动换下一个候选重试；4xx 视为配置问题直接返回；流式响应一旦开始转发不再切换。
• 熔断器：单个上游连续失败 3 次后熔断 60 秒，期间跳过该上游；到期进入半开状态放行一个探测请求，成功则恢复，失败则重新熔断。
• 代理健康面板：激活配置走本地代理时，Claude 页显示代理运行状态、主/备上游、失败与总请求数、自动转移次数、最近错误，并支持一键重置熔断器。

4. 编辑器同步

VarSwitch 会自动检测并同步下列编辑器的 Claude Code 设置：

• VS Code
• VS Code Insiders
• Cursor
• Windsurf
• Trae
• VSCodium

在「Settings / 设置」中可以为每个编辑器手动指定 settings.json 路径；也可以填写用户配置目录，应用会自动补全为 settings.json。

5. Codex CLI 配置管理

• Codex 独立配置列表：在 Codex CLI 页面维护 Codex 专用配置。
• 配置字段：配置名称、API Key、Base URL、模型、Provider、写入方式。
• Provider 预设：内置 13 个 Provider 预设（OpenAI 官方、DeepSeek、Kimi、智谱 GLM、MiniMax、SiliconFlow、OpenRouter、阿里云百炼、火山方舟 Coding Plan、百度千帆、美团 LongCat、Groq、心流 iFlow），也支持自定义。
• 两种写入方式：
  • 默认写入：写入 ~/.codex/auth.json 和 ~/.codex/config.toml
  • 官方账号/API 额度模式：只写入 ~/.codex/config.toml，不改动 auth.json
• Codex 当前状态：读取并展示 Codex 当前 API Key、Base URL、模型、Provider 等状态。
• Codex 诊断：检查 ~/.codex/config.toml、~/.codex/auth.json 是否存在，是否包含模型、Provider、Base URL、API Key，并给出修复建议。
• Codex 运行时备份：可一键备份 config.toml 和 auth.json。
• 手动同步：当前有活动 Codex 配置时，可使用 Sync Now 重新写入。

6. Grok CLI 与 Gemini CLI 配置管理

• Grok 独立配置列表：内置 4 个 xAI 预设（Official、Grok Fast、Grok 4.5、Grok Build），也支持自定义。切换时写入 ~/.grok/config.toml（把默认模型指向 VarSwitch 托管的模型段，保留文件中的其他内容），并同步 XAI_API_KEY / XAI_BASE_URL、GROK_API_KEY / GROK_BASE_URL 等系统环境变量。
• Gemini 独立配置列表：切换时写入 ~/.gemini/settings.json（认证方式与模型），并同步 GEMINI_API_KEY、GOOGLE_GEMINI_BASE_URL、GEMINI_MODEL 系统环境变量。
• 当前状态：读取并展示 Grok / Gemini 当前生效的配置来源、Base URL 与模型。

7. Codex Toolbox

Codex 页面提供 Codex Toolbox，包含三个主要模块。

Plugin Market

• 查看当前 Codex 插件市场配置。
• 安装/应用插件市场到 Codex。
• 支持多个来源类型，包括 GitHub、GitCode、本地路径等。
• 保留已有插件市场片段并写回 ~/.codex/config.toml。
• 检测 OpenAI Codex 内置插件市场。
• 修复 OpenAI bundled 插件市场配置。
• 查看内置插件状态、已启用数量、关键插件启用情况。
• 一键启用关键插件，例如 Computer Use / Chrome 相关插件。

Session Sync

• 扫描本机 Codex 会话记录。
• 将本地 Codex 历史会话同步到 VarSwitch。
• 展示已同步会话数量、最后同步时间和会话预览。
• 为移动端控制选择可操作的 Codex 会话。

Mobile Control

• 将移动平台消息转发到指定 Codex 会话，实现手机端控制。
• 支持绑定/配置：
  • 飞书 / Lark
  • QQ
  • 微信
• 支持配置平台凭据，如 App ID、App Secret、Bot Token、Account ID、Base URL、User ID、Bot Open ID、Gateway URL。
• 支持扫码绑定 QQ、微信。
• 支持飞书/Lark 机器人创建、注册轮询和已有机器人绑定。
• 支持选择/绑定/解绑 Codex 会话。
• 支持启动/停止平台监听。
• 支持高级控制状态检测、协议事件日志和待审批请求提交。

8. 会话管理器

「会话（Sessions）」页面用于管理本机 CLI 历史会话：

• 聚合扫描 Claude Code（~/.claude/projects）与 Codex（~/.codex/sessions、~/.codex/archived_sessions）的会话记录。
• 列表展示会话标题、工作目录与更新时间，按更新时间降序排列。
• 支持按标题、目录或会话 ID 搜索，并按来源（全部 / Claude / Codex）筛选。
• 一键恢复：Claude 会话在新终端窗口执行 claude -r <会话ID>（原工作目录仍存在时先切换过去）；Codex 会话通过 codex://threads/<ID> 深链在桌面应用中打开。

9. Skills 管理

顶部工具栏的 Skills 入口用于管理 Claude Code 扩展能力：

This is the beginning of the README. Read the rest at the original. Read the full README ↗