Anthropic 重新開放 Claude CLI 使用：開發者該知道的實際應用

Anthropic 正式宣佈，OpenClaw 風格的 Claude CLI 使用方式再次被允許。這個消息對許多使用 Claude 進行開發的工程師來說，意味著更靈活的整合方式。

政策轉變背後

OpenClaw 的文件直接引用了 Anthropic 工作人員的說法：「Anthropic 工作人員告訴我們，OpenClaw 風格的 Claude CLI 使用再次被允許。」

這並非突如其來的政策調整，而是 Anthropic 對開發者生態系態度的進一步明確化。文件中同時提到，如果 Anthropic 發布新的政策，OpenClaw 會根據新的規則調整整合方式。

兩種主要的認證方式

Anthropic 在 OpenClaw 中支援兩種主要的認證方式：API Key 和 Claude CLI reuse。這兩種方式各有適用場景，開發者可以根據實際需求選擇。

API Key 認證

API Key 是最標準的接入方式，適合需要明確計費路徑和生產環境使用的場景。設定方式相當直觀：

openclaw onboard
# 選擇：Anthropic API key

# 或使用非互動模式
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

在設定檔中，API Key 可以這樣配置：

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Claude CLI Reuse

對於已經在主機上安裝並使用 Claude CLI 的開發者，OpenClaw 可以直接重複使用既有的登入資訊。這種方式特別適合個人或小團隊的開發環境。

根據文件，Claude CLI reuse 和 claude -p 的使用方式都被認可。這表示開發者不需要為了使用 OpenClaw 而另外申請 API Key，可以直接利用現有的 Claude 訂閱。

實際使用場景

Fast Mode 的應用

OpenClaw 的 /fast 切換功能支援直接對 Anthropic 的公開流量進行優化，包括使用 API Key 和 OAuth 認證的請求。

/fast on 對應 service_tier: "auto"
/fast off 對應 service_tier: "standard_only"

這個功能特別適合需要在效能和穩定性之間取得平衡的場景。例如，在開發階段可能更重視回應速度，可以開啟 Fast Mode；而在生產環境中，如果需要更穩定的服務品質，可以切換到 standard mode。

在配置檔中，可以預設設定 Fast Mode：

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}

Prompt Caching 的應用

Anthropic 的 prompt caching 功能可以顯著降低成本，特別適合需要重複使用相同 prompt 的應用場景。這個功能目前只支援 API 認證，舊版的 token 認證方式不支援 cache 設定。

Cache retention 有三種選項：

值	快取持續時間	說明
`none`	無快取	停用 prompt caching
`short`	5 分鐘	API Key 認證的預設值
`long`	1 小時	延長快取

對於使用 Anthropic API Key 認證的使用者，OpenClaw 會自動對所有 Anthropic 模型套用 cacheRetention: "short"（5 分鐘快取）。如果需要更長的快取時間，可以在配置中明確設定。

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

針對不同的 agent，也可以設定不同的 cache retention 策略：

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // 大部分 agent 的基準
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // 只針對這個 agent 覆蓋
    ],
  },
}

這種配置方式讓一個 agent 可以保持長期快取，而另一個使用相同模型的 agent 可以停用快取，避免在低重用率的流量上產生寫入成本。

1M Context Window 的 Beta 功能

Anthropic 的 1M context window 目前處於 beta 階段，需要在 OpenClaw 中針對特定模型啟用。對於支援的 Opus/Sonnet 模型，可以在配置中加入 params.context1m: true。

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}

需要注意的是，這個功能只有在明確設定 params.context1m: true 時才會啟用，而且 Anthropic 必須允許該憑證使用長 context。

如果使用舊版的 Anthropic token auth（sk-ant-oat-*），Anthropic 目前會拒絕 context-1m-* 的 beta 請求。在這種情況下，OpenClaw 會記錄警告訊息，並跳過 context1m beta header，回退到標準的 context window。

Thinking Defaults 的配置

對於 Claude 4.6 模型，OpenClaw 在沒有明確設定思考層級時，預設會使用 adaptive thinking。開發者可以透過每個訊息的指令（/think:<level>）或在模型參數中覆蓋這個設定。

相關的 Anthropic 文件包括：
– Adaptive thinking
– Extended thinking

對繁體中文開發者的實際意義

對於台灣和香港的開發者來說，這個政策開放有幾個直接的實際意義：

降低整合門檻

許多開發者已經在使用 Claude CLI 進行日常的 AI 輔助開發工作。現在可以直接在 OpenClaw 中重複使用這個既有的登入資訊，不需要為了整合額外申請和管理 API Key。這對於個人開發者或小團隊來說，簡化了整體的整合流程。

