预览
看清将要修改的配置。
应用
保存基线,保留无关设置。
回滚
恢复本轮接管前的文件状态。
修改 Shell 集成后,请打开新终端。项目、会话或环境设置仍可能覆盖工具配置。
工具照常用,连接交给 Clipal。
将 Claude Code、Codex CLI、OpenCode 等 18 种编程工具接入统一的本地 LLM 网关与 API 代理。集中管理多账号 OAuth 与多 Key 轮询,遇到 429 限流自动切换备用上游;请求、Token 与费用来源,打开浏览器即可查看。
npm install -g clipal
单文件原生二进制 · 也支持 curl、PowerShell 或直接下载发行版
请求进入本地网关。
路由到兼容的 API 提供商。
200 OK,响应返回编程工具。
新请求继续使用当前路线。
尝试当前 API 提供商。
429,当前提供商已无可用 API 密钥。
API 提供商冷却中,转向 OAuth。
200 OK,备用提供商响应成功。
后续请求匹配已学习的路由。
复用已成功的 OAuth 提供商。
200 OK,继续沿用成功的路线。
下一次匹配请求,仍用同一提供商。
200 OK,无需反复切换提供商。
添加上游、调整 CLI 连接、查看网关运行状态与用量,不用在配置文件和终端之间来回翻找。管理入口就在本机:127.0.0.1:3333。
在一个界面管理 API Key 和 OAuth 提供商,切换自动路由或手动固定路线,并直观查看各提供商的 Token 用量与费用开销。产品界面截图 · 示例配置
先预览定向配置变更,再保存基线并应用,需要时一键回滚。产品界面截图 · 示例配置
集中核对服务初始化进度、运行时长、熔断器状态,以及各协议通道当前生效的上游提供商。产品界面截图 · 示例配置
在浏览器中调整监听边界、熔断阈值与黏性会话策略。管理界面默认仅允许本地回环连接。产品界面截图 · 示例配置
从编程工具接入到请求自动兜底,把分散的配置收归本机掌控。
看清将要修改的配置。
保存基线,保留无关设置。
恢复本轮接管前的文件状态。
修改 Shell 集成后,请打开新终端。项目、会话或环境设置仍可能覆盖工具配置。
自动模式先在同一提供商内轮询下一个可用密钥,遇到 429 速率限制自动进入冷却并切换至兼容的备用提供商,后续匹配请求通过黏性路由复用可用路线;也可在手动模式下固定单一提供商。
key_01已选中key_02备用key_01备用01 / 从当前提供商和密钥开始。
02 / 必要时尝试该提供商的下一个可用密钥。
03 / 再尝试其他兼容提供商。
手动模式保持固定,不会自动切换密钥或提供商。
统一本地入口 /clipal/*,保留三类原生请求格式并按路径路由,同时支持任意 OpenAI 兼容接口及桌面客户端,不做有损协议转换。
MessagesChat · ResponsesgenerateContent在 API 密钥之外,支持通过 OAuth 连接多个 Claude、Codex 及基于 Antigravity 的 Google 账号。具备刷新令牌的凭证可自动刷新。
仍需满足账号和上游服务的使用条件。
优先采用上游报告的费用,否则使用内置目录中精确匹配模型的价格。价格未知时,保持未知。
目录估算不等于提供商的实际账单。
在控制台集中预览配置变更、启用接管,或随时恢复原有设置。
查看完整接管目录支持接管 ~/.claude/settings.json、~/.codex/config.toml、opencode.json、.aider.conf.yml 等用户级配置,也可通过 OpenAI 兼容接口接入 Cherry Studio、Chatbox 等桌面客户端。各工具支持范围有所不同;写入配置本身不代表已验证实时流量经过 Clipal。
选一种方式安装,启动 Clipal,再打开控制台添加上游。macOS、Linux、Windows 单二进制即装即用,无需另行部署网页服务。
也可下载发行版通过 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"clipal service install一键注册系统后台服务并立即启动网关,无需一直开着终端窗口。
不注册后台服务,直接在当前终端启动:
clipal把这段提示词复制给能够操作终端的编程助手。
请帮我安装并启动本地 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 接管。说明何时需要打开新终端,以及如何回滚。
可以。在同一协议分组下同时添加 API Key 提供商与受支持的 OAuth 账号即可。自动模式会先尝试当前提供商的可用密钥,受限时自动切换到兼容的 API Key 或 OAuth 备用提供商,并在后续匹配请求中复用已成功的路线;也可在手动模式下固定单一提供商。
不是。Clipal 在本地运行网关和管理控制台,但会向你选择的上游提供商发送 API 请求及必要认证信息,不等于离线推理。管理界面默认仅接受本地回环连接,远程管理与代理监听范围可分别配置。
API Key 提供商保存在 ~/.clipal 下的 YAML 文件中,OAuth 凭证单独保存在 ~/.clipal/oauth/。请通过适当的本机文件权限保护它们;Clipal 不承诺所有已存储凭证均已加密。
回滚会把受管理文件恢复为本轮接管最初保存的备份;重复应用仍保留同一份备份。项目、会话和环境设置仍可能覆盖工具的连接设置。修改 Shell 集成后,请打开新终端。
Clipal 保留 Anthropic、OpenAI 和 Gemini 的原生请求格式,通过 /clipal/* 按请求路径路由。上游需要兼容工具发送的协议,不支持任意协议之间的自动转换。
Clipal 优先采用上游报告的费用;若不可用,则使用内置价格目录中精确匹配模型的价格。未知价格保持缺失,目录更新不会重算历史费用。目录计算结果是估算值,不是账单保证。
先在控制台的「CLI 接管」页点击回滚,将受管理文件恢复至接管前备份;若安装过后台服务,运行 clipal service uninstall,随后移除程序(如 npm uninstall -g clipal),不再需要配置与记录时删除 ~/.clipal 即可。
先接入一个上游,再配置你常用的编程工具。