free-claude-code：用兼容代理把 Claude Code 接到多种模型供应商
一分钟看懂
free-claude-code（FCC）是在本机运行的 Anthropic API 兼容代理。它将 Claude Code 请求转换给 OpenRouter、DeepSeek、Kimi、NVIDIA NIM、Ollama、LM Studio、llama.cpp 等后端，再把流式文本、思考块、工具调用和错误转换回来。“free”指可接免费额度或本地模型，并不保证所有后端免费。
你可以用它做什么
- 保留 Claude Code 终端或 VS Code 体验，同时切换云端或本地模型。
- 在管理界面配置供应商、模型映射、端口和凭据。
- 把 Agent 会话接入 Discord、Telegram，并使用语音相关能力。
- 为新的 OpenAI/Anthropic 兼容供应商编写适配器。
主要能力
FastAPI 提供 Messages、token 计数和模型发现端点。路由可分别映射 Opus、Sonnet、Haiku；代理会规范化 SSE、thinking、tool call、用量及供应商错误。fcc-server 启动服务，fcc-claude 自动读取当前代理端口与令牌后启动 Claude Code。
适合哪些人
适合想比较模型、使用本地推理或已有第三方额度的 Claude Code 用户，也适合研究协议转换的开发者。需要 Anthropic 官方模型与官方支持时应直接用官方服务。
怎么开始使用
按 README 通过 Python/uv 安装，优先在 Admin UI 配置供应商，保持 fcc-server 运行，再执行 fcc-claude。VS Code 用户按示例设置 ANTHROPIC_BASE_URL、认证令牌和模型发现变量。源码模式可运行 uv run uvicorn server:app --host 0.0.0.0 --port 8082。
使用前需要知道
这是社区代理，不是 Anthropic 官方免费服务。云后端可能收费、限流或记录请求，本地模型也可能无法完整支持工具调用和长上下文。暴露到局域网/公网前必须更换默认令牌并配置访问控制，也应确认接入符合各服务条款。