不限量访问 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="<your AI Prime Tech Unlimited 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)

常见问题

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。