Skip to content
开发中

Switch — 桌面端 AI 工具配置管理

桌面端统一管理多款 AI 编程命令行工具的配置与 MCP · 当前不在主动开发中

5 款管理 CLIClaude Code / Codex / Gemini / PicoClaw / NullClaw
<15MB包体积单 exe 零依赖
<2s启动Wails + Go 1.25 + React 18

什么是 Lurus Switch? ​

Lurus Switch 是一个桌面应用(单 exe 零依赖,< 15MB),让你用一个界面管理 5 款主流 AI 编程 CLI:Claude Code / Codex / Gemini CLI / PicoClaw / NullClaw 的配置、MCP 服务器和成本。基于 Wails(Go 1.25 + React 18)构建,启动 < 2 秒,支持 Windows / macOS / Linux 全平台。

当前开发者同时使用 Claude Code、Codex、Gemini CLI 等多个 AI CLI,配置散落各处、成本各自为政。Switch 将这一切集中管理。

一个界面,告别四处翻配置

配置可视化编辑、MCP 跨工具同步、成本按工具/模型聚合——不用再分别打开每个 CLI 的 dotfile。

核心能力

一站式管理你的全部 AI CLI

配置、MCP、成本、密钥、代理——常用的运维动作都在同一个窗口里完成。

多 CLI 配置管理

可视化编辑 Claude Code / Codex / Gemini CLI / PicoClaw / NullClaw 配置,Monaco Editor 实时预览。

CLAUDE.md 智能助手

扫描项目自动生成 CLAUDE.md,质量评分,给出优化建议。

MCP 服务器可视化

告别手写 JSON,可视化配置 MCP 服务器,跨工具同步。

成本监控仪表盘

实时 Token 消耗趋势,按工具/模型分类,预算预警。

API Key 统一管理

跨工具统一存储和使用,安全加密。

代理与网络

系统代理自动检测,Clash / V2Ray 一键配置,API Endpoint 自定义。

配置快照

保存 / 恢复 / 对比 diff,试错零成本。

Prompt 模板库

内置高质量模板 + 自定义管理 + 导入导出。

进程管理

CLI 进程监控:列表 / 终止 / 启动 / 输出查看。

自动更新

GitHub Releases 自更新 + 工具版本检查。


工作原理 ​

四种运行模式 ​

首次启动时 Switch 让你选一种运行模式,之后整个界面按这个模式裁剪。白标分发出去的 EndUser 构建会跳过这一步——它出厂就锁定在 EndUser 模式,直接进激活流程。

Lurus Switch mode state machineState diagram of Lurus Switch's four launch modes -- Personal, Reseller, Enterprise, or a direct EndUser pick -- plus Reseller-minted white-label installers that boot straight into EndUser, and EndUser's redemption/heartbeat lifecycle moving between Unactivated, Active, and Revoked/Mismatch.ENDUSERPICKPICKPICKPICKSWITCH MODESWITCH MODEMINT INSTALLERREDEEM CODEHEARTBEAT FAILRESETPersonalsolo dev · Lurus HubResellerruns hub · mints buildsEnterpriseSSO users · DLP gateUnactivatedno token yetActiveheartbeat runningRevoked / Mismatchneeds re-activationAPP LAUNCHLURUS SWITCH · 2C-GUI-SWITCHMode State MachineLEGENDTRANSITIONFOCAL MODEENDUSER STATES* SWITCH MODE = any unlocked mode can switch to any other via Settings · a MINT INSTALLER build is locked to EndUser until RESET
四种模式(Personal / Reseller / Enterprise / EndUser)从首次启动分叉;只有 EndUser 这一支带激活状态机 —— 未激活 → 激活(心跳运行中)→ 心跳校验失败则落到「已吊销 / 指纹不匹配」需要重新激活。回到未激活只有手动清除激活信息一条路,心跳失败不会把设备退回未激活态。2c-gui-switch · 与仓库 README 同一张图

本地网关 ​

Switch 内置一个本地网关,在 127.0.0.1 上暴露 OpenAI 兼容端点,把应用的调用统一转发到你配置的上游:

项值说明
默认端口19090在设置里可改,改完下次启动生效
默认是否自启否autoStart 默认 false,要手动开或在设置里打开
启动前置必须先配上游地址未配置时启动直接报错退出,不会静默起一个转发不出去的端口
监听地址仅 127.0.0.1不对局域网暴露

暴露的路径:/v1/chat/completions、/v1/completions、/v1/embeddings、/v1/models 及 /v1/ 兜底走通用代理;/v1/messages 走单独的 Anthropic Messages 格式处理;另有免鉴权的 /health 与 /switch/v1/status、/switch/v1/balance。上游支持按优先级排序的回落链,前一个不可用时依次尝试下一个。

接入只改一处 base_url

网关起来之后把应用的 base_url 指到 http://localhost:19090/v1,原有 OpenAI SDK 调用即可接通;回落与路由规则在 Switch 里集中维护,应用代码无需感知。

本地模型是「探测」不是「代理」

Switch 会扫描本机的 Ollama(http://127.0.0.1:11434)并把可直接使用的环境变量片段列出来供你复制。那个端口是 Ollama 的,不是 Switch 的——本地模型的流量不经过 Switch 网关。

适用场景

谁在用 Switch

  1. 多 CLI 用户多 CLI 管理同时使用 Claude Code / Codex / Gemini CLI / PicoClaw / NullClaw 中的多个,需要统一配置管理。
  2. 成本负责人成本控制多 CLI 并行使用,需要统一的费用视图和预算管控。
  3. 技术团队团队标准化统一配置分发,确保团队成员使用一致的 AI CLI 设置。
  4. 中国开发者国内网络需要翻墙配置、中文界面、国内 / 海外模型一键切换。

与其他方案对比 ​

维度SwitchAiderCursor手动管理
CLI 覆盖5 款统一1 款内置 IDEN/A
MCP 管理可视化 + 同步无单独配手写 JSON
成本监控聚合仪表盘无无无
团队同步Git + Vault无无无

支持的平台 ​

平台版本要求
WindowsWindows 10 64-bit 及以上
macOSmacOS 12 (Monterey) 及以上
LinuxUbuntu 20.04 / Debian 11 及以上

下一步 ​

下一步

Powered by Lurus Technologies