为什么需要
Claude Code 默认走 Anthropic 官方 API,但海外独立开发者经常需要切换 provider——比如周末跑 NVIDIA NIM 免费层、Codex 写前端用 Groq 提速、长上下文用本地 Ollama。手动改环境变量切来切去很麻烦,My Free Code 提供了一个 FastAPI 网关,把这些切换写成配置文件。
定位类似 LiteLLM,但专门为 coding agent 场景做了 launcher 抽象层。
怎么用
需要 Python 3.10+:
bash
git clone https://github.com/hkqr/my-free-code
cd my-free-code
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\Activate.ps1
pip install -r requirements.txt
cp .env.example .env
python -m my_free_code
默认跑在 http://127.0.0.1:8082,监听 localhost。配置文件 .env 里定义模型路由:
env
MODEL=open_router/openrouter/free
MODEL_SONNET=deepseek/deepseek-chat
MODEL_HAIKU=groq/llama-3.3-70b-versatile
MODEL_OPUS=nvidia_nim/meta/llama-3.3-70b-instruct
FALLBACK_MODELS=deepseek/deepseek-chat,ollama/llama3.1
然后让 Claude Code 走网关:
bash
export ANTHROPIC_BASE_URL="http://127.0.0.1:8082"
export ANTHROPIC_AUTH_TOKEN="local"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"
claude
CLI 也内置 launcher,可以一键启动多种编程 agent:
bash
python -m my_free_code.cli.mfc codex
python -m my_free_code.cli.mfc opencode
python -m my_free_code.cli.mfc cline
python -m my_free_code.cli.mfc hermes
使用案例
独立开发者团队(3 人)全员 Claude Code,月度 Anthropic API 账单 $1800。把 Sonnet 模型路由到 OpenRouter 的 deepseek/deepseek-chat(价格约 1/15),Opus 路由到 NVIDIA NIM 免费层,Haiku 保持官方。月度账单降到 $420,三人共用一个 self-host 网关实例。
注意事项
- v0.8 还在快速迭代,作者声明与 Anthropic 无官方关联——用
ANTHROPIC_AUTH_TOKEN=local即可,但官方 Anthropic 政策可能调整 - Provider 列表里有 40+ 名字,但不是每个都能开箱即用——作者明确说协议特殊的 provider 需要专门 adapter
- 网关只监听
127.0.0.1,不暴露公网;如果要远程访问需要自己加反代 + 鉴权 - Admin UI 在
/admin,API 在/api/admin/*——生产部署记得改默认密码