V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member  Sign In
HeMinWon
V2EX  ›  Claude

[开源] Proteus - 一个用于管理和无缝切换 Claude Code Provider 的 CLI 工具,支持并行隔离会话

  •  
  •   HeMinWon · 1 day ago · 636 views

    大家好,今天想和大家分享一个我自己开发的开源小工具 —— Proteus 。

    如果你经常使用 Claude Code ,并且手里有多个大模型 API 供应商(比如官方 Anthropic 、DeepSeek 、GLM 或者其他兼容的中转),你可能会发现来回修改环境变量和配置非常繁琐。Proteus 就是为了解决这个痛点而生的。

    🌟 核心解决场景

    1. 一键全局切换 (Switch) 只需执行 proteus switch <provider>,即可快速将当前默认的 Claude Code 切换到指定的 Provider ,自动写入全局配置,告别手动改环境变量。

    2. 隔离并行启动 (Launch) 想要同时开两个终端?一个用 DeepSeek 帮你推导业务逻辑,另一个用官方 Anthropic 帮你排查底层 Bug ? 使用 proteus launch <profile> 可以启动互不干扰的隔离会话( Profile 隔离)。它不会污染全局 settings ,让你能轻松并行运行多个不同 Provider 的对话。这也是区别于 cc-switch 我主要想支持的功能

    🛠 其他特性

    • 统一配置管理:在一个 .yaml 文件中集中管理所有的 Token 和配置。
    • 共享配置同步:自动将全局的共享 Claude 配置项(如 commands 、skills 、plugins 、agents )同步到隔离的 Profile 环境中。
    • 配置健康检查:支持 proteus validate ,带有实时 HTTP 检查功能,配置填错或 Token 失效一测便知。

    📦 安装使用

    如果你使用 macOS / Linux ,可以直接通过 Homebrew 安装:

    brew tap HeminWon/proteus https://github.com/HeminWon/proteus
    brew install proteus
    

    配置十分简单,准备一个 ~/.config/proteus/providers.yaml 填入你的配置即可:

      version: 1
      providers:
        - id: anthropic
          name: Anthropic Official
          claude:
            env:
              ANTHROPIC_AUTH_TOKEN: "your-token"
    
      profiles:
        default:
          provider: anthropic
          runner: claude
    

    可自定义路径方便自己同步配置

    🔗 项目地址

    GitHub: https://github.com/HeminWon/proteus

    项目是用 Go 开发的,遵循 MIT 协议完全开源。如果你也是 Claude Code 的重度用户,且有管理多套大模型 Provider 的需求,欢迎下载体验。

    如果觉得对你有帮助,求个 Star ⭐️ 支持一下。欢迎在下面交流讨论,或者在仓库提交 Issue / PR !

    10 replies    2026-05-07 17:36:36 +08:00
    peter986
        1
    peter986  
       12h 33m ago
    这个用 cc Switch 岂不是更方便
    Leoking222
        2
    Leoking222  
       12h 8m ago
    cc Switch:???
    HeMinWon
        3
    HeMinWon  
    OP
       11h 54m ago
    @peter986 cc-switch 貌似不支持同时跑多个 privider, 这个解决可以开终端 A 跑一个配置的同时再开终端 B 跑另外一个配置、有这样的需求的话这个方便一点
    wangqi060934
        4
    wangqi060934  
       11h 50m ago
    @HeMinWon cc-switch 在供应商列表中每一项供应商的右侧有个“打开终端”的按钮,通过这个打开的终端就是通过 claude --settings 指定临时供应商启动的
    wuzy1994
        5
    wuzy1994  
       11h 21m ago
    看着不错 等会试一下
    HeMinWon
        6
    HeMinWon  
    OP
       10h 36m ago
    @wangqi060934 感谢提醒、我也了解下、不过这个工具也有些优势、可以纯命令在服务器的场景也适用
    prosgtsr
        7
    prosgtsr  
       10h 4m ago
    Proteus ?这名字和一个仿真软件撞车了。。
    HeMinWon
        8
    HeMinWon  
    OP
       7h 1m ago
    @prosgtsr 😅
    prosgtsr
        9
    prosgtsr  
       6h 45m ago
    @HeMinWon 主要这还是个知名软件,对后续发展不利。
    HeMinWon
        10
    HeMinWon  
    OP
       4h 24m ago
    @prosgtsr hah 我想想 叫 claude-xxx 算了
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   3263 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 38ms · UTC 14:01 · PVG 22:01 · LAX 07:01 · JFK 10:01
    ♥ Do have faith in what you're doing.