如何在不订阅的情况下免费使用 Claude Code

什么是 Claude Code？

Claude Code 是 Anthropic 面向终端的智能编码代理工具。它在您的项目目录中运行，读取与编辑文件、执行命令，并处理多步任务，无需您把任何内容复制到浏览器标签页。

它之所以需要付费，原因更偏结构性而非商业性。它的每个动作都是一次 API 调用，而代理式会话天生“话多”：模型会反复重读上下文、调用工具、检查结果并再试。一整个下午在大型仓库里忙碌，光是 token 成本就可能达到几美元，却不一定感觉特别高效。

如果您想了解这款工具日常能做什么，我们的Claude Code 教程联系了实际的安装、重构与调试。

Claude Code 是免费的吗？

直接答案是否定的。Anthropic 的安装文档说明，Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 账户，且免费 Claude.ai 计划不包含访问权限。Pro 起价为每月 20 美元，若按年预付 200 美元则相当于每月 17 美元。

另一种方式是 Console 计费，即按 token 计价、无需订阅。Claude Sonnet 5 通常为百万输入 token 3 美元、百万输出 token 15 美元。Claude Opus 5 分别为 5 美元与 25 美元，Haiku 4.5 为 1 美元与 5 美元。

这两种路线的计费逻辑完全不同，选错就会导致要么多花钱、要么任务中途被限流。下面是它们的对比。mpare.

关键的交叉点在于使用的稳定性，而非体量。只要不触顶，订阅能以远优于 API 的有效单价“购入” token，因此日常用户在 Pro 上几乎总是更划算。计量计费则在每周差异巨大的情况下胜出，因为清闲的周完全不花钱。

那么“免费”从何而来？大致有三处。

• 入门额度：Anthropic 发放给新 API 账户
• Claude Code 可以与任何支持 Anthropic Messages 格式 的服务器对话，包括免费的，无论是托管（OpenRouter）还是本地（Ollama）
• 面向开源维护者的资助项目

第二类需要提前提醒。把 Claude Code 指向免费模型，您得到的是界面与代理循环，而不是 Claude。本地多步推理的质量差距确实存在，我会在后文讨论。

免费计划包含 Claude Code 吗？

先说最常见的误解，因为它让许多人白白耗掉一个晚上。

免费层不包含 Claude Code。不是精简版、不是试用版，统统没有。Anthropic 自己的文档非常明确：免费计划覆盖 Web、iOS、Android 与桌面端的 Claude；终端代理不包含在内。

您得到的其实已经相当不错。自 2026 年 7 月 1 日起，免费计划默认运行 Claude Sonnet 5，并开放了网页搜索、文件上传、Projects 与 Artifacts，这些此前都在付费墙后。对于粘贴一段栈追踪并询问问题所在，这已经够用。

开发者最先撞到的免费层限制

Anthropic 不公布消息数，任何给出精确数字的说法都只是猜测。官方描述 Pro 至少是 Free 的五倍会话用量，这使 Free 更像基线而非固定配额。实践中，报告大多聚集在滚动 5 小时窗口内 15 到 40 条消息，消息更长或带附件会更快耗尽。

有几点比消息数更关键：

• 五小时窗口从您发出第一条消息时开始滚动。
• 无 Claude Code CLI 访问。这是最硬的限制，任何变通办法都改不了。
• 限制会随服务器负载弹性变化，峰值时段更差。
• 长对话单条成本更高，因为每一轮都会重读整段对话。

结论是：免费聊天层适合一次性问题与代码评审，但一旦需要围绕某个代码库持续来回，它就会垮掉——而这恰恰是 Claude Code 的用武之地。

选项一：Anthropic API 免费额度

这是最不为人知、但我认为多数人最该先试的官方路径。

在 platform.claude.com 创建账户会自动获得一次性入门额度。Anthropic 的定价文档仅称其为“一小部分免费额度”，未指明数字，但第三方报告一贯认为大约是 5 美元。

API 额度可用于验证 Claude Code CLI。您将获得真正的代理、运行真正的 Claude 模型、针对您的真实代码库。该额度不会续发，并在 14 天后过期，所以把它当作试用而非供给。

