my-free-code Skill：把 Claude Code 接入 40+ 模型商、用 DeepSeek 替代 Sonnet 的开源网关
my-free-code Skill：把 Claude Code 接入 40+ 模型商、用 DeepSeek 替代 Sonnet 的开源网关
my-free-code 是一个开源的多提供商 AI 网关，专为 Claude Code 等编码 Agent 设计。它将 Claude Code 的 Anthropic Messages API 流量透明路由到 OpenRouter、Groq、DeepSeek、Mistral、Ollama 等 40+ 提供商，支持按模型等级（Fable/Opus/Sonnet/Haiku）分流、自动故障转移、本地模型和流式推理透传。一个 Sonnet 请求可以先走 DeepSeek Chat，失败后自动切 Groq Llama，再失败则切本地 Ollama——而 Claude Code 这端看到的模型身份始终是”Sonnet”，上下文不断裂。
功能与原则
my-free-code 的核心能力是协议翻译 + 智能路由。它同时暴露两个标准接口：/v1/messages（Anthropic Messages）和 /v1/responses（OpenAI Responses），让 Claude Code、Codex、Pi、OpenCode、Cline、DeepSeek Harness、Grok Build 等主流 Coding Agent 无缝接入。设计原则是：流量经过网关时对客户端保持完全透明，模型身份不丢失、工具调用不扭曲、推理元数据不过滤。
认可度
截至 2026-09-03，GitHub 获得约 620 Stars、211 Forks，周增速 +29 Stars，7 日增长率达 +1109.8%（AISignal 数据），属于典型爆款早期增速曲线。Enterprise DNA 于 2026-08-29 专题报道，将其定性为”近期突然爆发的多模型网关热潮”中的代表性项目。8 月底至 9 月初在 Twitter / X 和 Reddit r/ClaudeAI 上有较高讨论密度。
链接
GitHub：https://github.com/hkqr/my-free-code
原作者
GitHub 用户 hkqr，独立开发者，专注 AI 协议层工具链，my-free-code 为其代表作。
介绍
传统的 Claude Code 只能绑死 Anthropic 官方 API，费用高、特定地区限速、面对用量限制时几乎没有缓冲空间。my-free-code 从根本上解决这个问题：它在本地启动一个 FastAPI 网关，Claude Code 照常发送请求到 localhost:8082，网关根据配置把请求转发到目标提供商，再将响应转译回 Claude Code 所需的格式。整个过程对 Agent 透明，不需要修改任何 Agent 配置。
网关内置了一个模型目录（Model Catalog），收录 40+ 提供商的数千个模型，并提供稳定的公共模型身份——即使请求实际走了 DeepSeek，Claude Code 的 /model 显示和用量记录仍保持原始请求模型名。这对于团队成本追踪和 Agent 行为一致性非常关键。
路由策略高度可配置：支持按 Fable/Opus/Sonnet/Haiku 四级做主模型 + 按序回退（Ordered Fallback），也支持 no-thinking 透传和 reasoning 元数据标准化。通过环境变量即可完成配置，不需要写代码。
特点
- 多协议兼容：同时支持 Anthropic Messages API（Claude Code）和 OpenAI Responses API（Codex），覆盖主流 Coding Agent
- 多级路由与回退：可按 Fable/Opus/Sonnet/Haiku 分流主模型，失败后按配置顺序自动切换备选 Provider
- 40+ Provider 支持：NVIDIA NIM、OpenRouter、Groq、DeepSeek、Mistral、OpenAI、xAI、QwenCloud、Together、Ollama、LM Studio 等
- 本地模型支持：原生接入 Ollama（本地）、LM Studio（本地）、llama.cpp，无需云端 API 费用
- 推理透传：Claude-style thinking/thinking block 语义标准化后透传到各 Provider，支持 auto/on/off 及 low/medium/high effort
- 本地 Admin UI：在
http://127.0.0.1:8082/admin提供可视化管理界面，含状态、模型列表、Provider 状态查询 - 确定性测试覆盖：pytest 套件覆盖路由、协议转换、认证、推理、流式处理，有 CI 验证
使用方法
安装步骤：
git clone https://github.com/hkqr/my-free-code
cd my-free-code
python -m venv .venv
source .venv/bin/activate # macOS/Linux
# .venvScriptsActivate.ps1 # Windows
python -m pip install -r requirements.txt
cp .env.example .env
配置环境变量（.env）：
MODEL=open_router/openrouter/free
MODEL_SONNET=deepseek/deepseek-chat
MODEL_HAIKU=groq/llama-3.3-70b-versatile
FALLBACK_MODELS=deepseek/deepseek-chat,ollama/llama3.1
# 各 Provider API Key
ANTHROPIC_API_KEY=sk-xxx # 若仍需 Anthropic 回退
OPENROUTER_API_KEY=sk-xxx
DEEPSEEK_API_KEY=sk-xxx
启动网关：
python -m my_free_code
# 默认地址：http://127.0.0.1:8082
Claude Code 接入（Linux/macOS）：
export ANTHROPIC_BASE_URL="http://127.0.0.1:8082"
export ANTHROPIC_AUTH_TOKEN="local"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"
claude
使用 Launcher（自动环境准备）：
python -m my_free_code.cli.mfc claude # 启动 Claude Code
python -m my_free_code.cli.mfc codex # 启动 Codex
python -m my_free_code.cli.mfc opencode # 启动 OpenCode
python -m my_free_code.cli.mfc grok # 启动 Grok Build
使用场景与人群
目标用户：
– 对 Anthropic 官方 API 成本敏感的开发团队
– 在特定地区面临 API 访问限制的开发者
– 希望在本地跑 Coding Agent（Ollama/LM Studio）但不放弃 Claude Code 生态的用户
– 需要为不同任务分配不同模型（快速任务用 Haiku，复杂任务用 Opus）的进阶 Agent 用户
典型场景：
– 日常编码辅助：用 Haiku 级别模型（Groq Llama）处理简单 PR review、代码补全，成本趋近于零
– 复杂任务：用 Sonnet 级别（DeepSeek Chat）处理多文件重构，单次成本大幅低于官方定价
– 本地隐私场景：用 Ollama 本地模型处理含内部机密的代码库，完全不出网
– 故障容灾：主力 Provider 限流时自动回退到备用 Provider，Agent 任务不中断
输入与输出案例
案例 1：Sonnet 级任务路由
环境变量配置：
MODEL_SONNET=deepseek/deepseek-chat
FALLBACK_MODELS=groq/llama-3.3-70b-versatile,ollama/llama3.1
用户请求（Claude Code，Sonnet 级别任务）：
"重构这个 React 组件，分离业务逻辑和 UI，补充 TypeScript 类型"
路由路径：
Claude Code → deepseek/deepseek-chat（主）→ 成功返回
若 DeepSeek 超时 → 自动切换 groq/llama-3.3-70b-versatile → 若还失败 → Ollama 本地模型
Claude Code 视角：模型身份仍显示为 Sonnet，/model 命令输出不变
案例 2：本地模型接入
环境变量配置：
OLLAMA_BASE_URL=http://127.0.0.1:11434/v1
MODEL=ollama/llama3.1
用户请求："解释这段 Python 代码在做什么"
路由路径：Claude Code → 本地 Ollama（llama3.1），完全免费，无网络流量
响应速度取决于本机硬件，无 API 限流问题
评论区
登录后可评论。