Claude Code model router

Clipal

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 配置、多上游优先级与自动故障转移。

Install

Install
npm install -g clipal

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/PAIArtCom/Clipal.git

From the README

Clipal

  Your Ultimate Local LLM API Gateway & Manager

    English | 中文

Clipal is the local LLM API proxy built for developer productivity. If you use AI coding tools like Claude Code, Continue, Aider, or Cherry Studio, Clipal acts as your intelligent traffic controller. It consolidates multiple model providers, handles automatic failover, manages API keys, and offers a beautiful Web UI—so you can focus on coding, not configuring.

Join the WeChat Group

Scan the QR codes below to join the Clipal WeChat group or contact the author.

        WeChat Group

        Author WeChat

✨ Why Clipal?

🚀 One-Click CLI Takeover
No more hunting for hidden config files. With a single click in the Web UI, Clipal can automatically take over the configurations for 18 clients, including Claude Code, Codex CLI, OpenCode, Antigravity CLI, Pi, Qwen Code, Kimi Code, Copilot CLI, Grok Build and DeepSeek Harness. See the complete takeover catalog and limits.
- It configures the local base URL for you.
- It backs up your original settings.
- It provides a safe rollback whenever you want.

🛡️ Bulletproof Failover & Multi-Key Rotation
Tired of hitting rate limits or empty balances mid-generation?
- Multi-Key Pool: Configure multiple .api_keys for a single provider. Clipal rotates them automatically and retries locally before giving up.
- Priority Failover: Fall back to secondary models or providers instantly with out-of-the-box circuit breaking and quota management.
- OAuth Upstreams: Authorize Codex, Claude, and Antigravity-backed Google accounts from the Web UI. They participate in the same ordering, pinning, enable/disable, and failover flow as API-key providers, and Clipal refreshes access tokens automatically when a refresh token is available. Antigravity OAuth supports…
Read the full README on GitHub

Details

Language
Go
Last updated
1 November 2026
Topics
api-gatewayapi-proxycc-switchccnexusclaude-codecodexgeminigemini-clillm-gatewayproxy-serverreverse-proxy

FAQ

What is Clipal?

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 配置、多上游优先级与自动故障转移。 It is a model router for Claude Code, from PAIArtCom/Clipal on GitHub.

How do I install Clipal?

Run npm install -g clipal, then follow the setup in the README.

Is Clipal popular?

PAIArtCom/Clipal has 158 GitHub stars and 14 forks. It was last updated on 1 November 2026.

More model routers & proxies

Browse the most popular Claude Code mods, all model routers & proxies, or the skills and MCP server directories.