Free Claude Code 是一个开源的 Anthropic Messages API 代理，它拦截 Claude Code 的 API 调用，将其路由到 NVIDIA NIM、OpenRouter、DeepSeek 或 Ollama 等多种后端，让开发者能够免费或以极低成本使用 Claude Code CLI、VS Code 扩展和 JetBrains ACP。本文档是该系列指南的总览与导航中心。

Free Claude Code 中文指南：免费使用 Claude Code 的完整方案 #

项目核心价值：为何需要一个代理？ #

Claude Code 官方依赖于 Anthropic API 的按量计费，对于日常开发中的高频使用，这笔开销并不低。Free Claude Code 通过在本地部署一个轻量级代理，巧妙地解决了这个问题。它充当了“翻译官”和“路由器”的角色，将 Claude Code 发出的标准 API 请求，转发至你指定的、成本更低甚至免费的后端服务。例如，你可以利用 NVIDIA NIM 的免费 GPU 额度、OpenRouter 的免费模型池，或是直接在本地通过 Ollama 运行模型，从而彻底摆脱对官方计费体系的依赖。

关键能力一览 #

这个代理并非简单的转发工具，它集成了多项实用功能，覆盖了从基础使用到进阶效率优化的多个层面：

• Drop-in 代理：对 Claude Code 本身零侵入。只需修改两个环境变量指向代理地址，无需改动任何 Claude Code 的代码或配置文件。
• 支持 6 种主流后端：包括云端免费/低价选项（NVIDIA NIM、OpenRouter、DeepSeek）和本地零成本方案（LM Studio、llama.cpp、Ollama）。
• Per-tier 路由：这是成本控制的核心。你可以为不同的模型层级（如 Opus、Sonnet、Haiku）分别配置不同的后端。例如，让高智能的 Opus 请求走 Kimi，平衡速度的 Sonnet 请求走 DeepSeek R1，而轻量级的 Haiku 请求则由本地模型 GLM 来处理，实现成本与性能的精准权衡。
• 请求优化机制：代理会自动识别并拦截 Claude Code 运行过程中产生的部分非必要探测请求（如配额检查、标题生成、建议模式），在本地直接返回响应，从而节省 API 调用次数和延迟。
• 可选聊天机器人集成：通过封装 Discord 或 Telegram bot，你可以远程发送消息来触发 Claude Code 执行代码编写任务。
• 可选语音笔记转写：支持调用本地 Whisper 模型或 NVIDIA NIM 云端服务，将 Discord/Telegram 中的语音消息自动转为文本，方便与 AI 交互。

快速导航：找到你需要的指南 #

为了帮助你快速定位所需内容，下表列出了本系列文档与常见使用场景的对应关系：

代理工作原理 #

理解代理的工作原理，有助于你更好地配置和使用它。整个过程对 Claude Code 用户是透明的。

Claude Code CLI / VS Code / JetBrains
        |
        | 发送 Anthropic Messages API 标准请求
        v
Free Claude Code 代理（监听 :8082 端口）
        |
        | 1. 按配置路由选择 Provider
        | 2. 将请求翻译成 Provider 专有格式
        | 3. 将 Provider 响应流式转换回 Anthropic SSE 格式
        v
NIM / OpenRouter / DeepSeek / LM Studio / llama.cpp / Ollama

Claude Code 始终将 Free Claude Code 代理视为标准的 Anthropic API 端点。代理在后台完成协议适配、请求路由和流式响应转换，使得最终效果与直接使用官方 API 几乎一致。

FAQ #

Q: 使用免费或低成本的后端，Claude Code 的功能会缺失吗？ A: 代理本身会尽可能完整地支持 Anthropic Messages API 的协议，包括工具调用、扩展思考、流式传输等核心功能。但功能的实现程度最终取决于你所选择的后端模型的能力。例如，本地小模型在工具调用的准确率上可能不如云端大模型。

Q: 这个项目的数据安全吗？ A: Free Claude Code 是 MIT 开源项目，代码完全透明可审计。代理仅在你的本地机器运行，所有请求流量只在你与选定的后端 Provider 之间传输，项目本身不会收集或转发任何数据。你需要妥善保管 .env 文件中配置的各类 API 密钥和 ANTHROPIC_AUTH_TOKEN。

Q: 如果 Claude Code 官方升级，这个代理会失效吗？ A: 代理模拟的是 Anthropic Messages API 的稳定公共接口（如 /v1/messages）。只要 Claude Code 客户端继续使用这些标准接口进行通信，代理就能工作。如果未来官方对 API 协议有重大变更，代理项目需要同步更新以适应变化。建议关注项目的 GitHub Issues 页面以获取最新的兼容性信息。

本系列文章 #

项目整体介绍、快速开始指南和 IDE 集成配置，帮助用户快速了解并启动项目。 #

• Free Claude Code 安装部署教程：5 分钟从零启动 Anthropic 代理
• Free Claude Code 连接 IDE：VS Code 和 JetBrains 配置指南

解析项目核心的模型路由机制、请求优化策略和整体架构设计，帮助用户深入理解代理工作原理。 #

• Free Claude Code 多模型路由：让 Opus/Sonnet/Haiku 走不同后端
• Free Claude Code 架构设计：一个 Anthropic 代理的模块化拆分思路

分别介绍如何接入 NVIDIA NIM、OpenRouter 和 DeepSeek 三种主流的云端模型后端。 #

• Free Claude Code 接入 NVIDIA NIM：免费 GPU 推力驱动 Claude Code
• Free Claude Code 接入 OpenRouter 和 DeepSeek：云端 API 代理配置

介绍如何使用 Ollama、LM Studio 和 llama.cpp 在本地零成本运行模型。 #

• Free Claude Code 接入 Ollama 和 LM Studio：本地模型零成本跑 Claude Code

介绍项目的聊天机器人集成和语音转写等增值功能。 #

• Free Claude Code 接入 Discord 和 Telegram：用聊天机器人远程写代码
• Free Claude Code 语音笔记转写：Discord/Telegram 语音消息自动处理

汇总常见问题及排查方法，帮助用户解决使用过程中遇到的典型错误。 #

• Free Claude Code 常见问题排查：代理连接、模型兼容性、流式传输错误