靈活的部署選擇

根據部署環境的需求，開發者可以在 API Key 和 CLI reuse 之間靈活選擇。例如：
– 在生產環境或需要明確計費控制的場景，使用 API Key
– 在開發環境或個人項目中，直接使用 CLI reuse

成本最佳化的空間

透過 prompt caching 的配置，開發者可以根據應用的特性最佳化使用成本。對於需要頻繁重複使用相同 prompt 的應用，設定較長的快取時間可以顯著降低 API 調用成本。

長文本處理能力的提升

對於需要處理大量文本的應用，1M context window 的 Beta 功能提供了更大的處理空間。雖然目前處於 Beta 階段，但對於有長文本處理需求的開發者來說，這是一個值得嘗試的功能。

常見問題的處理方式

401 錯誤或 token 突然無效

Anthropic 的 token 認證可能會過期或被撤銷。對於新的設定，建議直接遷移到 Anthropic API Key，這樣可以避免因為 token 過期而導致的中斷問題。

No API key found for provider “anthropic”

認證是針對每個 agent 獨立的。新建立的 agent 不會繼承主要 agent 的金鑰。需要針對該 agent 重新執行 onboarding，或者在 gateway 主機上配置 API Key，然後用 openclaw models status 驗證。

No credentials found for profile `anthropic:default`

使用 openclaw models status 檢查目前啟用的認證 profile，然後重新執行 onboarding，或為該 profile 路徑配置 API Key。

No available auth profile (all in cooldown/unavailable)

使用 openclaw models status --json 檢查 auth.unusableProfiles。Anthropic 的 rate-limit 冷卻時間可能會針對特定模型，所以當某個模型在冷卻時，同一家族的其他 Anthropic 模型可能仍然可以使用。可以新增另一個 Anthropic profile，或者等待冷卻結束。

對開發生態系的影響

這個政策開放不僅影響個別開發者的使用方式，也反映了 Anthropic 對開發者生態系的整體態度。

更開放的整合政策

允許 Claude CLI reuse 表示 Anthropic 願意提供更多元的整合方式，讓開發者可以根據自己的需求選擇最合適的接入方式。這種開放的態度有助於吸引更多開發者使用 Claude 進行開發。

降低學習成本

對於已經熟悉 Claude CLI 的開發者，不需要學習新的認證方式，可以直接在現有的工作流程中加入 OpenClaw 的功能。這降低了學習新工具的成本，讓開發者可以更快地上手。

促進工具生態的發展

開放的整合政策也促進了整個開發工具生態的發展。像 OpenClaw 這樣的工具可以提供更多元的整合選項，讓開發者可以根據自己的需求選擇最合適的工具組合。

未來的發展方向

雖然目前 Claude CLI reuse 被允許，但文件中也提到，如果 Anthropic 發布新的政策，OpenClaw 會根據新的規則調整整合方式。這表示開發者需要持續關注 Anthropic 的政策更新。

同時，Anthropic 也持續在文件中維護 Claude Code 的直接 CLI 使用方式，這顯示了 Anthropic 對 CLI 介面的重視。未來可能會有更多相關的功能和改進。

實際操作步驟

如果你已經在使用 Claude CLI，想要在 OpenClaw 中重複使用你的登入資訊，可以按照以下步驟操作：

確保你的 Claude CLI 已經正確設定並可以使用
在 OpenClaw 中執行 onboarding，選擇使用既有的 Claude CLI 認證
使用 openclaw models status 驗證認證狀態
根據你的需求配置 prompt caching、Fast Mode 等功能
在配置檔中設定你預設使用的模型和參數

如果你還沒有使用過 Claude CLI，或者更傾向於使用 API Key，也可以直接在 OpenClaw 中設定 API Key：

在 Anthropic Console 中建立你的 API Key
在 OpenClaw 中執行 openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
驗證認證狀態並配置你的模型參數
根據需求啟用 prompt caching、Fast Mode 等功能

小結

Anthropic 重新允許 OpenClaw 風格的 Claude CLI 使用，對開發者社群來說是一個好消息。這個政策不僅提供了更靈活的整合選擇，也反映了 Anthropic 對開發者生態系的開放態度。

對於繁體中文開發者來說，這意味著可以使用自己熟悉的方式整合 Claude 的功能，降低整合門檻，提升開發效率。無論是個人開發者還是團隊專案，都可以根據自己的需求選擇最合適的認證方式。

在實際應用中，開發者應該根據自己的部署環境、成本需求和使用場景，選擇 API Key 或 CLI reuse，並善用 prompt caching、Fast Mode、1M context window 等功能，最佳化使用體驗和成本效益。