Source: https://aiprimetech.io/zh/learn/use-claude-api-with-claude-code/ [首页](/zh/) / [学习](/zh/learn/) / 不限量使用 Claude Code # 不限量访问 Claude Code Claude Code 是 Anthropic 官方推出的命令行软件开发智能体。它使用 200k 的上下文窗口，会创建拥有独立上下文的子智能体，将整个文件读入对话历史，并在每轮交互中重新发送完整上下文，使长时间会话中的 token 消耗呈二次增长。这使它成为目前 token 消耗最高的开发者工具之一。将 Claude Code 接入固定费率的无限用量网关，可以让它从需要谨慎控制用量的工具，转变为真正随时可用的开发伙伴。 ## 为什么 Claude Code 的 token 消耗呈二次增长 从 API 的角度来看，Claude Code 在各轮交互之间不保留状态。您发送的每条消息都包含整个对话历史，包括之前的所有消息、读取过的所有文件内容、所有工具结果以及所有助手回复。首条消息可能只有 5,000 个 token。到第十轮交互时，您发送的内容已包含 50,000 个 token 的历史记录，以及新增的内容。到第二十轮交互时，每次请求的上下文可能超过 150,000 个 token。 子智能体会进一步加剧这种情况。当 Claude Code 将工作委派给子智能体时，该子智能体会获得自己的上下文窗口，并开始独立积累历史记录。父智能体的上下文会因纳入子智能体的摘要而增长，同时子智能体本身也会产生自己的 token 费用。由多个子智能体协作组成的智能体团队会进一步放大这种消耗。一个复杂任务可能包含一个父智能体和三个子智能体，每个智能体的上下文都超过 100k 个 token，并且全部使用同一个 API 密钥。 /compact 命令通过总结历史记录并截断旧上下文来缓解这一问题，但它需要手动介入，以牺牲细节来换取空间。在按 token 计费时，用户会频繁压缩上下文以控制成本。在无限用量方案下，您可以让对话自然增长，仅在上下文质量下降时进行压缩，并自由使用子智能体，无需在心里计算其成本。 ## 环境变量配置 Claude Code 从环境变量中读取 API 配置。两个必要变量是 ANTHROPIC_BASE_URL，以及 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN 中的一个。将 ANTHROPIC_BASE_URL 设置为 https://unlimited.aiprimetech.io，即不带 /v1 的根主机地址，因为 Anthropic SDK 会自动追加 API 路径。对于密钥，如果您的网关要求通过 x-api-key 请求头进行身份验证（标准 Anthropic 格式），请使用 ANTHROPIC_API_KEY。 将这些变量设置在 shell 配置文件（.bashrc、.zshrc 或 PowerShell $PROFILE）中，以持久保存配置。在 Windows 上，您也可以通过“高级系统设置”对话框将它们设为系统环境变量。Claude Code 会在启动时读取这些变量；如果修改了变量，请重启 Claude Code 会话，使新值生效。 如需按项目覆盖配置，请在项目根目录创建 .env 文件。Claude Code 会从工作目录加载 .env 文件。这样，您就可以为不同项目使用不同的 API 配置；如果部分项目使用无限用量方案，其他项目直接使用 Anthropic 计费，这会很有用。.env 文件的优先级高于系统环境变量。 ## Sonnet、Opus、Haiku 和 Fable 的模型映射 Claude Code 使用内部模型别名，您可以通过环境变量覆盖这些别名。ANTHROPIC_DEFAULT_SONNET_MODEL 控制默认选择“sonnet”时使用的模型。ANTHROPIC_DEFAULT_OPUS_MODEL 覆盖“opus”选项。ANTHROPIC_DEFAULT_HAIKU_MODEL 和 ANTHROPIC_DEFAULT_FABLE_MODEL 控制其余档位。请将这些变量设置为网关支持的准确模型 ID。 例如，设置 ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 和 ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6.。当您在 Claude Code 中使用 /model 或启动标志选择模型档位时，它会解析为您映射的模型。如果网关提供自定义模型标识符，或者您希望固定使用特定模型版本，这尤其有用。 在无限用量方案下，选择模型只需权衡质量与速度。不同档位之间没有费用差异。将 Opus 设为默认模型以获得最高质量，仅在快速迭代期间需要更快响应时才切换到 Sonnet 或 Haiku。/effort 命令可以进一步调整 Claude Code 处理每项任务的深入程度；将高投入程度与 Opus 结合使用，可获得能力最强的配置。 ## 子智能体、智能体团队与后台智能体 Claude Code 可以创建子智能体，即拥有独立上下文窗口、负责处理所委派子任务的独立 Claude 实例。当主智能体遇到复杂任务时，它可以将研究、实现或验证工作委派给子智能体，让它们独立工作并汇报结果。每个子智能体都从全新的上下文开始，并积累自己的对话历史。 智能体团队进一步扩展了这一概念，允许多个子智能体同时协作处理相关工作。主智能体充当协调者，分派工作并汇总结果。这对大规模变更非常有用：一个子智能体可以重构模块 A，另一个处理模块 B，但 API 消耗会随着活跃智能体数量的增加而线性增长。 后台智能体会异步运行，而您可以继续在主会话中工作。它们处理独立任务，并在完成后汇报结果。在按 token 计费时，同时运行多个后台智能体会迅速推高费用。在无限用量方案下，您可以启动多个后台智能体，让它们处理项目的不同方面，并在结果就绪后进行审查；所有这些都包含在固定费用中。 设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1，以阻止 Claude Code 发送遥测数据和非必要请求。对于任何自定义网关，这都是减少无关请求的良好做法。此外，CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 会让 Claude Code 向网关查询可用模型，而不是使用硬编码列表。 ## 无头模式与 CI/CD 集成 Claude Code 的无头模式（--headless 标志）无需交互式提示即可运行，适用于 CI/CD 流水线、自动代码审查和批处理。在无头模式下，Claude Code 从 stdin 或命令行参数读取输入，并将结果输出到 stdout。任务完成后，它会退出，而不是等待进一步输入。 进行 CI 集成时，请在流水线配置中设置环境变量（GitHub Actions 密钥、GitLab CI 变量、Jenkins 凭据），并将任务描述作为参数来调用 Claude Code。常见的 CI 用例包括自动 PR 审查、文档生成、测试编写和迁移脚本。 在无限用量方案下，无头模式可支持高吞吐量工作流。您可以为仓库中的每个 PR 运行 Claude Code，批量为未经测试的模块生成测试套件，或在每次发布时自动更新文档，无需担心每次调用的成本。只要用量保持在公平使用速率限制内，全部用量都包含在固定费用中。 ## CLAUDE.md 项目记忆与钩子 CLAUDE.md 文件提供 Claude Code 自动加载的持久项目上下文。在项目根目录放置一个 CLAUDE.md 文件，写入编码标准、架构决策、常见模式和项目专属指令。这些内容会被纳入每次请求的系统提示词，增加每次调用的 token 数，但也能显著提高响应质量和一致性。 在按 token 计费时，用户会尽量精简 CLAUDE.md 以控制成本，因为在整个会话期间，其中的每个词都会增加每次请求的 token 数。在无限用量方案下，您可以写入所有真正有帮助的上下文：详细的架构文档、完整的风格指南、依赖项说明和团队约定。每次请求增加的 token 不会产生额外费用，而质量提升会在每次交互中持续累积。 钩子允许您在 Claude Code 执行过程中的特定节点运行自定义脚本，例如工具调用前后、会话启动时以及上下文压缩时。您可以使用钩子注入动态上下文、通过 CI 验证变更、自动格式化代码或触发通知。钩子运行在 CLI 层面而非 API 层面，因此可与无限用量网关无缝集成。 ## Claude Code 网关问题排查 如果 Claude Code 无法连接，请确认 ANTHROPIC_BASE_URL 已设置为不带 /v1 的根主机地址。运行 echo $ANTHROPIC_BASE_URL（在 PowerShell 中使用 $env:ANTHROPIC_BASE_URL）来确认其值。SDK 会自动追加 /v1/messages；如果在基础 URL 中包含 /v1，请求就会发往 /v1/v1/messages，并返回 404。 “找不到模型”错误意味着映射变量中的模型 ID 与网关提供的模型不匹配。请在 AI Prime Tech 控制台中查看支持的准确标识符，并相应更新 ANTHROPIC_DEFAULT_SONNET_MODEL。请记住，模型 ID 区分大小写，并包含版本后缀。 如果会话可以正常运行，但子智能体失败，问题可能在于子智能体会因启动方式不同而以不同方式继承环境变量。请确保在系统级别设置环境变量，而不是仅在当前 shell 会话中设置，尤其是在 Windows 上，子进程可能不会继承仅在 shell 内设置的变量。 复制 ``` # Shell environment (add to .bashrc / .zshrc / $PROFILE) export ANTHROPIC_BASE_URL="https://aiprimetech.io" export ANTHROPIC_API_KEY="" export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5" export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6" export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 # Or per-project .env file: # ANTHROPIC_BASE_URL=https://aiprimetech.io # ANTHROPIC_API_KEY=sk-... # ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 # Run Claude Code: # claude (interactive) # claude --headless (CI/CD mode) ``` ## 常见问题 为什么 Claude Code 使用的 token 比聊天多得多？ Claude Code 在每轮交互时都会重新发送完整的对话历史，因为 API 端是无状态的。随着会话增长，每个请求都会携带此前的所有消息、文件内容和工具结果。这会导致 token 用量呈二次增长，会话中的第二十条消息可能比第一条大 10-20x。 子智能体的用量会单独计入我的用量吗？ 每个子智能体都会运行独立的对话，并拥有自己的上下文窗口。在无限套餐中，所有智能体对话，包括主智能体、子智能体和后台智能体，都包含在固定费用内。不会按智能体或对话额外收费。 我应该在 ANTHROPIC_BASE_URL 中包含 /v1 吗？ 不需要。将其设置为根主机地址：https://unlimited.aiprimetech.io。Anthropic SDK 会自动追加 /v1/messages。如果在变量中包含 /v1，就会造成路径重复，并返回 404 错误。 我可以使用无限套餐在 CI/CD 中运行 Claude Code 无头模式吗？ 可以。在流水线的机密变量中设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY，然后运行 claude --headless 并传入任务参数。无限套餐以相同的固定费用涵盖 CI 用量，但须遵守公平使用速率限制。 如何在 Claude Code 中切换模型？ 在会话中使用 /model 命令，或设置 ANTHROPIC_DEFAULT_SONNET_MODEL 和 ANTHROPIC_DEFAULT_OPUS_MODEL 环境变量，控制各个层级使用的模型。在无限套餐中，不同模型的费用没有差别。 几分钟内开始使用 Claude 获取 API 密钥，无需 Anthropic 账户，也无需加入候补名单。[获取你的 API 密钥](/register) AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。 ## 更多 Claude API 指南 [如何获取 Claude API 密钥](/zh/learn/how-to-get-a-claude-api-key/)[Claude API 定价详解](/zh/learn/claude-api-pricing-explained/)[使用 Claude API 最便宜的方式](/zh/learn/cheapest-way-to-use-claude-api/)[通过 Claude API 不限量使用 Cursor](/zh/learn/use-claude-api-with-cursor/)[Claude API 网关与 Anthropic 直连对比](/zh/learn/claude-api-vs-anthropic-direct/)[通过兼容 OpenAI 的 API 使用 Claude](/zh/learn/openai-compatible-claude-api/)[Claude 模型对比](/zh/learn/claude-api-models-compared/)[使用加密货币支付 Claude API 费用](/zh/learn/claude-api-with-crypto-payment/)[无需候补名单即可访问 Claude API](/zh/learn/claude-api-without-waitlist/)[如何减少 Claude 词元用量](/zh/learn/how-to-reduce-claude-token-usage/)[通过 Claude API 不限量使用 Cline](/zh/learn/use-claude-api-with-cline/)[通过 Claude API 不限量使用 Roo Code](/zh/learn/use-claude-api-with-roo-code/)[在 JetBrains IDE 中不限量使用 Claude](/zh/learn/use-claude-api-with-jetbrains/)[通过 Claude API 无限制使用 Aider](/zh/learn/use-claude-api-with-aider/)[在 VS Code 中不限量使用 Claude](/zh/learn/use-claude-api-with-vscode/)[通过 Claude API 无限制使用 OpenCode](/zh/learn/use-claude-api-with-opencode/)[在 Claude 上运行不受限制的 Hermes 智能体](/zh/learn/run-hermes-agent-with-claude-api/)[使用 Claude 不限量运行 OpenClaw](/zh/learn/run-openclaw-with-claude-api/)[兼容 Anthropic 的 API 意味着什么](/zh/learn/anthropic-compatible-api/)[Claude Code API 密钥：如何获取和配置](/zh/learn/claude-code-api-key-setup/)[Claude Code API 成本 — 定价与降低成本的方法](/zh/learn/claude-code-api-costs/)[Claude API 错误：速率限制及 400、500、529 错误的解决方法](/zh/learn/claude-api-errors-troubleshooting/)[如何购买 Claude API 额度](/zh/learn/buy-claude-api-credits/)[Claude API 免费试用：哪些确实免费，哪些不免费](/zh/learn/claude-api-free-trial/)[Claude API 与 Claude Pro/Max 订阅——如何选择](/zh/learn/claude-api-vs-subscription/)[使用 Claude 运行 Codex CLI](/zh/learn/use-claude-api-with-codex/)[将 Claude 连接到 n8n](/zh/learn/use-claude-api-with-n8n/)[通过 LiteLLM 路由到 Claude](/zh/learn/use-claude-api-with-litellm/)[在 Kilo Code 中使用 Claude](/zh/learn/use-claude-api-with-kilo-code/)[将 Claude 接入 GitHub Copilot](/zh/learn/use-claude-api-with-github-copilot/)[通过网关将 Zed 连接到 Claude](/zh/learn/use-claude-api-with-zed/)[将 Cherry Studio 连接到 Claude](/zh/learn/use-claude-api-with-cherry-studio/)[将 LangChain 指向网关上的 Claude](/zh/learn/use-claude-api-with-langchain/)[使用 Claude 运行 Factory Droid](/zh/learn/use-claude-api-with-factory-droid/)[Claude Code API 详解](/zh/learn/claude-code-api/)[将 Claude API 集成到您的应用中](/zh/learn/claude-api-integration/)