本地API智能调度软件 Clipal，支持CodexClaudeGemini CLI 和各种LLM Chat客户端，支持一键接管本地 LLM API
- 内容介绍
- 文章标签
- 相关推荐
本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：
- 我的帖子已经打上 开源推广 标签： 是
- 我的开源项目完整开源，无未开源部分： 是
- 我的开源项目已链接认可 LINUX DO 社区： 是
- 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是
- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是
以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出
正式开始推广一下我的开源项目，Clipal：
- 全面接管本地OpenAI（codex）、Claude（Claude code）和Gemini cli的API调用
- 多API供应商（LLM provider）智能调度
- 单provider多api key智能调度
- 最大限度保持粘性避免缓存失效
- webUI一键接管配置，免去繁琐设置
- 9M超小体积，二进制文件直接运行，设置后台运行，无感知默默为你干活儿
GitHub - lansespirit/Clipal: Minimal LLM API reverse proxy for Claude Code,...
Minimal LLM API reverse proxy for Claude Code, Codex CLI & Gemini CLI — YAML routing, hot reload, and automatic provider failover. 极简 LLM API 反向代理：面向 Claude Code / Codex CLI / Gemini CLI，支持 YAML 配置、多上游优先级与自动故障转移。
这个项目起初是去年底的时候，论坛很多公益API，我用了后发现经常需要切换API供应商，总想薅公益的羊毛，羊毛没了切换花钱买的API，有时候不稳定也需要切换，甚至后来我接入了好多个公益API，切换更加频繁了，就想搞一个智能管理API供应商（中转商）的方案。
开始看了ccNexus和cc-Switch，都是要安装或者跑容器，我刚买的Mac就想干干净净的（可能我有点软件洁癖，桌面空无一物，保持干净），就动了心思自己开发一个，于是就有了Clipal。
开始只想做最简单的，满足自己的需求，同时改进了cc switch的接管方式，codex固定provider，这样就不会切换provider的时候会话历史也跟着切换（身边朋友使用就遇到这个问题很烦恼），稳定可靠。
同时纯后台运行，想要设置的时候，直接自己编辑codex、Claude code的config.toml和settings.json。当时天真的想，用编程工具的应该都懂这些设置，后来发现真的天真了，有很多佬友是很懂AI，但是编程新手，有人给我GitHub上发webUI的请求，我想了好久才想到一个既干净又满足webUI的实现方式（其实是我笨，没经验，才想好久的），程序提供一个本地Web服务 localhost:3333 让用户设置，用户直接打开浏览器就能访问，设置完关掉页面就行了，方便又干净，完全不用开发一个软件界面来做这个事儿。
clipal webui2006×1938 260 KB
截图上的几个codex供应商，出了packy都是公益的，感谢佬友们的公益API，我最近一周的开发完全靠公益。
有了webUI，后来发现还不够，我发现有时候吧，一个供应商有多个账号（喜欢薅羊毛的佬友应该都懂），要是每个账号新增个provider挺繁琐的，就开发了一个provider可以灵活接入N个API keys，同样要保持粘性，充分利用tokens缓存。
前几天我忽然发现，我已经更新好多个版本了（中间增加了很多智能化的处理，什么系统提示消息呀，命令行升级呀，灵活的请求参数配置呀等等就不说了），功能越来越完善，可以正儿八经的发一个版本，给佬友们稳定使用了于是开始完善各种用户体验的细节。
Clipal 一件接管API配置1980×1948 274 KB
这是在完善用户体验过程中上线的一件接管各种CLI的配置，方便不想看各种配置教程的佬友使用。
其实很多用户体验方面的功能，我自己很少用，多数时候直接命令行或者编辑配置文件搞了，后来自己开发出来了，发现，真香，piapia打脸。
差点忘了，最近更新了一个支持高并发的利器，如果遇到某个API provider的并发限制，会智能帮我们分流一部分会话流量到下一个Provider，同时尽可能维持粘性的tokens缓存利用。
image1920×1072 528 KB
让女王安抚一下我这脆弱的心。
总之吧，我不知道还有多少佬友需要Clipal，因为已经有 ccNexus 和 cc-Switch 做的很好了，我看人家的GitHub star，羡慕死了。
但是吧，提供一种不同的选择，有喜欢的佬友，请放心使用Clipal，我最满意的其实还是最初的设计目标，稳定的一匹，在后台默默守护，再加上小巧干净。
如果你使用各种 LLM 客户端，也是可以用Clipal的，只需要把provider的base_url设置到Clipal就可以啦。
最后让路飞登场
image1920×1072 320 KB
网友解答：--【壹】--：
不行啊，页面providers的点击没有反应
--【贰】--：
欢迎试用和star ：）
--【叁】--：
感谢感谢，今天就指着佬友的 star 带来快乐了
--【肆】--：
支持支持 ~
--【伍】--：
感谢支持，欢迎试用
--【陆】--：
佬友搞定了吗？
--【柒】--：
AI 很强，没有AI，我啥也不是
--【捌】--：
简洁的就是让人喜欢
--【玖】--：
看起来很强。
--【拾】--：
感谢分享,已Star
--【拾壹】--：
前排支持大佬
--【拾贰】--：
感谢 star ，能送star的佬友最可爱了
--【拾叁】--：
都靠社区里的公益API开发的，哈哈
--【拾肆】--：
感谢大佬 。
--【拾伍】--：
感谢分享
--【拾陆】--：
可以详细说说吗？或者截图？
另外 ~/.clipal/logs 里有日志
--【拾柒】--：
必须star
--【拾捌】--：
感谢大佬，很强
--【拾玖】--：
支持一下
本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：
- 我的帖子已经打上 开源推广 标签： 是
- 我的开源项目完整开源，无未开源部分： 是
- 我的开源项目已链接认可 LINUX DO 社区： 是
- 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是
- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是
以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出
正式开始推广一下我的开源项目，Clipal：
- 全面接管本地OpenAI（codex）、Claude（Claude code）和Gemini cli的API调用
- 多API供应商（LLM provider）智能调度
- 单provider多api key智能调度
- 最大限度保持粘性避免缓存失效
- webUI一键接管配置，免去繁琐设置
- 9M超小体积，二进制文件直接运行，设置后台运行，无感知默默为你干活儿
GitHub - lansespirit/Clipal: Minimal LLM API reverse proxy for Claude Code,...
Minimal LLM API reverse proxy for Claude Code, Codex CLI & Gemini CLI — YAML routing, hot reload, and automatic provider failover. 极简 LLM API 反向代理：面向 Claude Code / Codex CLI / Gemini CLI，支持 YAML 配置、多上游优先级与自动故障转移。
这个项目起初是去年底的时候，论坛很多公益API，我用了后发现经常需要切换API供应商，总想薅公益的羊毛，羊毛没了切换花钱买的API，有时候不稳定也需要切换，甚至后来我接入了好多个公益API，切换更加频繁了，就想搞一个智能管理API供应商（中转商）的方案。
开始看了ccNexus和cc-Switch，都是要安装或者跑容器，我刚买的Mac就想干干净净的（可能我有点软件洁癖，桌面空无一物，保持干净），就动了心思自己开发一个，于是就有了Clipal。
开始只想做最简单的，满足自己的需求，同时改进了cc switch的接管方式，codex固定provider，这样就不会切换provider的时候会话历史也跟着切换（身边朋友使用就遇到这个问题很烦恼），稳定可靠。
同时纯后台运行，想要设置的时候，直接自己编辑codex、Claude code的config.toml和settings.json。当时天真的想，用编程工具的应该都懂这些设置，后来发现真的天真了，有很多佬友是很懂AI，但是编程新手，有人给我GitHub上发webUI的请求，我想了好久才想到一个既干净又满足webUI的实现方式（其实是我笨，没经验，才想好久的），程序提供一个本地Web服务 localhost:3333 让用户设置，用户直接打开浏览器就能访问，设置完关掉页面就行了，方便又干净，完全不用开发一个软件界面来做这个事儿。
clipal webui2006×1938 260 KB
截图上的几个codex供应商，出了packy都是公益的，感谢佬友们的公益API，我最近一周的开发完全靠公益。
有了webUI，后来发现还不够，我发现有时候吧，一个供应商有多个账号（喜欢薅羊毛的佬友应该都懂），要是每个账号新增个provider挺繁琐的，就开发了一个provider可以灵活接入N个API keys，同样要保持粘性，充分利用tokens缓存。
前几天我忽然发现，我已经更新好多个版本了（中间增加了很多智能化的处理，什么系统提示消息呀，命令行升级呀，灵活的请求参数配置呀等等就不说了），功能越来越完善，可以正儿八经的发一个版本，给佬友们稳定使用了于是开始完善各种用户体验的细节。
Clipal 一件接管API配置1980×1948 274 KB
这是在完善用户体验过程中上线的一件接管各种CLI的配置，方便不想看各种配置教程的佬友使用。
其实很多用户体验方面的功能，我自己很少用，多数时候直接命令行或者编辑配置文件搞了，后来自己开发出来了，发现，真香，piapia打脸。
差点忘了，最近更新了一个支持高并发的利器，如果遇到某个API provider的并发限制，会智能帮我们分流一部分会话流量到下一个Provider，同时尽可能维持粘性的tokens缓存利用。
image1920×1072 528 KB
让女王安抚一下我这脆弱的心。
总之吧，我不知道还有多少佬友需要Clipal，因为已经有 ccNexus 和 cc-Switch 做的很好了，我看人家的GitHub star，羡慕死了。
但是吧，提供一种不同的选择，有喜欢的佬友，请放心使用Clipal，我最满意的其实还是最初的设计目标，稳定的一匹，在后台默默守护，再加上小巧干净。
如果你使用各种 LLM 客户端，也是可以用Clipal的，只需要把provider的base_url设置到Clipal就可以啦。
最后让路飞登场
image1920×1072 320 KB
网友解答：--【壹】--：
不行啊，页面providers的点击没有反应
--【贰】--：
欢迎试用和star ：）
--【叁】--：
感谢感谢，今天就指着佬友的 star 带来快乐了
--【肆】--：
支持支持 ~
--【伍】--：
感谢支持，欢迎试用
--【陆】--：
佬友搞定了吗？
--【柒】--：
AI 很强，没有AI，我啥也不是
--【捌】--：
简洁的就是让人喜欢
--【玖】--：
看起来很强。
--【拾】--：
感谢分享,已Star
--【拾壹】--：
前排支持大佬
--【拾贰】--：
感谢 star ，能送star的佬友最可爱了
--【拾叁】--：
都靠社区里的公益API开发的，哈哈
--【拾肆】--：
感谢大佬 。
--【拾伍】--：
感谢分享
--【拾陆】--：
可以详细说说吗？或者截图？
另外 ~/.clipal/logs 里有日志
--【拾柒】--：
必须star
--【拾捌】--：
感谢大佬，很强
--【拾玖】--：
支持一下