AI 编程工具 一个本地网关

本地 LLM 网关 开源 · MIT macOS / Linux / Windows

工具照常用,连接交给 Clipal。

将 Claude Code、Codex CLI、OpenCode 等 18 种编程工具接入统一的本地 LLM 网关与 API 代理。集中管理多账号 OAuth 与多 Key 轮询,遇到 429 限流自动切换备用上游;请求、Token 与费用来源,打开浏览器即可查看。

npm install -g clipal

单文件原生二进制 · 也支持 curl、PowerShell 或直接下载发行版

路由演示示意数据
127.0.0.1:3333
Clipal运行在你的电脑上
/clipal/*本地
AnthropicOpenAIGemini
Claude 提供商 01API 密钥
就绪
Claude 提供商 02Claude 账号
备用
自动模式

请求进入本地网关。

18 种 CLI · 支持配置接管
01本地控制台

上游、接管与网关状态,尽在本机控制台。

添加上游、调整 CLI 连接、查看网关运行状态与用量,不用在配置文件和终端之间来回翻找。管理入口就在本机:127.0.0.1:3333。

多账号、多 Key 与费用开销,并排管理。

在一个界面管理 API Key 和 OAuth 提供商,切换自动路由或手动固定路线,并直观查看各提供商的 Token 用量与费用开销。产品界面截图 · 示例配置

CLI 配置差异预览与一键回滚。

先预览定向配置变更,再保存基线并应用,需要时一键回滚。产品界面截图 · 示例配置

网关健康、熔断器与实时路由状态。

集中核对服务初始化进度、运行时长、熔断器状态,以及各协议通道当前生效的上游提供商。产品界面截图 · 示例配置

监听边界、熔断阈值与黏性会话设置。

在浏览器中调整监听边界、熔断阈值与黏性会话策略。管理界面默认仅允许本地回环连接。产品界面截图 · 示例配置

02功能

API 密钥、OAuth 与故障转移,收拢一处。

从编程工具接入到请求自动兜底,把分散的配置收归本机掌控。

CLI 接管

CLI 配置预览、基线备份与一键回滚。

不用逐个寻找工具的配置入口。先在控制台预览用户级配置差异,再应用接管;Clipal 保存受管理文件的原始基线,随时可以回滚。

了解 CLI 接管
01

预览

看清将要修改的配置。

02

应用

保存基线,保留无关设置。

03

回滚

恢复本轮接管前的文件状态。

修改 Shell 集成后,请打开新终端。项目、会话或环境设置仍可能覆盖工具配置。

自动故障转移

多 Key 轮询与 429 限流自动切换。

自动模式先在同一提供商内轮询下一个可用密钥,遇到 429 速率限制自动进入冷却并切换至兼容的备用提供商,后续匹配请求通过黏性路由复用可用路线;也可在手动模式下固定单一提供商。

流程示意
提供商 A
key_01已选中
key_02备用
提供商 B
key_01备用

01 / 从当前提供商和密钥开始。

手动模式保持固定,不会自动切换密钥或提供商。

原生协议

Anthropic、OpenAI 与 Gemini 原生路由。

统一本地入口 /clipal/*,保留三类原生请求格式并按路径路由,同时支持任意 OpenAI 兼容接口及桌面客户端,不做有损协议转换。

  • Anthropic Messages
  • OpenAI Chat · Responses
  • Gemini generateContent
OAuth 账号

Claude、Codex 与 Google 多账号 OAuth 接入。

在 API 密钥之外,支持通过 OAuth 连接多个 Claude、Codex 及基于 Antigravity 的 Google 账号。具备刷新令牌的凭证可自动刷新。

仍需满足账号和上游服务的使用条件。

用量与费用

请求、Token 与费用追踪,来源透明。

优先采用上游报告的费用,否则使用内置目录中精确匹配模型的价格。价格未知时,保持未知。

上游报告优先来源
模型价格目录备用估算
未知价格不猜测价格

目录估算不等于提供商的实际账单。

03集成

支持 18 种 AI 编程 CLI,熟悉工具照常用。

在控制台集中预览配置变更、启用接管,或随时恢复原有设置。

查看完整接管目录
  • Claude Code
  • Codex CLI
  • OpenCode
  • Antigravity CLI
  • Continue
  • Aider
  • Goose
  • Pi
  • Qwen Code
  • Kimi Code CLI
  • Copilot CLI
  • Kilo CLI
  • CodeBuddy Code
  • Crush
  • iFlow CLI
  • TRAE Agent
  • Grok Build
  • DeepSeek Harness

支持接管 ~/.claude/settings.json、~/.codex/config.toml、opencode.json、.aider.conf.yml 等用户级配置,也可通过 OpenAI 兼容接口接入 Cherry Studio、Chatbox 等桌面客户端。各工具支持范围有所不同;写入配置本身不代表已验证实时流量经过 Clipal。

04安装

三步启动本地网关,从本机开始。

选一种方式安装,启动 Clipal,再打开控制台添加上游。macOS、Linux、Windows 单二进制即装即用,无需另行部署网页服务。

也可下载发行版
1

安装

通过 npm 安装对应平台的原生程序。

npm install -g clipal

使用 macOS 或 Linux 独立安装脚本。

curl -fsSL https://clipal.paiart.com/install.sh | sh

在 PowerShell 中运行 Windows 安装脚本。

powershell -ExecutionPolicy ByPass -c "irm https://clipal.paiart.com/install.ps1 | iex"
2

启动网关

clipal service install

一键注册系统后台服务并立即启动网关,无需一直开着终端窗口。

只想在当前终端临时前台运行?

不注册后台服务,直接在当前终端启动:

clipal
3

打开控制台

127.0.0.1:3333 本机地址 · 完成第 2 步启动后访问

网关在本机运行后打开控制台,添加 API Key 提供商或 OAuth 账号,然后为工具预览并启用 CLI 接管。

让 AI 助手完成安装

把这段提示词复制给能够操作终端的编程助手。

请帮我安装并启动本地 LLM 网关 Clipal。官方仓库:https://github.com/PAIArtCom/Clipal

1. 检查我的操作系统和 npm 是否可用。优先使用:npm install -g clipal
2. 如果没有 npm,使用对应平台的官方安装脚本:
   macOS/Linux: curl -fsSL https://clipal.paiart.com/install.sh | sh
   Windows PowerShell: powershell -ExecutionPolicy ByPass -c "irm https://clipal.paiart.com/install.ps1 | iex"
3. 运行 clipal service install 注册系统后台服务并立即启动网关(该命令会自动启动并校验健康检查;仅在环境不支持后台服务时改用前台运行 clipal)。确认 http://127.0.0.1:3333/ 可以访问。
4. 引导我在 Web UI 添加第一个提供商或 OAuth 账号,预览并应用 CLI 接管。说明何时需要打开新终端,以及如何回滚。
05常见问题

本地 LLM 网关,能力与边界清楚。

可以把 Claude、Codex 等 OAuth 账号和按量计费的 API Key 混用吗?

可以。在同一协议分组下同时添加 API Key 提供商与受支持的 OAuth 账号即可。自动模式会先尝试当前提供商的可用密钥,受限时自动切换到兼容的 API Key 或 OAuth 备用提供商,并在后续匹配请求中复用已成功的路线;也可在手动模式下固定单一提供商。

“本地”意味着 AI 请求不会离开电脑吗?

不是。Clipal 在本地运行网关和管理控制台,但会向你选择的上游提供商发送 API 请求及必要认证信息,不等于离线推理。管理界面默认仅接受本地回环连接,远程管理与代理监听范围可分别配置。

配置和凭证保存在哪里?

API Key 提供商保存在 ~/.clipal 下的 YAML 文件中,OAuth 凭证单独保存在 ~/.clipal/oauth/。请通过适当的本机文件权限保护它们;Clipal 不承诺所有已存储凭证均已加密。

CLI 接管回滚会恢复什么?

回滚会把受管理文件恢复为本轮接管最初保存的备份;重复应用仍保留同一份备份。项目、会话和环境设置仍可能覆盖工具的连接设置。修改 Shell 集成后,请打开新终端。

Clipal 会转换不同模型的协议吗?

Clipal 保留 Anthropic、OpenAI 和 Gemini 的原生请求格式,通过 /clipal/* 按请求路径路由。上游需要兼容工具发送的协议,不支持任意协议之间的自动转换。

应该怎样理解费用数据?

Clipal 优先采用上游报告的费用;若不可用,则使用内置价格目录中精确匹配模型的价格。未知价格保持缺失,目录更新不会重算历史费用。目录计算结果是估算值,不是账单保证。

如果不再使用,怎样完整恢复 CLI 配置并卸载?

先在控制台的「CLI 接管」页点击回滚,将受管理文件恢复至接管前备份;若安装过后台服务,运行 clipal service uninstall,随后移除程序(如 npm uninstall -g clipal),不再需要配置与记录时删除 ~/.clipal 即可。

开源的工具,一起打磨。

读读代码,分享想法,一起让日常 AI 工具用得更顺手。

加入微信社区
微信交流群二维码
微信交流群
作者微信二维码
联系作者

使用微信扫码;群可用状态可能变化。

把连接理顺,继续写代码。

先接入一个上游,再配置你常用的编程工具。

开始使用

产品界面截图 · 示例配置

查看原图 ↗