> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code 配的是 Opus，日志里为什么有 Haiku？

> Claude Code 会把后台辅助任务和部分子 Agent 交给轻量的 Haiku 模型来省钱，这是客户端的正常行为；如需全部走 Opus，可用环境变量强制指定。

## 简短回答

**这是 Claude Code 客户端自己的省钱机制，不是网关替换了模型。** 你在 Claude Code 里配置的 `claude-opus-5` 只负责主对话；生成会话标题、判断话题这类后台小任务，以及内置的 Explore 等子 Agent，Claude Code 默认交给更便宜的 Haiku 模型（如 `claude-haiku-4-5-20251001`）去跑，所以日志里会同时出现两种模型。

如果希望所有请求都走 Opus，可以用环境变量强制指定，见下方 [强制全部走 Opus](#强制全部走-opus)。

## 怎么在日志里认出来

在控制台「使用日志」里，这类 Haiku 请求通常有三个特征：

* **令牌和分组与 Opus 请求完全一样**：同一把 Key、同一个 `ClaudeCode` 分组，说明来自同一个 Claude Code 客户端
* **单次 tokens 很少、费用极低**：输入输出往往只有几十到几百 tokens，与主对话动辄上千上万 tokens 的 Opus 请求形成明显对比
* **跟着你的操作成批出现**：开新会话、让 Claude Code 搜代码库、派子任务时集中冒出来

<Info>
  **模型名就是客户端发来的模型名。** API易 按请求里的 `model` 字段转发和计费，日志里看到 Haiku，就是 Claude Code 主动请求了 Haiku——这部分只按 Haiku 的价格计费，不会按 Opus 收。
</Info>

## Claude Code 为什么这么做

Claude Code 内置了「大模型 + 小模型」两档分工：

| 任务类型 | 默认使用的模型 | 对应环境变量 |
| - | - | - |
| 主对话、写代码、改文件 | 你选择的主模型（如 Opus） | `ANTHROPIC_MODEL` |
| 会话标题、话题判断等后台辅助任务 | Haiku 档模型 | `ANTHROPIC_DEFAULT_HAIKU_MODEL` |
| 子 Agent（如内置 Explore 检索代码库） | 由子 Agent 自身配置决定，部分默认 Haiku | `CLAUDE_CODE_SUBAGENT_MODEL` |

后台任务和代码检索对模型能力要求不高，但调用次数多，用 Haiku 能显著降低整体费用，也更快。**对大多数人来说保持默认就好。**

## 强制全部走 Opus

如果你希望每一个请求都用 Opus（例如对子 Agent 的检索质量有更高要求），在 `~/.claude/settings.json` 的 `env` 里把各档模型都指向同一个 Opus 型号：

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API易密钥",
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-5-5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-opus-5-5"
  }
}
```

保存后**重启 Claude Code** 生效。再看使用日志，应只剩 `claude-opus-5-5` 一种模型。

<Tip>
  **主模型建议直接用 `claude-opus-5-5`。** 它比 `claude-opus-5` 更新、更好用，在 `ClaudeCode` 分组下即可调用，把上面配置里的模型名照抄即可。
</Tip>

<Warning>
  **全部走 Opus 会明显增加费用。** 后台任务和子 Agent 调用次数多，原本按 Haiku 价格计费的这部分请求会全部按 Opus 价格计费。如果只是想让小模型更聪明一些，可以折中把 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 改成更新的 `claude-haiku-5-5`，其余保持默认。
</Warning>

## 常见问题

<AccordionGroup>
  <Accordion title="Haiku 请求会不会是我的 Key 泄露、被别人在用？">
    看令牌、IP 和时间线：如果 Haiku 请求和你的 Opus 请求用的是同一把令牌、来自同一个 IP、时间上紧挨着你的操作，那就是你自己的 Claude Code 发出的。若出现你不认识的 IP 或在你没用的时间段大量调用，再按 Key 泄露处理，参见 [令牌管理](/faq/token-management)。
  </Accordion>

  <Accordion title="我用 /model 切到了 Opus，为什么还有 Haiku？">
    `/model` 只切换主对话模型，不改后台辅助任务和子 Agent 使用的模型。要一并改，需按上文配置 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 与 `CLAUDE_CODE_SUBAGENT_MODEL`。
  </Accordion>

  <Accordion title="CC Switch 等工具里怎么改？">
    CC Switch 这类工具本质也是写入 Claude Code 的环境变量，在对应供应商配置里把上述几个变量填成 `claude-opus-5-5` 即可，参见 [CC Switch 配置](/scenarios/programming/cc-switch)。
  </Accordion>
</AccordionGroup>

## 相关文档

<CardGroup cols={2}>
  <Card title="Claude Code 接入指南" icon="terminal" href="/scenarios/programming/claude-code">
    安装、配置 API易 与常见问题
  </Card>

  <Card title="Codex、ClaudeCode 和 Default 分组" icon="layers" href="/faq/codex-claudecode-default-groups">
    Claude Code 该用哪个令牌分组
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.