V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
apple
V2EX  ›  分享创造

自由管理 codex cli、Claude code 等 API 中转商的 CLI 返代软件 Clipal,支持多供应商优先级、自动故障转移等

  •  1
     
  •   apple · 2 天前 · 644 次点击

    Clipal:意思是 CLI 的伙伴

    https://github.com/lansespirit/Clipal

    项目是 go 语言的,直接编译成二进制文件,没有界面,不论 MacOS 、Linux 还是 Windows 都能运行,程序也就 6~8M ,不占用什么资源。直接 yaml 文件配置,支持热更新配置,方便后台静默运行。

    不管什么系统都可以按照教程一步步操作: https://github.com/lansespirit/Clipal/tree/main/docs/zh

    功能特性

    • 多 API 供应商配置,支持优先级排序,直接在配置文件定义供应商权重,我主要是为了排序高性价比的中转商

    • 自动故障转移:当前供应商失败时自动切换到下一个

    • Provider 临时禁用:鉴权/额度错误会自动 deactivate ,并按 reactivate_after 自动恢复

    • 配置热加载:更新 claude-code.yaml / codex.yaml / gemini.yaml 后自动重新加载并重新验证

    • 按日志级别输出运行日志( DEBUG/INFO/WARN/ERROR )

    • 三套独立配置文件,分别服务于:

        - Claude Code (claude-code.yaml)
      
        - Codex CLI (codex.yaml)
      
        - Gemini CLI (gemini.yaml)
      
    • 跨平台支持:macOS 、Linux 、Windows

    市面上已经有好几个类似的产品了,比如 ccNexus ,不过他们都有复杂的 GUI 界面和丰富的功能,而我只是想要一个简单的服务来管理多个中转商,对于 Claude 和 gpt 不同中转商的性价比和稳定性是不一样的。想要使用高性价比的中转服务,又要无感兜底。

    使用 Clipal 切换 CC 和 Codex 的 API 供应商就可以很丝滑了,基本无感,不用重启 CC 或者 Codex 了,Clipal 自动处理了。

    好吧,实话说,有时候也会蹭一些免费的 API ,只需要把免费 API 添加进配置,然后设置一个权重让他优先消耗即可。

    2 条回复    2025-12-26 16:44:41 +08:00
    shunia
        1
    shunia  
       1 天前
    试试,我正好在找这种功能精简的产品。

    只改 provider 吧?会影响其他配置吗?
    apple
        2
    apple  
    OP
       1 天前
    @shunia 不影响其他配置,只管 base_url 和 APIkey
    关于   ·   帮助文档   ·   自助推广系统   ·   博客   ·   API   ·   FAQ   ·   Solana   ·   3294 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 22ms · UTC 00:10 · PVG 08:10 · LAX 16:10 · JFK 19:10
    ♥ Do have faith in what you're doing.