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

# Anthropic

Anthropic 建構 **Claude** 模型系列。OpenClaw 支援兩種驗證途徑：

* **API 金鑰** - 直接存取 Anthropic API，採用量計費（`anthropic/*` 模型）
* **Claude CLI** - 重複使用同一主機上現有的 Claude Code 登入

## 用量與成本追蹤

OpenClaw 會偵測可用的 Anthropic 認證資訊，並選取相符的用量介面：

* Claude 訂閱／設定認證資訊會顯示配額週期與選用的額外用量預算。
* `ANTHROPIC_ADMIN_KEY` 或 `ANTHROPIC_ADMIN_API_KEY` 會在 Control UI 的 **用量** 中顯示供應商回報的 30 天組織成本與 Messages API 用量，包括每日支出、權杖／快取總計、最常用模型與成本類別。
* 儲存在 Anthropic 供應商設定檔中的 `sk-ant-admin...` 認證資訊，會自動偵測為 Admin API 金鑰。

Admin API 成本記錄來自 Anthropic 的[用量與成本 API](https://platform.claude.com/docs/en/manage-claude/usage-cost-api)。這是供應商的實際帳單，與 OpenClaw 根據工作階段推算的預估成本不同。

<Warning>
  OpenClaw 的 Claude CLI 後端會以非互動式列印模式
  （`claude -p`）執行已安裝的 Claude Code CLI。Anthropic 目前的 Claude Code 文件
  將該模式描述為 Agent SDK／程式化用法。Anthropic 於 2026 年 6 月 15 日的
  支援更新暫停了先前宣布的獨立 Agent SDK 計費變更：Claude
  Agent SDK、`claude -p` 與第三方應用程式用量仍會計入已登入
  訂閱方案的用量限制，而且在 Anthropic 修訂該方案期間，先前宣布的每月 Agent SDK
  額度並不可用。

  互動式 Claude Code 仍會計入已登入 Claude 方案的用量限制。
  API 金鑰驗證採直接隨用隨付計費，不依賴該方案。
  對於長期運作的閘道主機、共用自動化與需要可預測正式環境
  支出的情境，請使用 Anthropic API 金鑰。

  Anthropic 目前的支援文章可能在 OpenClaw 未發布新版本的情況下
  變更此行為：

  * [Claude Code CLI 參考資料](https://code.claude.com/docs/en/cli-usage)
  * [搭配你的 Claude 方案使用 Claude Agent SDK](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan)
  * [搭配你的 Pro 或 Max 方案使用 Claude Code](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan)
  * [搭配你的 Team 或 Enterprise 方案使用 Claude Code](https://support.claude.com/en/articles/11845131-using-claude-code-with-your-team-or-enterprise-plan)
  * [管理 Claude Code 成本](https://code.claude.com/docs/en/costs)
</Warning>

## 開始使用

<Tabs>
  <Tab title="API 金鑰">
    \*\*最適合：\*\*標準 API 存取與用量計費。

    <Steps>
      <Step title="取得你的 API 金鑰">
        在 [Anthropic Console](https://console.anthropic.com/) 中建立 API 金鑰。
      </Step>

      <Step title="執行導入設定">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard
        # 選擇：Anthropic API 金鑰
        ```

        或直接傳入金鑰：

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
        ```
      </Step>

      <Step title="確認模型可用">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider anthropic
        ```
      </Step>
    </Steps>

    ### 設定範例

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },
      agents: { defaults: { model: { primary: "anthropic/claude-opus-5" } } },
    }
    ```
  </Tab>

  <Tab title="Claude CLI">
    \*\*最適合：\*\*重複使用現有的 Claude CLI 登入，而不需要另外的 API 金鑰。

    <Steps>
      <Step title="確認 Claude CLI 已安裝並登入">
        使用以下指令確認：

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        claude --version
        ```
      </Step>

      <Step title="執行導入設定">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard
        # 選擇：Claude CLI
        ```

        OpenClaw 會偵測並重複使用現有的 Claude CLI 認證資訊。
      </Step>

      <Step title="確認模型可用">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider anthropic
        ```
      </Step>
    </Steps>

    <Note>
      Claude CLI 後端的設定與執行階段詳細資訊，請參閱[命令列介面後端](/zh-TW/gateway/cli-backends)。
    </Note>

    <Warning>
      重複使用 Claude CLI 時，OpenClaw 程序必須與
      Claude CLI 登入在同一主機上執行。Docker 安裝可以持久保存容器的家目錄，並在該處登入
      Claude Code；請參閱
      [Docker 中的 Claude CLI 後端](/zh-TW/install/docker#claude-cli-backend-in-docker)。
      [Podman](/zh-TW/install/podman) 等其他容器安裝不會在設定或執行階段掛載主機的
      `~/.claude`；請在其中使用 Anthropic API 金鑰，或選擇
      由 OpenClaw 管理 OAuth 的供應商，例如
      [OpenAI Codex](/zh-TW/providers/openai)。
    </Warning>

    ### 取得設定權杖

    在任何已安裝 Claude Code 的機器上執行 `claude setup-token`。它會輸出
    一個以 `sk-ant-oat01-` 開頭的長效權杖。

    在導入設定期間，於 macOS 應用程式中的 **Connect with an API key or token** 下選擇
    **Anthropic setup-token**，然後貼上權杖，或使用：

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models auth login --provider anthropic --method setup-token
    ```

    ### 設定範例

    建議使用標準 Anthropic 模型參照，並加上 CLI 執行階段覆寫：

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "anthropic/claude-opus-5" },
          models: {
            "anthropic/claude-opus-5": {
              agentRuntime: { id: "claude-cli" },
            },
          },
        },
      },
    }
    ```

    為了相容性，舊版 `claude-cli/claude-opus-4-7` 模型參照仍可使用，
    但新設定應將供應商／模型選擇保留為
    `anthropic/*`，並將執行後端放在供應商／模型的執行階段原則中。

    ### 計費與 `claude -p`

    OpenClaw 在 Claude CLI 執行作業中使用 Claude Code 的非互動式 `claude -p` 路徑。
    Anthropic 目前將該路徑視為 Agent SDK／程式化用法：

    * Anthropic 於 2026 年 6 月 15 日的支援更新暫停了先前宣布的
      獨立 Agent SDK 額度方案。
    * 訂閱方案的 Claude Agent SDK、`claude -p` 與第三方應用程式用量
      仍會計入已登入訂閱方案的用量限制。
    * 在 Anthropic 修訂該方案期間，先前宣布的每月 Agent SDK 額度
      並不可用。
    * Console／API 金鑰登入採用隨用隨付 API 計費，且不會獲得
      訂閱方案的 Agent SDK 額度。

    如需暫停通知，請參閱 Anthropic 的 [Agent SDK 方案
    文章](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan)；
    如需了解訂閱方案行為，請參閱 Claude Code 的
    [Pro／Max](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan)
    與
    [Team／Enterprise](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan)
    方案文章。

    Anthropic 可以在 OpenClaw 未發布新版本的情況下，變更 Claude Code 的計費與速率限制行為。
    若計費的可預測性很重要，請查看 `claude auth status`、`/status` 與
    Anthropic 的連結文件。

    <Tip>
      對於共用的正式環境自動化，請使用 Anthropic API 金鑰，而非
      Claude CLI。OpenClaw 也支援來自
      [OpenAI Codex](/zh-TW/providers/openai)、[Qwen Cloud](/zh-TW/providers/qwen)、
      [MiniMax](/zh-TW/providers/minimax) 與 [Z.AI／GLM](/zh-TW/providers/zai)
      的訂閱式選項。
    </Tip>
  </Tab>
</Tabs>

## 跨電腦的 Claude 工作階段

內建的 Anthropic 外掛會在一般工作階段側邊欄中新增 **Claude Code** 群組。
各列會在一般聊天窗格中開啟。它會探索閘道與已連線節點主機上
未封存的 Claude Code 工作階段：

* Claude CLI 工作階段來自有效的專案索引記錄。對於未編入索引的
  逐字稿，有限範圍的中繼資料備援會辨識 `~/.claude/projects/` 下同時存在、非側鏈的
  互動式（`cli`）與無頭 Agent SDK CLI（`sdk-cli`）工作階段。
* 當 Claude Desktop 的中繼資料指向相同的 Claude Code 工作階段 ID 時，
  Claude Desktop 工作階段會使用 Desktop 標題、活動時間與封存狀態。
* 僅限 CLI 的工作階段沒有封存旗標，因此只要其逐字稿仍存在，就會保持可見。

探索功能不需要額外的 OpenClaw 設定。Anthropic 外掛
已內建且預設啟用；當本機 `~/.claude/projects/` 目錄存在時，原生 macOS 節點會公布唯讀的
Claude 工作階段命令。這些命令首次出現時，請核准節點配對升級。

側邊欄會依各自的閘道或配對節點主機將各列分組，並在每台電腦回應時立即顯示該主機
最新的有限範圍頁面。主機連線狀態變更後、頁面重新取得焦點時，以及頁面可見期間最多每
30 秒，它都會再次進行同步，讓在 OpenClaw 外部建立的 Claude 工作階段無須重新載入即可出現。
目錄變更時，系統會更快進行後續同步。在目錄群組下方使用 **載入更多
工作階段**，可為每個仍有更多記錄的主機附加下一頁；附加的資料列會保持可見，
並在重新整理時重新擷取至相同深度。目錄用戶端使用 `sessions.catalog.list`；開啟資料列則使用
`sessions.catalog.read`。

終端機接管會先從擁有該主機的使用者登入 Shell PATH 解析 `claude`，
再使用服務／常駐程式 PATH。這可使由應用程式啟動的工作階段，
與操作者在一般終端機中使用的 Claude CLI 保持一致。

選取資料列時，會先讀取最新的逐字稿頁面。**載入較舊的逐字稿
項目**會沿用不透明的位元組游標，並從 JSONL 檔案讀取另一個有限範圍的區段，
而非載入完整記錄。一般使用者、助理、推理、工具呼叫與工具結果內容都會保留。
若個別項目超過節點／閘道安全上限，會清楚標示為已截斷。

對於閘道本機的 `claude-cli` 資料列，在一般撰寫區中輸入內容會呼叫
`sessions.catalog.continue`。OpenClaw 會重新解析本機目錄記錄、
建立或重複使用鎖定模型的原生工作階段、匯入最多 200 個可見
項目或 512 KiB，並植入 Claude CLI 繫結。第一輪會使用
`--fork-session` 恢復；Claude 會為分支指派新的工作階段 ID，因此後續輪次會使用
該分支，而來源工作階段維持不變。

無頭節點主機也可以啟用下方的節點本機設定並重新啟動節點主機，
讓其 Claude CLI 資料列可以繼續：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  nodeHost: {
    agentRuns: {
      claude: { enabled: true },
    },
  },
}
```

只有在該設定已啟用，且能解析其本機 `claude` 可執行檔時，
節點才會公布 `agent.cli.claude.run.v1`。OpenClaw 會在該節點上重新解析目錄
記錄、匯入相同的有限範圍記錄，並將採用的工作階段繫結至該節點和目錄回報的工作目錄。
每一輪都會使用該節點的 Claude 檔案與登入，執行節點上真正的
`claude -p` 程序。節點的執行核准原則仍然適用；閘道無法強制選擇加入。

節點延續 v1 僅支援單次操作。它會省略閘道回送 MCP 設定與
閘道 Skills 外掛引數、不會從閘道逐字稿重新植入，並拒絕附件與圖片。
Claude Desktop 資料列仍為僅供檢視。原生 macOS 應用程式節點在應用程式公布執行命令前，
也仍為僅供檢視。

<Note>
  除非無頭節點明確公布 `agent.cli.claude.run.v1`，否則配對節點上的 Claude 工作階段仍為唯讀。
  OpenClaw 絕不修改 Claude Desktop 中繼資料，也不會封存 Claude 工作階段。
  此頁面需要具備寫入範圍的操作者連線，因為它使用經驗證的 `node.invoke`；
  即使在已啟用延續功能的節點上，列出與讀取操作仍然是唯讀。
</Note>

請參閱[節點：Claude 工作階段與逐字記錄](/zh-TW/nodes#claude-sessions-and-transcripts)，
以瞭解節點命令與安全邊界。

## 思考預設值（Claude Opus 5、Sonnet 5、Mythos 5、Fable 5、4.8 與 4.6）

`anthropic/claude-opus-5` 預設使用 `high` 強度的自適應思考。
使用 `/think off` 可停用思考，或使用 `/think xhigh|max` 採用模型原生的
較高強度等級。由於 Anthropic 不支援在此模型的要求中使用這些功能，OpenClaw
會省略手動思考預算、自訂取樣參數、助理預填，以及 Opus 5 的 Priority Tier。
目錄會公布其 1,000,000-token 上下文視窗、128,000-token 輸出限制、圖片
輸入，以及 `$5/$25` 輸入／輸出定價。

`anthropic/claude-sonnet-5` 使用相同的自適應思考預設值與要求
限制。目錄採用 Anthropic 的入門 `$2/$10` 輸入／輸出
定價，適用至 2026 年 8 月 31 日；標準 `$3/$15` 定價自 2026 年 9 月 1 日起生效。

`anthropic/claude-fable-5` 一律使用自適應思考，且預設為 `high`
強度。Anthropic 不允許停用此模型的思考，因此
`/think off` 與 `/think minimal` 會改為對應至 `low` 強度。OpenClaw 也會
省略 Fable 5 要求中的自訂 temperature 值，因為 Anthropic 會拒絕
任何啟用思考之要求中的 temperature 覆寫。

`anthropic/claude-mythos-5` 是受限存取的模型，採用相同的一律啟用
自適應思考合約。OpenClaw 預設使用 `high`，將 `/think off` 與
`/think minimal` 對應至 `low`，並省略呼叫端選取的取樣參數。
目錄會公布其 1,000,000-token 上下文視窗、128,000-token 輸出
限制、圖片輸入，以及 `$10/$50` 輸入／輸出定價。

Claude Opus 4.8 在 OpenClaw 中預設關閉思考。當你使用
`/think high|xhigh|max` 明確啟用自適應思考時，OpenClaw 會傳送
Anthropic 的 Opus 4.8 強度值；Claude 4.6 模型（Opus 4.6 與 Sonnet 4.6）
預設為 `adaptive`。

使用 `/think:<level>` 覆寫個別訊息，或在模型參數中設定：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-5": {
          params: { thinking: "high" },
        },
      },
    },
  },
}
```

<Note>
  相關 Anthropic 文件：

  * [自適應思考](https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking)
  * [延伸思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)
</Note>

## 安全拒絕備援（Claude Fable 5）

<Warning>
  使用 Claude Fable 5 也代表會使用 Claude Opus 4.8。Fable 5 隨附的
  安全分類器可能拒絕要求，而 Anthropic 核准的
  復原方式是讓 `claude-opus-4-8` 處理該輪。OpenClaw 會針對直接使用 API 金鑰的要求
  自動選用此機制，因此部分 Fable 輪次會由 Claude Opus 4.8 回答
  並計費。如果你的政策或預算無法接受
  由 Opus 處理的輪次，請勿選取 `anthropic/claude-fable-5`。
</Warning>

### 此機制存在的原因

Fable 5 分類器會對受限領域中的要求傳回 `stop_reason: "refusal"`，
而且也會對鄰近的良性工作誤判為陽性（安全
工具、生命科學，甚至是要求模型重現其原始
推理）。若沒有備援，即使另一個 Claude 模型願意處理，該輪仍會
因錯誤而終止——Anthropic 自己的拒絕訊息
會要求 API 整合者設定備援模型。

### 運作方式

1. 對 `anthropic/claude-fable-5` 的每個直接 API 金鑰要求，OpenClaw
   都會傳送 Anthropic 的伺服器端備援選用設定：
   `server-side-fallback-2026-06-01` beta 標頭加上
   `fallbacks: [{"model": "claude-opus-4-8"}]`。Claude Opus 4.8 是 Anthropic 唯一允許
   Fable 5 使用的備援目標。
2. 只有安全分類器的拒絕會觸發備援。速率限制、
   過載與伺服器錯誤的行為完全維持不變，並會經由
   OpenClaw 的一般[模型容錯移轉](/zh-TW/concepts/model-failover)處理。
3. 救援會在同一次呼叫內進行。若在產生任何輸出前遭到拒絕，
   除延遲外不會有任何跡象；整份答案都來自 Opus 4.8。若在
   串流途中遭到拒絕，部分文字會保留為備援
   模型接續生成的前綴，而遭拒模型的推理與工具呼叫
   會依 Anthropic 的重播規則捨棄（不得將其回傳或
   執行）。
4. 如果 Claude Opus 4.8 也拒絕，該輪會將拒絕呈現為
   錯誤，與此功能推出前完全相同。

備援發生在 Anthropic API 層級，因此你的已設定模型清單或備援鏈
不需要包含 `claude-opus-4-8`——能使用 Fable 的
API 金鑰一律能處理 Opus。

### 可觀測性與計費

* 由備援處理的輪次會在助理訊息中記錄 `provider_fallback` 診斷，
  其中列出 `fromModel` 與 `toModel`，且訊息的
  `responseModel` 會回報 `claude-opus-4-8`。
* Anthropic 按每次嘗試計費：輸出前遭拒不收費，而救援
  會依 Claude Opus 4.8 費率計費（目前為 Fable 5 費率的一半）。OpenClaw 的
  每輪成本估算會以 Opus 費率計算由備援處理的輪次，以維持一致。
* 若在串流途中遭拒，Anthropic 端還會對已串流的 Fable 部分
  額外計費；該部分會回報於 API 的每次嘗試
  用量中，但不會納入 OpenClaw 的每輪估算。

### 範圍

適用於使用 API 金鑰向
`api.anthropic.com` 進行驗證的 `anthropic/claude-fable-5`。
OAuth（重複使用 Claude 命令列介面訂閱）、Proxy 基底 URL、
Bedrock、Vertex 與 Foundry 要求皆不受影響，仍會在這些情況下
將拒絕呈現為錯誤。

已即時驗證：在未使用
備援時，要求 Fable 5 重現其原始思維鏈的良性提示會遭 `category: "reasoning_extraction"`
拒絕；同一提示經由 OpenClaw 傳送時，則會傳回一般的 Opus 處理
答案，並附上 `provider_fallback` 診斷。

底層行為請參閱 Anthropic 的[拒絕與備援
指南](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback)。

## 提示快取

OpenClaw 支援 Anthropic 的提示快取功能，適用於 API 金鑰驗證。

| 值             | 快取期間 | 說明             |
| ------------- | ---- | -------------- |
| `"short"`（預設） | 5 分鐘 | 自動套用於 API 金鑰驗證 |
| `"long"`      | 1 小時 | 延長快取           |
| `"none"`      | 不快取  | 停用提示快取         |

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
```

<AccordionGroup>
  <Accordion title="個別代理程式的快取覆寫">
    以模型層級參數作為基準，再透過 `agents.entries.*.params` 覆寫特定代理程式：

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "anthropic/claude-opus-4-6" },
          models: {
            "anthropic/claude-opus-4-6": {
              params: { cacheRetention: "long" },
            },
          },
        },
        list: [
          { id: "research", default: true },
          { id: "alerts", params: { cacheRetention: "none" } },
        ],
      },
    }
    ```

    設定合併順序：

    1. `agents.defaults.models["provider/model"].params`
    2. `agents.entries.*.params`（符合 `id`，依鍵覆寫）

    如此可讓一個代理程式保留長效快取，同時讓使用相同模型的另一個代理程式針對突發性／低重複使用流量停用快取。
  </Accordion>

  <Accordion title="Bedrock Claude 注意事項">
    * Bedrock 上的 Anthropic Claude 模型（`amazon-bedrock/*anthropic.claude*`）在設定後可接受 `cacheRetention` 直接傳遞。
    * 非 Anthropic Bedrock 模型會在執行階段強制設為 `cacheRetention: "none"`。
    * 若未設定明確值，API 金鑰智慧預設值也會為 Bedrock 上的 Claude 參照填入 `cacheRetention: "short"`。
  </Accordion>
</AccordionGroup>

## 進階設定

<AccordionGroup>
  <Accordion title="快速模式">
    OpenClaw 共用的 `/fast` 切換開關會為直接使用 API 金鑰且傳送至 `api.anthropic.com` 的流量設定 Anthropic 的 `service_tier` 欄位。

    | 命令          | 對應至                             |
    | ----------- | ------------------------------- |
    | `/fast on`  | `service_tier: "auto"`          |
    | `/fast off` | `service_tier: "standard_only"` |

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          models: {
            "anthropic/claude-sonnet-4-6": {
              params: { fastMode: true },
            },
          },
        },
      },
    }
    ```

    <Note>
      * 僅適用於使用 API 金鑰直接提出的 `api.anthropic.com` 要求。OAuth／訂閱權杖要求與 Proxy 路由一律不會收到 `service_tier` 欄位。
      * 若同時設定，明確的 `serviceTier` 或 `service_tier` 參數會覆寫 `/fast`。
      * Claude Opus 5 與 Sonnet 5 不支援 Priority Tier，因此 OpenClaw 會省略這些模型的 `service_tier`。
      * 在沒有 Priority Tier 容量的帳戶上，`service_tier: "auto"` 可能解析為 `standard`。
    </Note>
  </Accordion>

  <Accordion title="媒體理解（圖片與 PDF）">
    隨附的 Anthropic 外掛會註冊圖片與 PDF 理解功能。OpenClaw
    會從已設定的 Anthropic 驗證方式自動解析媒體能力，不需要
    額外設定。

    | 屬性    | 值               |
    | ----- | --------------- |
    | 預設模型  | `claude-opus-5` |
    | 支援的輸入 | 圖片、PDF 文件       |

    當圖片或 PDF 附加至對話時，OpenClaw 會自動
    將其路由至 Anthropic 媒體理解提供者。
  </Accordion>

  <Accordion title="1M 上下文視窗">
    Claude Opus 5、Sonnet 5、Mythos 5 與 Fable 5 具有精確的
    1,000,000-token 輸入視窗，並支援最多 128,000 個輸出 token。
    Anthropic 的 1M 上下文視窗也已在採用自適應
    思考的 Claude 4.x 模型上正式推出：Opus 4.8、
    Opus 4.7、Opus 4.6 與 Sonnet 4.6。OpenClaw 會自動設定這些模型的
    容量，不需要 `params.context1m`：

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          models: {
            "anthropic/claude-opus-5": {},
            "anthropic/claude-sonnet-5": {},
            "anthropic/claude-mythos-5": {},
            "anthropic/claude-opus-4-6": {},
          },
        },
      },
    }
    ```

    較舊的設定可以保留 `params.context1m: true`；它對
    這些模型是無害且不執行任何動作的設定，而 OpenClaw 無論如何都不再傳送已淘汰的
    `context-1m-2025-08-07` beta 標頭。要求標頭解析期間會捨棄值為該內容的舊版 `anthropicBeta` 設定
    項目，而不支援的舊版 Claude 模型會維持其一般上下文視窗。

    `params.context1m: true` 在 Claude 命令列介面後端
    （`claude-cli/*`）的行為相同：符合資格且支援正式版功能的 Opus 與 Sonnet 模型
    已會自動取得 1M 視窗，因此該參數在此同樣為選用。

    <Warning>
      需要你的 Anthropic 認證資訊具備長上下文存取權。OAuth／訂閱權杖驗證會保留必要的 Anthropic beta 標頭，但若已淘汰的 1M beta 標頭仍存在於較舊設定中，OpenClaw 會將其移除。
    </Warning>
  </Accordion>

  <Accordion title="Claude Opus 5 1M 上下文">
    `anthropic/claude-opus-5` 及其 `claude-cli` 變體預設具有 1M 上下文
    視窗，不需要 `params.context1m: true`。
  </Accordion>
</AccordionGroup>

## 疑難排解

<AccordionGroup>
  <Accordion title="401 錯誤／權杖突然失效">
    Anthropic 權杖驗證會過期，也可能遭撤銷。新設定請改用 Anthropic API 金鑰。
  </Accordion>

  <Accordion title="找不到提供者 &#x22;anthropic&#x22; 的 API 金鑰">
    Anthropic 驗證是**依代理程式分別設定**；新代理程式不會繼承主要代理程式的金鑰。請為該代理程式重新執行導引設定（或在閘道主機上設定 API 金鑰），然後使用 `openclaw models status` 驗證。
  </Accordion>

  <Accordion title="找不到設定檔 &#x22;anthropic:default&#x22; 的認證資訊">
    執行 `openclaw models status` 以查看目前使用中的驗證設定檔。重新執行導引設定，或為該設定檔路徑設定 API 金鑰。
  </Accordion>

  <Accordion title="沒有可用的驗證設定檔（全部都在冷卻中）">
    查看 `openclaw models status --json` 中的 `auth.unusableProfiles`。Anthropic 的速率限制冷卻可能僅適用於特定模型，因此同系列的其他 Anthropic 模型可能仍可使用。新增另一個 Anthropic 設定檔，或等待冷卻結束。
  </Accordion>
</AccordionGroup>

<Note>
  更多協助：[疑難排解](/zh-TW/help/troubleshooting)和[常見問題](/zh-TW/help/faq)。
</Note>

## 相關內容

<CardGroup cols={2}>
  <Card title="模型選擇" href="/zh-TW/concepts/model-providers" icon="layers">
    選擇提供者、模型參照與容錯移轉行為。
  </Card>

  <Card title="命令列介面後端" href="/zh-TW/gateway/cli-backends" icon="terminal">
    Claude 命令列介面後端的設定與執行階段詳細資訊。
  </Card>

  <Card title="提示快取" href="/zh-TW/reference/prompt-caching" icon="database">
    提示快取如何在不同提供者之間運作。
  </Card>

  <Card title="OAuth 與驗證" href="/zh-TW/gateway/authentication" icon="key">
    驗證詳細資訊與認證資訊重複使用規則。
  </Card>
</CardGroup>
