一个 API Key 打通所有大模型：Aider 零代码网关接入实战
🚀 为什么你需要这个「网关模式」？
- 想试 GPT-5.4，又想切 Claude Sonnet 4.5？不用删 Key、重装 SDK、改代码——只改一个
--model参数就行。 - 公司要求统一计费/审计？把所有请求都打到自己的网关（比如
https://futurmix.ai/v1），一张账单看清全部消耗。 - 怕 OpenAI 突然限流或 Anthropic 维护？网关可自动切备用通道，Aider 完全无感。
一句话：原来要管 3 个 Key、4 个 endpoint、5 种认证方式；现在只要 1 个 Key + 1 个地址，全搞定。
⚙️ 三步完成接入（全程终端粘贴即可）
✅ 第一步：设置两个环境变量（复制粘贴就生效）
export OPENAI_API_BASE=https://futurmix.ai/v1 # 网关地址（替换成你自己的）
export OPENAI_API_KEY=your-gateway-key # 网关分配给你的统一密钥
💡 小知识：Aider 底层用的是 OpenAI 官方 Python SDK，它原生支持
OPENAI_API_BASE—— 这不是 hack，是官方留的正规后门！
✅ 第二步：直接运行 Aider，任意指定模型名
# 调 Claude Sonnet 4.5（网关自动识别并转发给 Anthropic）
aider --model claude-sonnet-4-5-20250929
# 调 GPT-5.4（网关自动路由到 OpenAI）
aider --model gpt-5.4
# 调 Gemini 2.5 Pro（网关自动对接 Google）
aider --model gemini-2.5-pro
✅ 不用安装新插件、不用改 Aider 源码、不用碰任何 JSON 配置——纯命令行，开箱即用。
✅ 第三步：让设置永久生效（选一种就行）
- 方式一：写进 shell 配置（推荐新手）
把这两行加到你的~/.zshrc或~/.bashrc末尾，然后执行source ~/.zshrc：
bash
# AI 网关统一配置（永久生效）
export OPENAI_API_BASE=https://futurmix.ai/v1
export OPENAI_API_KEY=your-gateway-key
- 方式二：项目级配置（推荐团队协作）
在项目根目录新建.env文件，内容如下（Aider 会自动读取）：
OPENAI_API_BASE=https://futurmix.ai/v1
OPENAI_API_KEY=your-gateway-key
- 方式三：全局配置文件（推荐主力用户）
编辑~/.aider.conf.yml（没有就新建），填入：
yaml
# ~/.aider.conf.yml
openai-api-base: https://futurmix.ai/v1
openai-api-key: your-gateway-key
model: claude-sonnet-4-5-20250929 # 默认启动模型，可省略
❓ 常见问题速查（5 秒解决）
-
报错 “Model not found”？
→ 一定是模型 ID 写短了！必须用完整 ID，比如claude-sonnet-4-5-20250929（不是claude-sonnet），网关靠这个精确路由。 -
提示 “Authentication failed”？
→ 检查OPENAI_API_KEY是否拼错、是否漏引号、是否多空格；网关通常要求标准 Bearer Token 格式，无需额外封装。 -
响应变慢？
→ 正常网关延迟 < 50ms（相当于眨一次眼）。如果明显卡顿，请先curl -v https://futurmix.ai/v1/models测试网络连通性。
🔁 这套方案还能用在哪？
好消息：所有基于 OpenAI SDK 构建的工具，都支持 OPENAI_API_BASE！
你刚学会的这一招，立刻能复用到：
- Cursor：设置 → Models → 找到 “OpenAI API Base” 填入即可
- Continue.dev：编辑
~/.continue/config.json，在 provider 里加"baseUrl": "https://futurmix.ai/v1" - Roo Code：设置 → Model Providers → 选择 “OpenAI Compatible” → 填地址和 Key
- Claude Code：改环境变量
ANTHROPIC_BASE_URL（同理，只是换了个变量名）
✅ 本质就一条：SDK 认环境变量，不认厂商——你喂它什么地址，它就打给谁。
直达网址：https://futurmix.ai
