如何免费使用 Claude Code
Claude Code 是 Anthropic 推出的编程智能体。它需要 Anthropic Messages API。本指南介绍如何通过 FreeLLMAPI 将 Claude Code 连接到免费模型。你需要设置两个环境变量。你不需要 Anthropic 密钥。
代码、模型名称和目录中的实时标签以英文显示。
你能获得什么,不能获得什么
Claude Code 会将每个请求发送到采用 Anthropic 格式的 API。FreeLLMAPI 在 /v1/messages 上支持该格式。它会转换每个请求,并将其发送到免费模型,例如 Gemini、GPT-OSS、Qwen 或 GLM。
- 你可以获得:在免费模型上使用 Claude Code 界面、其工具、文件编辑和智能体循环。
- 你无法获得:Anthropic 的 Claude 模型。没有任何服务商通过 API 免费提供 Claude 模型。详情请阅读是否有免费的 Claude API?
- 费用:推理费用为 $0。免费额度有速率限制。当某个限制阻止请求时,FreeLLMAPI 会切换到下一个服务商。
第 1 步:安装 FreeLLMAPI
FreeLLMAPI 是开源软件。它在你的电脑上通过 Docker 运行。你的服务商密钥保存在你的电脑上。
macOS 或 Linux
curl -fsSL https://freellmapi.co/install.sh | bash在浏览器中打开控制台:http://localhost:3001。在 Keys 页面至少添加两个免费服务商的密钥。Google AI Studio 和 Groq 各自约一分钟即可获得免费密钥。从同一页面复制你的统一密钥。
第 2 步:连接 Claude Code
最快的方法是使用设置命令。它会读取实时目录,备份 ~/.claude/settings.json,并添加网关设置。
一条命令
npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>如需手动设置,请设置两个环境变量,然后启动 Claude Code:
手动设置(macOS 或 Linux)
export ANTHROPIC_BASE_URL=http://localhost:3001
export ANTHROPIC_AUTH_TOKEN=<unified-key>
claude手动设置(Windows PowerShell)
$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claudeANTHROPIC_AUTH_TOKEN。不要使用 ANTHROPIC_API_KEY。如果设置了 ANTHROPIC_API_KEY,Claude Code 会发现存在冲突的凭据,并且无法启动。要确认请求已发送到网关,请运行 npx freellmapi doctor。每个响应还带有 X-Routed-Via 请求头。该请求头会显示作出回答的服务商和模型。
第 3 步:为智能体工作选择模型
Claude Code 会发送较长的提示。典型请求包含大型系统提示、工具定义和文件内容。请使用支持工具调用且上下文窗口较大的模型。每分钟 token 数较低的小型免费额度会在这些请求上失败。
在 Keys, Anthropic 标签页中,将每个 Claude 系列(opus、sonnet、haiku)映射到 auto 或某个模型。使用 auto 时,路由器会为每个请求选择一个免费模型。下表列出了今日目录中支持工具调用且上下文至少为 128K 的免费模型。
| 模型 | 免费提供方 | 上下文 | 免费额度(最优惠) | 工具 | 视觉 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 请求/分钟 1 req/min per model | 是 | 否 |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 请求/分钟 40 RPM | 是 | 是 |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 是 | 是 |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | 是 | 否 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 请求/分钟 20 请求/天 250,000 令牌/分钟 ~3M | 是 | 是 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 请求/分钟 50 请求/天 50 req/day account-wide (1,000 after a $10 purchase) | 是 | 是 |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 请求/分钟 50 请求/天 Shared rate limit | 是 | 否 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 请求/分钟 250 请求/天 70,000 令牌/分钟 ~6M | 是 | 是 |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 请求/分钟 20 请求/天 250,000 令牌/分钟 ~3M | 是 | 是 |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | 是 | 是 |
显示 12 个(共 109 个匹配的免费模型)。 查看所有模型.
数据来自 FreeLLMAPI 目录(版本 2026.11.19,检查于 2026-11-19)。免费额度经常变化。该目录每天检查一次。
速率限制,以及故障转移如何起作用
一次 Claude Code 任务可能发送 20 到 100 个请求。单个免费额度很快就会用完。例如,一个免费的 Gemini Flash 密钥每天允许的请求很少。FreeLLMAPI 会统计每个密钥的配额。当某个服务商返回 429 错误时,路由器会尝试池中的下一个服务商。你的 Claude Code 会话会继续运行。
- 添加四个或更多服务商的密钥。密钥越多,每天可用的请求越多。
- 将
haiku映射到快速的小型模型。Claude Code 会将其用于简短的后台任务。 - 保持上下文较小。在任务之间使用
/clear,以发送更少的 tokens。
故障排除
| 问题 | 原因 | 解决方法 |
|---|---|---|
| Claude Code 要求你登录 | 当前 shell 中未设置环境变量 | 设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN,然后重新启动 claude |
| “Conflicting credential”,或无法启动 | 已设置 ANTHROPIC_API_KEY | 使用 unset ANTHROPIC_API_KEY 将其移除 |
| 每个请求都出现错误 429 | 你所有服务商的密钥都已达到限制 | 在 Keys 页面添加更多服务商的密钥 |
| 工具调用失败,或智能体停止运行 | 该模型对工具调用的支持不佳 | 将该系列映射到上表中的某个模型 |
| 请求速度慢 | 在速度慢的免费模型上处理大型提示 | 固定使用一个快速模型,例如 Groq 或 Cerebras 模型 |
常见问题
Claude Code 可以免费使用吗?
Claude Code 程序可以免费安装。它需要模型 API 才能运行。使用 FreeLLMAPI 时,它调用的是免费服务商额度,因此推理费用为 $0。
我能免费获得真正的 Claude 模型吗?
不能。Anthropic 不提供免费的 Claude API。Claude Code 通过采用 Anthropic 格式的端点,在其他免费模型上运行,例如 Gemini、GPT-OSS、Qwen 或 GLM。
为什么使用 ANTHROPIC_AUTH_TOKEN,而不是 ANTHROPIC_API_KEY?
Claude Code 会将 ANTHROPIC_AUTH_TOKEN 作为 Bearer token 发送到你的网关。如果设置了 ANTHROPIC_API_KEY,Claude Code 会将其视为第一方凭据,并拒绝启动。
哪个免费模型最适合 Claude Code?
请使用支持工具调用且上下文窗口为 128K tokens 或更大的模型。本页的表格列出了目前同时满足这两项条件的最强免费模型。
这在 Windows 上可以使用吗?
可以。在 PowerShell 中使用 $env:ANTHROPIC_BASE_URL 和 $env:ANTHROPIC_AUTH_TOKEN 设置这两个变量,然后启动 claude。
相关指南
- 是否有免费的 Claude API?
- 最佳免费编程模型 API
- 将 Codex CLI 与免费模型配合使用
- Cline、Roo Code 和 Kilo Code 使用免费 API
- 免费 LLM API 速率限制
来源
- FreeLLMAPI docs: Anthropic and Claude clients (检查于 20 November 2026)
- FreeLLMAPI CLI generators (检查于 20 November 2026)
- Claude Code documentation: LLM gateway configuration (检查于 20 November 2026)