自由管理 codex cli、Claude code 等 API 中转商的 CLI 返代软件 Clipal,支持多供应商优先级、自动故障转移等 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
apple
V2EX    分享创造

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

  •  1
     
  •   apple 2025 年 12 月 25 日 1338 次点击
    这是一个创建于 34 天前的主题,其中的信息可能已经有所发展或是发生改变。

    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  
       2025 年 12 月 26 日
    试试,我正好在找这种功能精简的产品。

    只改 provider 吧?会影响其他配置吗?
    apple
        2
    apple  
    OP
       2025 年 12 月 26 日
    @shunia 不影响其他配置,只管 base_url 和 APIkey
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     5740 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 33ms UTC 02:37 PVG 10:37 LAX 18:37 JFK 21:37
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86