设置 API 账户并领取额度

从零注册到可用代理全流程约 10 分钟，大部分时间在等安装器。我把它拆成五步，因为第三步里有个坑，会让人白白重来一次。

步骤 1：创建 Console 账户

前往 platform.claude.com 并用邮箱注册。Console 与 claude.ai 聊天界面是独立产品，因此现有的 Claude 账号不会跨用，您可能需要用相同地址再注册一次。

说明一下，有些账户在此阶段会被要求验证手机号。通过后，入门额度会自动到账，而不是通过促销字段领取。

步骤 2：检查额度余额

在控制台导航中打开“Billing”部分。起始余额会显示在那里，同时也有添加支付方式的选项，但此时您不需要。

请先检查这一点。如果余额为零，后续再正确配置也无法开启会话。

步骤 3：创建 API Key

前往“Settings > API Keys”并创建新密钥。起个三个月后仍能认出的名字，因为多数人最终会有好几个。

完整密钥只显示一次。一出现就复制到密码管理器，因为关闭弹窗而未复制意味着丢失密钥、需要重做这一步。

步骤 4：导出密钥并安装 Claude Code

在 shell 中将密钥导出为环境变量，然后安装 CLI。Anthropic 推荐原生安装器，它自带运行时，完全不需要 Node.js。

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
curl -fsSL https://claude.ai/install.sh | bash

在 Windows PowerShell 中，安装命令为 irm https://claude.ai/install.ps1 | iex。如果您更喜欢 npm，请注意自 Claude Code v2.1.198 起，该包需 Node.js 22 或更高版本，这与旧指南仍引用的 Node.js 18 下限不同：

npm install -g @anthropic-ai/claude-code

如果希望密钥在新终端窗口中仍然有效，请将这行 export 添加到 ~/.zshrc 或 ~/.bashrc。然后确认已安装：

claude --version

步骤 5：运行您的首次会话

切换到某个项目目录并启动代理。从主目录运行 claude 在技术上没问题，但没有可读的代码库，这个工具几乎派不上用场。

cd ~/projects/my-app
claude

首次在设置好 ANTHROPIC_API_KEY 的情况下启动，Claude Code 会提示您批准该密钥，而不是为 OAuth 打开浏览器。批准后即可进入欢迎界面，底部会确认当前工作目录：

若要确认计费路径而不仅是安装是否成功，请在会话内运行 /status。其中“API key” 一行显示 ANTHROPIC_API_KEY，这表明会话正在消耗 Console 额度，而不是已保存的 claude.ai 登录。

如果此时看起来有问题，claude doctor 会在不启动会话的情况下打印安装与设置诊断，比搜索报错字符串更高效。

免费额度能用多久？

用当前 Sonnet 5 的优惠价做个粗算。设想在真实仓库上进行 15 轮交互，每轮发送约 30,000 个上下文 token，并产出约 1,500 个输出 token。第一轮按输入全价计费，后面 14 轮大多命中提示缓存，按该价的 10% 计费。

把这当作数量级而非报价。上述模型假设上下文平坦，并忽略了缓存写入溢价（五分钟缓存为基础输入价的 1.25 倍），所以您的真实会话会落在两边之一。

最后两行之间的差距最值得记住。缓存能把账单削去大约四分之三，这也是为什么 Claude Code 会话的实际成本远低于朴素 token 计数，以及为什么任何破坏缓存的行为（在仓库间跳转、频繁重启会话、中途切换模型）会悄悄让成本翻三倍。Anthropic 的定价文档有完整的倍率表，便于精确建模。

模型费率差异

模型选择对成本的影响大过您能控制的其他因素。把同样的 15 轮会话跑过整条产品线：

因此，五美元的余额能买到介于 5 到 27 次会话之间，完全取决于您所指向的模型。评估时，Sonnet 5 是理性的默认选项。

请把这笔钱用在一个真正的任务上，而不是玩具示例。重构一个您真正维护的模块，或沿着三个文件追查一个 bug——这才是判断该工具是否配得上您每周时间的唯一方式。

