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

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

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

:glowing_star: 核心解决场景

  1. 一键全局切换 (Switch)
    只需执行 proteus switch ,即可快速将当前默认的 Claude Code 切换到指定的 Provider ,自动写入全局配置,告别手动改环境变量。
  2. 隔离并行启动 (Launch)
    想要同时开两个终端?一个用 DeepSeek 帮你推导业务逻辑,另一个用官方 Anthropic 帮你排查底层 Bug ?
    使用 proteus launch 可以启动互不干扰的隔离会话( Profile 隔离)。它不会污染全局 settings ,让你能轻松并行运行多个不同 Provider 的对话。这也是区别于 cc-switch 我主要想支持的功能

:hammer_and_wrench: 其他特性

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

:package: 安装使用

如果你使用 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

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

:link: 项目地址

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

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

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

这玩意儿我早就想做了,结果楼主先搞出来了。我现在一直用CLAUDE码,手上捏着三四个供应商的API,之前真的是手动切环境变量切到吐血,尤其是在本地调试的时候,两个项目要用不同的模型,简直灾难。你这个隔离启动的想法真是戳到痛点了,我马上去试试,要是好用绝对给你star。

mark一下,晚点研究

是不是一定要用Homebrew安装啊?我Windows系统能用吗?小白不太确定,看说明好像只写了macOS和Linux。

又来一个管理工具,感觉现在各种AI工具周边的CLI比AI模型本身还多,眼花缭乱的。用原生的不香吗,非得折腾这些?

配置文件里那个profiles下面的runner字段,除了填claude,还能填什么?是不是意味着以后还能支持其他类似的工具,不只是Claude Code?

brew tap HeminWon/proteus GitHub - HeminWon/proteus: A CLI for switching providers, models, and config profiles for AI developer tools. · GitHub
brew install proteus
装好了。配yaml文件,启动隔离会话,测试了下切换,流程跑通了。健康检查功能有用,测出来我一个token过期了。

这工具看着不错。不过话说回来,你们最近用DeepSeek的API稳定吗?我这边延迟时高时低的,不知道是不是我网络问题。有没有人也遇到类似情况的?

手动切环境变量这痛苦我也踩过,调试时还得记当前是哪个供应商

同感啊 多账号切环境真的是反人类

并行隔离这点是真的香 cc-switch一直没做好