首页 / 指南 / 如何免费使用 Claude Code

如何免费使用 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>"
claude
重要:使用 ANTHROPIC_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 的免费模型。

适用于 Claude Code 的免费模型:支持工具调用,上下文 128K 以上
模型免费提供方上下文免费额度(最优惠)工具视觉
GLM 5.3UnoRouter1M1 请求/分钟
1 req/min per model
是否
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 请求/分钟
40 RPM
是是
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quota是是
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowance是否
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring credit是是
Gemini 3.7 FlashGoogle AI Studio1M10 请求/分钟
20 请求/天
250,000 令牌/分钟
~3M
是是
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring credit是是
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 请求/分钟
50 请求/天
50 req/day account-wide (1,000 after a $10 purchase)
是是
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 请求/分钟
50 请求/天
Shared rate limit
是否
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 请求/分钟
250 请求/天
70,000 令牌/分钟
~6M
是是
Gemini 3.6 FlashGoogle AI Studio1M10 请求/分钟
20 请求/天
250,000 令牌/分钟
~3M
是是
Qwen 3.8 27BCloudflare Workers AI262KShared 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 模型
通过一个密钥使用以上每一个模型。 FreeLLMAPI 是一个开源的自托管路由器。它将所有这些免费套餐放在一个兼容 OpenAI 的端点之后,并在某个套餐被限速时自动切换。 浏览目录 或 立即开始.

常见问题

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。

相关指南

来源

全部指南 · 浏览所有免费模型