当余额归零时，没有兜底。Console 是按用量付费，Claude Code 之下没有免费层等着接住您。

选项二：OpenRouter 免费模型

OpenRouter 是一个 API 网关，前面挂着几百个模型，其中有少量轮换的模型可零成本调用。无需信用卡、无月费、无订阅。

这之所以能与 Claude Code 配合，是因为 CLI 从环境变量读取端点。改变量，就能改请求去向。OpenRouter 提供所谓“Anthropic Skin”，即接受 Anthropic Messages 格式的端点，并原样透传 thinking 块与原生工具调用，无需本地代理。

请务必弄清您得到的是什么，因为这些并非 Claude 模型。您保留的是 Claude Code 的界面、代理循环、文件编辑与斜杠命令，而由某个 Qwen 或 Llama 变体来进行推理。

OpenRouter 的文档自己也提醒：Claude Code 仅保证在路由到 Anthropic 自家模型时正常工作，“可能无法在其他提供商处正确工作”。我更愿意如实引用这一点。

重定向如何工作

需要三个变量：

• ANTHROPIC_BASE_URL 指向 https://openrouter.ai/api，而非 Anthropic 的端点。

• ANTHROPIC_AUTH_TOKEN 携带您的 OpenRouter 密钥，并作为 Authorization: Bearer 头发送。

• ANTHROPIC_API_KEY 必须显式设为空字符串；否则 Claude Code 可能回退去 Anthropic 认证。

您可以在 shell 配置文件或 Claude Code 设置文件中设置这些变量。需要避免的一点：项目的 .env 文件无效，因为原生安装器不读取标准 .env 文件。

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-your-openrouter-key",
    "ANTHROPIC_API_KEY": ""
  }
}

该文件放哪儿比看起来更重要。使用 ~/.claude/settings.json 作为全局配置；或针对单个项目使用 .claude/settings.local.json，Claude Code 会自动将后者加入 gitignore。

请不要把凭据放进项目的 .claude/settings.json，该文件会被提交并随仓库共享给所有克隆者。

用 OpenRouter 设置 Claude Code

1. 安装 Claude Code（若尚未安装），推荐使用原生安装器。

2. 在 openrouter.ai 创建免费账户，并在 Settings > Keys 下生成密钥。不调用付费模型的账户无需绑定银行卡。

3. 写入配置到 ~/.claude/settings.json（见上文代码块），或在 shell 配置中导出同样三个变量。

4. 如果您曾用 Anthropic 账号登录过 Claude Code，请在 CLI 内运行 /logout，然后退出并重启。缓存会话会覆盖您的变量，表现为令人困惑的“找不到模型”错误。

5. 启动 claude 并检查请求的去向。

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api

您的请求也应在几秒内出现在 OpenRouter 的活动面板，这是确认重定向已生效的最快方式。

在 OpenRouter 上选择免费模型

免费模型的 ID 以 :free 结尾，名单会随着提供商增减或改价而频繁变动。OpenRouter 免费模型集合展示当前可零成本使用的模型。openrouter/free 是 OpenRouter 面向免费模型的自动路由器，它会挑选可用且匹配您请求的模型，这能在单个模型下线后维持您的配置可用。起点最简单，但质量波动很大。

OpenRouter 的定价、额度与免费模型名录大致按月更迭，本文写作期间其中一些也发生了变化。在基于任何数字做决定之前，请查阅 Anthropic 的定价页与 OpenRouter 的免费筛选。

再谈一下速率限制，它的影响往往比模型选择更大。免费模型无论账户如何，每分钟限 20 个请求；若您从未购买过额度，则每天限 50 个请求。一次性购买 10 美元额度后，每日上限提升到 1,000，并在余额归零后仍保持该上限。

“每天 50 次请求”看起来可行，直到您想起代理会话花请求的速度，和一个健谈同事花您下午的速度差不多。一项稍复杂的任务就可能耗掉每日额度的三分之一。失败的尝试也计数，所以盲目重试只会雪上加霜。

为给不同角色路由特定模型，Claude Code 暴露了各层的单独变量：

bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="cohere/north-mini-code:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="cohere/north-mini-code:free"
export CLAUDE_CODE_SUBAGENT_MODEL="cohere/north-mini-code:free"

简单重构、单文件编辑与解释类任务表现尚可。但多步长任务退化明显，常见失败模式是“工具调用”而非原始代码质量：模型会选错工具、误读结果或陷入循环。

如果您想更有章法地按任务混用模型，我们的Claude Code Router 指南详细介绍了多模型路由。

选项三：Ollama 本地模型

Ollama 让您在本机运行开源模型。无需 API 密钥、无速率限制、权重下载完成后也无需联网。

2026 年 1 月，Ollama 在 v0.14.0 中加入了对 Anthropic Messages API 的兼容，使该工作流变得可行。在此之前，需要一个中间翻译代理。现在 Claude Code 可直接对接 localhost。

成本并未消失，而是转移到硬件——更具体地说，是转移到内存带宽，不仅仅是容量。

• 在 Apple Silicon 上，需关注统一内存：16 GB 可运行约 14B 的模型，如 gpt-oss:20b，但值得用的 30B 级编码模型在叠加 32K 上下文后更希望 32 GB 以上。

• 在 Windows 或 Linux 机器上，关键数值是GPU 显存，不是系统内存——能装载进内存但仅跑在 CPU 上的模型，对于代理式工作而言太慢，因为每个任务都会触发几十次调用。

用 Claude Code 配置 Ollama

1. 安装 Ollama。在 macOS 与 Linux 上为 curl -fsSL https://ollama.com/install.sh | sh，Windows 上请从 ollama.com 下载并运行安装器。

2. 拉取一个编码模型。尽管比不上当前的 Claude 模型，Qwen3-Coder 仍是不错选择：ollama pull qwen3-coder。

3. 用 ollama list 确认模型已在本地。

4. 提高上下文长度，这是大家最容易忘的设置，随后又怪罪模型。Ollama 建议 Claude Code 至少 32K token。

5. 将 Claude Code 指向本地端点并选择模型。

bash
export OLLAMA_CONTEXT_LENGTH=32768
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434

claude --model qwen3-coder

鉴权 token 是协议所需，Ollama 会忽略其值。如果您希望配置持久化，可把同样三个键写入 ~/.claude/settings.json 的 env 块。

在评估结果之前，有两点差距需要了解：

• 不适用 Anthropic 的提示缓存，因此每次请求都会从头处理系统提示与完整会话历史，这里表现为变慢而非变贵。

• Ollama 的兼容层也会忽略 tool_choice，该字段用于 Claude Code 在必要时强制调用特定工具；这会在关键场景下导致代理选错工具并陷入循环。

若想要该设置的更深入演练，我们有专门教程：将 Claude Code 与 Ollama 本地模型配合使用，以及分别讲解本地运行 Qwen 3 与 DeepSeek R1 的指南。

硬件现实检视

对大多数开发者而言，除非您有 32 GB 以上的统一内存/显存、需要离线，或必须保证代码不离开本机，否则 OpenRouter 胜过 Ollama。最后一条理由很充分，这也是我不会仅凭性能就否掉这条路线的原因。

选项四：Claude for Open Source 计划

多数相关文章就停在前三个选项，错过了那个能让您免费获得“真·产品”、而且是最高层级、为期半年的方案。

Anthropic 于 2026 年 2 月启动了 Claude for Open Source，并在 7 月扩展。符合条件的维护者与贡献者可免费获得六个月的 Claude Max 20x（每月 200 美元的套餐）。这包括 Claude Code，且给到消费者层级的最高使用上限。

公开的资格路径比多数人想象的更宽：

• 满足以下任一：在 npm、PyPI、crates.io、RubyGems 或类似注册中心，拥有 500 个以上依赖仓库、100 个以上依赖包，或月下载量总计 20 万以上的包的维护者。
• 列名于公认基金会或语言项目的提交者，如 CPython、Rust 团队、Node.js TSC、Apache PMC、CNCF、Kubernetes、Linux 内核、Django、Rails 等。
• 过去 12 个月里，在非自有仓库中合并的 PR 作者数累计 100 次或以上。
• 社区建设者：其仓库在过去一年内有 20 名以上独立外部贡献者的 PR 被合并。
• OpenSSF 关键性评分 0.4 或以上的项目维护者。

