⚡ AxonHub:3.7k Stars 的 AI Gateway,不改一行代码就能在 GPT / Claude / Gemini 间随意切换
⚡ AxonHub:3.7k Stars 的 AI Gateway,不改一行代码就能在 GPT / Claude / Gemini 间随意切换 / AxonHub: 3.7k Stars AI Gateway — Switch Between GPT/Claude/Gemini Without Changing a Line of Code
> 项目地址: | ⭐ 3,768 Stars | 🛠 Go | 作者 looplj
---
老实说,做 AI 应用最烦的不是模型选哪个,而是**一旦选定了 SDK,换模型就得重写代码**。GPT-4 跑得好好的,想换 Claude 3.5 试试?得改整个 OpenAI SDK 到 Anthropic SDK,调参改到怀疑人生。
**AxonHub** 解决的就是这个蛋疼问题——它是你所有 LLM 调用的统一入口,用 OpenAI SDK 调 Claude,或者用 Anthropic SDK 调 Gemini,改一行 `model` 名就行,代码零改动。
## 一、30 秒跑起来
AxonHub 是 Go 写的,编译成单文件二进制,下载即用:
```bash
# macOS ARM64
curl -sSL https://github.com/looplj/axonhub/releases/latest/download/axonhub_darwin_arm64.tar.gz | tar xz
cd axonhub_*
./axonhub
# 打开 http://localhost:8090
# 首次打开走初始化向导,建管理员账号,配第一个 API Key
```
Linux / Windows 同理,去 [Releases](https://github.com/looplj/axonhub/releases) 下对应版本就行。支持 SQLite(默认)和 PostgreSQL。
## 二、最骚的操作:零代码换模型
启动之后,你的代码只需要改一个 `base_url`:
```python
from openai import OpenAI
client = OpenAI(
base_url="http://localhost:8090/v1", # 指向 AxonHub
api_key="你的-axonhub-api-key" # 在管理页面生成
)
# 用 OpenAI SDK 调 Claude
response = client.chat.completions.create(
model="claude-3-5-sonnet", # 换 gpt-4 也行
messages=[{"role": "user", "content": "Hello!"}]
)
```
底层 AxonHub 自动帮你做协议翻译。配了哪个 Provider(OpenAI / Anthropic / DeepSeek / Zhipu / Gemini 等十几个),它就自动路由到对应的模型。换模型?改 `model` 名就行,其余一行不动。
## 三、不只是 Gateway
除了协议翻译,AxonHub 还带了几个生产级功能:
- **自动失败转移**:同一个模型配多个 API Key,一个挂了 <100ms 切到下一个
- **完整调用链路追踪**:每个请求从入到出都有 trace,Debug 不用靠猜
- **RBAC 权限控制**:多租户隔离,团队用不担心密钥乱飞
- **实时计费监控**:每个请求花多少钱,输入/输出/缓存 token 全部记下来
一个命令部署到服务器:
```bash
# Docker 部署
docker run -d --name axonhub -p 8090:8090 looplj/axonhub:latest
```
## 四、踩坑提醒
1. **API Key 别搞混**:AxonHub 的 API Key 是在你本地生成的,跟 Provider 的 Key 是两码事——AxonHub Key 用来鉴权访问 Gateway,Provider Key 存在后台配置里
2. **Streaming 支持**:OpenAI SDK 的 `stream=True` 完全兼容,不需要额外配置
3. **首次启动必须走初始化页面**,没法通过环境变量跳过——这是设计上的安全考量
## 总结
- 🎯 不改代码切换任意模型提供商
- ⚡ <100ms 自动失败转移
- 📊 内置链路追踪 + 成本监控
- 🐳 Docker 一键部署
- 🔐 多租户 RBAC + 密钥隔离
如果你的项目接了好几个模型,或者担心哪天某个 Provider 涨价了要换,AxonHub 值得花 30 秒装上试试。