46
// 项目简介
Free Claude Code 作为一个兼容 Anthropic 的代理，允许开发者将 Claude Code CLI 和 IDE 的流量路由至各种替代提供商。它支持多种后端，包括 NVIDIA NIM、OpenRouter、DeepSeek 以及通过 Ollama 或 llama.cpp 运行的本地模型。该工具还提供可选的 Discord 和 Telegram 机器人集成，用于远程编程会话和语音笔记转录。
// 技术分析
Free Claude Code 是一个中间件代理，旨在通过将流量路由到各种替代提供商，使 Claude Code CLI 和 IDE 扩展与官方 Anthropic API 解耦。其架构充当了一个转换层，在保持与 Claude Code 预期协议兼容的同时，标准化请求以支持 NVIDIA NIM、OpenRouter、DeepSeek 以及 Ollama 或 llama.cpp 等本地 LLM 运行器。该项目解决了供应商锁定和成本问题，使开发人员能够无缝利用免费、付费或本地模型。一个关键的技术权衡是对代理层的依赖，这需要仔细配置环境变量，并可能需要针对特定模型的工具使用能力进行调整。
// 核心亮点
01
提供了一个即插即用的代理，将 Anthropic API 调用路由到包括 NVIDIA NIM、OpenRouter 和本地提供商在内的六个不同后端。
02
支持细粒度的模型路由，允许用户为 Opus、Sonnet 或 Haiku 等特定模型层分配不同的提供商。
03
通过公开兼容的 /v1/models 端点，支持原生的 Claude Code 模型选择器功能。
04
包含可选的 Discord 和 Telegram 机器人包装器，以促进远程编码会话和任务管理。
05
具备使用本地 Whisper 或 NVIDIA NIM 后端的可选语音笔记转录功能。
06
标准化了流式传输、工具使用和推理/思考块等复杂功能，以确保在不同 LLM 提供商之间的一致行为。
// 典型使用场景
01
将 Claude Code 流量路由至免费、付费或本地 AI 模型提供商
02
管理按模型路由，以便为特定模型层级使用不同的提供商
03
通过 Discord 或 Telegram 机器人封装实现远程编程会话
// 快速开始
首先，安装 Python 3.14 和 uv 包管理器，然后克隆存储库并使用提供的 .env.example 模板初始化环境变量。使用 'uv run uvicorn server:app --host 0.0.0.0 --port 8082' 启动代理服务器。最后，通过将 ANTHROPIC_BASE_URL 设置为您的本地代理地址并提供 ANTHROPIC_AUTH_TOKEN 来配置您的 Claude Code CLI 或 IDE 扩展。