Anthropic 的页面明确欢迎边界案例申请，并说明生态系统在默默依赖什么。该计划上限 10,000 名受益者，滚动审核；申请入口为 claude.com/contact-sales/claude-for-oss。

需要注意：这覆盖的是订阅，而非 API 额度。您的 ANTHROPIC_API_KEY 使用仍单独计费，因此它更像个人计划，而非可指向 CI 流水线的资源。

为您选择合适的“免费”选项

两个问题就能定案。您要 Claude Code 做什么？在开始感到无聊前，您愿意为设置投入多少时间？

对比表

该选哪个？

• 如果您从未用过 Claude Code、想知道是否值每月 20 美元，先用 API 入门额度。这是唯一能让您体验“真·产品”的路径，而十来次会话足以形成判断。
• 如果您要持续的免费访问且并不特定需要 Claude，OpenRouter 在质量与投入之间最均衡。请预留一个晚上的首次配置时间，并预期会比想象中更快触及每日请求上限。
• 如果您需要离线，或雇主对源码流转有严格要求，Ollama 是答案，尽管要付硬件账。统一内存/显存低于 16 GB，我不建议折腾。
• 如果您维护的是别人会依赖的东西，在做其他选择前先查看开源资助。顶级套餐的六个月会让整个问题不复存在。

重定向方案的故障排查

选项 3 与 4 有相同的失败面向，且大多数问题都集中在少数几类。由于无论是 Anthropic 还是网关提供商都无法排查您独特的组合，先检查以下事项。

• Claude Code 一直要求登录。CLI 本身没有凭据，而能连通的 base URL 并不等于凭据。项目的 .claude/settings.json 中的 env 块只会在首次引导之后生效，所以请把 ANTHROPIC_AUTH_TOKEN 设在更早读取的位置：shell 的导出或 ~/.claude/settings.json。

• 启动警告显示两个凭据来源。网关凭据与已保存登录同时生效。运行 /logout 清除已保存登录，或取消设置变量、回退到先前登录。

• 出现 400 错误，提示无法识别的字段。Claude Code 会向 Anthropic 格式端点发送某些字段，但上游可能拒绝。设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 可屏蔽大多数预发布字段，便于定位。

• 出现 400 错误，提到 thinking 或 adaptive。上游模型不接受自适应推理，而 Claude Code 会为最新 Claude 模型请求它。这通常需要更新网关的上游，而非客户端修复。

• 远程控制与语音听写失效。两者都依赖 claude.ai 身份，在设置网关凭据时不可用。自 v2.1.196 起，只要 ANTHROPIC_BASE_URL 指向非 Anthropic 主机，远程控制也会被禁用。

当某处行为异常、您不确定是哪一层导致时，在会话中运行 /status 可告诉您实际在用的 base URL 与凭据来源。这个命令解决的问题，比反复重设环境变量有效得多。

最后的想法

四条免费使用 Claude Code 的路径，没有一条完美，而有趣之处恰恰在于取舍，而非事后的补充说明。

我个人的建议很明确：如果您要的是 Claude Code 的 CLI 代理而不是聊天窗口，请从 API 额度开始，因为一次真实的“真·产品”会话，比一个晚上配置替代品更能说明问题。如果它配得上您的工作流，每月 20 美元是合理支出；如果不值，您也没损失什么，而且知道了为什么。

从长期看，OpenRouter 是最可持续的免费方案；一旦隐私或离线访问是“刚需”而非“锦上添花”，Ollama 就胜出。

若想了解能让会话从“糟心”变“有用”的习惯，请查看我们的 Claude Code 最佳实践，涵盖在真实项目中的规划、上下文传递与测试驱动开发。如果您从零开始，Claude Code 101 通过交互式的结构化课程，带您从首次安装到一套可用的工作流。