My Free Code 教程：一个网关串起 9 个编码代理与 40+ 模型供应商

📌 项目地址：github.com/hkqr/my-free-code | 星数：637+ | 协议：MIT | 语言：Python | 版本：v0.8 | 开源时间：2026 年 8 月底 | 关系声明：独立实现，非 Anthropic 官方

📋 项目简介

用 Claude Code 的人往往不止一个模型渠道，用 Codex 的人又想蹭 Claude 的长处——每个代理各配各的 key、各写各的环境变量，管理成本直线上升。my-free-code 的思路是把"代理用什么模型"这件事从代理手里拿走：起一个本地网关，对上同时说 Anthropic Messages 和 OpenAI Responses 两种协议，对下接 40+ 家提供商和本地模型，中间做路由、降级与限流。项目 2026 年 8 月底开源，三周 600+ 星、200+ fork。需要注意：它是社区的独立实现，与 Anthropic 无官方关联。

🏗️ 架构：双协议入口 + 路由 + 三类出口

自上而下一图流：

编码代理 / IDE（Claude Code、Codex、Pi、OpenCode、Cline…）
        │
   ┌────┴────┐
   │         │
Anthropic   OpenAI
Messages    Responses
   │         │
   └────┬────┘
  FastAPI 网关（/v1/messages、/v1/responses、/v1/models、/health）
        │
   模型路由器（tier 路由 / 有序降级 / 健康退避 / 速率窗口）
        │
   ┌────┼──────────┐
OpenAI兼容   专用适配器   本地运行时
 适配器    （特殊协议）  （LM Studio等）

网关层的 Agent 能力清单很完整：流式 SSE、工具定义与调用、工具结果回传、图片输入、推理（thinking）元数据透传、Claude tier 路由（Fable/Opus/Sonnet/Haiku）、no-thinking 网关模型 ID、有序模型降级、提供商健康退避、每提供商并发与速率窗口控制、稳定的公共模型身份。此外还有本地 Admin UI（/admin）与认证的 Admin API。

launcher 层是易用性关键：为 Claude Code、Codex、Pi、OpenCode、Cline、Hermes、DeepSeek Harness、Grok Build、Muse Code 九个代理准备了启动适配——launcher 只负责准备好本地代理环境，然后把参数委托给你已安装的客户端本体。被它代理的 Pi 是什么来头，看Pi深度评测；接入后想看清各家花了多少钱，配合Tokentab用量仪表盘教程食用。

🔌 提供商目录：40+ 家 + 本地模型

目录里的名字包括：OpenRouter、Groq、OpenAI、xAI、DeepSeek、SiliconFlow、NVIDIA NIM、Together、DeepInfra、Nebius、Chutes、Featherless、ZenMux、W&B Inference、Azure OpenAI、Google AI Studio、Google Vertex、Mistral、Codestral、OpenCode Zen/Go、Vercel AI Gateway、Amazon Bedrock、Hugging Face、Cohere、GitHub Models、Kimi、Kimi Code、MiniMax、Cerebras、SambaNova、Fireworks、Novita、Cloudflare Workers AI、Z.ai、TokenRouter、NaraRoute、Poolside、LLM7、Ollama Cloud 等。

README 有句难得的实诚话值得引用：提供商列表不是"万能通用"的虚假承诺——认证或协议特殊的提供商需要专用适配器，常见的 OpenAI 兼容提供商则走共享传输。本地模型同样在目录内：

# LM Studio
LLMSTUDIO_BASE_URL=http://127.0.0.1:1234/v1
MODEL=lmstudio/qwen3.5-coder

# llama.cpp
LLAMACPP_BASE_URL=http://127.0.0.1:8080/v1
MODEL=llamacpp/my-model

🛡️ 安全清单（本地网关的必修课）

• 保持 HOST=127.0.0.1——项目定位就是本地使用
• 设置非平凡的 PROXY_AUTH_TOKEN
• 永远不要把 .env 提交进仓库
• 不要把 Admin 端点直接暴露到公网
• 凭证只留在本地环境与配置中，网关不把一家提供商的凭证发给另一家

代码质量方面，仓库带 pytest -q 可跑的确定性测试，覆盖路由、协议转换、认证、推理、模型目录与流式原语；架构文档在 ARCHITECTURE.md。

✅ 适合谁

• 多代理用户：Claude Code、Codex、Pi 混用，想一处配置全局生效
• 降级党：主力模型超时自动切备用，不想半夜被 on-call 吵醒
• 本地优先玩家：LM Studio / llama.cpp / Ollama 的模型也想进同一个路由池

延伸阅读：DeepSeek 系代理的安装实战见DeepSeek Harness安装教程；Grok 在 IDE 里的接入见Grok 4.6 Cursor配置教程。