> ## 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 洩露處理，參見 [令牌管理](/zh-Hant/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 配置](/zh-Hant/scenarios/programming/cc-switch)。
  </Accordion>
</AccordionGroup>

## 相關文件

<CardGroup cols={2}>
  <Card title="Claude Code 接入指南" icon="terminal" href="/zh-Hant/scenarios/programming/claude-code">
    安裝、配置 API易 與常見問題
  </Card>

  <Card title="Codex、ClaudeCode 和 Default 分組" icon="layers" href="/zh-Hant/faq/codex-claudecode-default-groups">
    Claude Code 該用哪個令牌分組
  </Card>
</CardGroup>


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