跳到正文
開啟原文
openrouter blog(openrouter.ai)·· 19 小時前精選AI 評分77

Claude Code 使用限制？如何繼續編碼

Hit Your Claude Code Usage Limit? How to Keep Coding

AI 導讀

在 Claude Code 遇到使用限制時，可透過 OpenRouter API 金鑰繼續編碼，並可自行設定成本與模型。

  • 成本：Sonnet 5.5 兩到九訊息會話平均 $0.155，Opus 5.5 $0.305，Haiku 5.5 $0.007。
推薦理由

本教學說明如何在 Claude Code 觸發使用限制時，透過 OpenRouter API 金鑰繼續編碼，並提供成本與設定細節，協助使用者在限制內持續開發。

正文 · AI 翻譯

當你達到 Claude Code 使用限制時，可以透過使用 OpenRouter API 金鑰繼續編寫程式。透過 OpenRouter，Claude Code 以按代幣付費的 API 金鑰執行，使用相同的 Claude 模型且沒有五小時視窗。你設定三個環境變數，並在重置時切回你的方案。

我們已在 Claude Code 上測試此設定。以下的輸出與成本來自那些執行。

TL;DR

  • 你的 Claude 計畫有五小時限制與每週限制。OpenRouter API 金鑰則沒有。你只需為使用的代幣付費。
  • 最快的設定是 Ori Harness：ori claude 在該會話中以 OpenRouter 啟動 Claude Code，並以瀏覽器登入，無需貼上金鑰。
  • 若手動操作，三個環境變數將 Claude Code 指向 OpenRouter。我們將它們放在名為 claude-or 的 shell 函式中，這樣 claude 仍然使用你的方案。
  • 先從 Claude Sonnet 5.5 開始。典型的短程 Claude Code 會話在 Sonnet 5.5 的費用為 $0.16，在 Opus 5.5 為 $0.31，在 Haiku 5.5 則不到一美分。
  • 不要相信 Claude Code 所顯示的費用。在我們的測試中，它顯示 $0.375，但實際計費為 $0.008。請檢查你的金鑰或 Activity 頁面。
  • 當你的方案重置時，重新輸入 claude。無需撤銷任何操作。

為什麼 Claude Code 會達到使用限制？

Claude 計畫同時執行兩個限制。第一個在你第一次提示後五小時重置。第二個則每七天重置。Anthropic 未公佈任一限制的確切提示數量。Claude Code 使用的代幣遠多於一般聊天，因此可能在任務中途耗盡。發生此情況時，Claude Code 會停止並告知你何時重置限制。Anthropic 的使用限制說明檔案說明瞭兩個限制。

OpenRouter API 金鑰不是這樣運作。你為每個使用的代幣付費，只要有餘額就能繼續。

最快方式：透過 Ori Harness 執行 Claude Code

Ori Harness 會在你的機器上直接啟動 Claude Code，並已設定 OpenRouter。安裝後，透過它啟動 Claude Code：

curl -fsSL https://openrouter.ai/labs/ori/install.sh | bash
ori claude --model anthropic/claude-sonnet-5.5

Ori 會開啟瀏覽器，讓你以 OpenRouter 帳號登入。它使用 OAuth，無需建立或貼上金鑰。只有使用 ori claude 啟動的會話會在 OpenRouter 上執行，普通 claude 仍使用你的方案，並在方案重置時輸入 claude 以切回。使用量會計入你的 OpenRouter 帳單。若你屬於組織，帳戶上若有帶預算限制的 guardrail，會限制其可支出，OpenRouter 亦會將其套用於 Ori 會話。

以下步驟手動完成同樣操作，使用 API 金鑰與 shell 函式。若你想要一個具有獨立信用額度的金鑰，適用於任何帳戶，請使用。步驟 4 的成本建議同樣適用。

步驟 1：取得 OpenRouter API 金鑰並設定限額

在 API 金鑰頁面 建立一個金鑰並設定信用額度。我們將其設為 $4。這樣即使是長時間會話，也不會超過 $4。信用額度是 OpenRouter 控制支出的多種方式之一。我們的團隊 AI 成本治理指南 介紹其他方式。

要檢查限額，請向我們的 API 查詢你的金鑰：

curl https://openrouter.ai/api/v1/key \
  -H "Authorization: Bearer $OPENROUTER_API_KEY"

以下是回應中重要的部分：

{
  "data": {
    "limit": 4,
    "limit_remaining": 4,
    "usage": 0
  }
}

limit_remaining 數字告訴你金鑰剩餘的金額。你可以隨時執行此檢查。請求後，新總額可能需要幾秒鐘才顯示。

步驟 2：加入切換到你金鑰的指令

你可以把變數加入你的 shell 配置檔，但那樣每次 Claude Code 會計費你的金鑰。我們希望你的普通 claude 指令仍然使用你的方案，於是我們把變數放進一個小的 shell 函式。將此加入 ~/.zshrc 或 ~/.bashrc：

claude-or() {
  ANTHROPIC_BASE_URL="https://openrouter.ai/api" \
  ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY" \
  ANTHROPIC_API_KEY="" \
  ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-5.5" \
  ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-5.5" \
  ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-5.5" \
  CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-haiku-5.5" \
  claude "$@"
}

前三行是關鍵：

  • ANTHROPIC_BASE_URL 告訴 Claude Code 將請求傳送給我們。
  • ANTHROPIC_AUTH_TOKEN 儲存你的 OpenRouter 金鑰。
  • ANTHROPIC_API_KEY 必須留空。若不是，Claude Code 可能會嘗試登入 Anthropic。

其餘四行為可選。它們告訴 Claude Code 在 Sonnet、Opus 與 Haiku 上使用哪個 Claude 模型。它們還會把子代理（Claude Code 自行啟動的較小協助任務）送到 Haiku 5.5。

這些變數僅在你輸入 claude-or 時生效。儲存檔案後開啟新終端機，讓函式準備就緒。

Diagram: typing claude in your terminal uses your Claude plan, with its five-hour and weekly limits. Typing claude-or sends the same session to OpenRouter on your API key, pay per token with no usage window, and OpenRouter serves the same Claude models from Anthropic, Amazon Bedrock and Google Vertex.

步驟 3：確認 Claude Code 正在使用你的金鑰

在真正開始工作之前，請確認 Claude Code 的請求已送往 OpenRouter，而非你的方案。最快的方法是傳送一個簡短提示，並檢視是哪個模型回覆。請在終端機執行以下指令：

claude-or --model sonnet -p "Reply with exactly: ok" --output-format json

以下是我們回覆中重要的部分：

{
  "is_error": false,
  "result": "ok"
}

回覆沒有錯誤。完整輸出中的 modelUsage 欄位標示回覆的模型，在我們的執行中為 anthropic/claude-sonnet-5.5。我們以 --model haiku 執行相同提示，modelUsage 的模型名稱為 anthropic/claude-haiku-5.5。

接著再次執行步驟 1 的金鑰檢查。若 usage 上升，表示請求已計費至你的金鑰，而非方案。若未上升，則 Claude Code 未讀取變數。請開啟新終端機再試一次。

步驟 4：降低成本

以金鑰為單位，你需為每則訊息付費。表格列出三款 Claude 5.5 模型的價格，也顯示在 OpenRouter 上實際 Claude Code 兩到九則訊息會話的中位數成本。

模型每 1M 輸入 token 價格每 1M 輸出 token 價格中位數會話成本（2 至 9 則訊息）
Claude Opus 5.5$4.00$20.00$0.305
Claude Sonnet 5.5$2.00$10.00$0.155
Claude Haiku 5.5$0.10$0.50$0.007

價格截至 2026 年 10 月 21 日。會話成本來自我們的 session-cost dataset，涵蓋至 2026 年 10 月 18 日的 30 天。

先從 Sonnet 5.5 開始。它每次會話的成本約為 Opus 5.5 的一半，並能處理大部分日常編碼。若問題較難，輸入 /model opus 切換模型，完成後再切回。若你在我們的 API 上構建自己的應用程式，亦可在較便宜的模型不確定答案時，自動將請求移至更強大的模型。

每個新會話都會以約 28,000 個 token 來自 Claude Code 自己的指令與工具清單開始（我們在 Claude Code 2.1.307 上的執行為 28,156，數值會因版本變動）。它們會在首次請求時寫入提示快取，因而在步驟 3 中一個單字提示在 Sonnet 5.5 的成本約 $0.07，在 Haiku 5.5 則不到 0.5 分。

子代理在 Haiku 上成本低。當我們要求 Sonnet 5.5 啟動子代理時，主代理執行於 Sonnet 5.5，子代理則執行於 Haiku 5.5，正如函式所設。

Haiku 亦能自行處理小修正。我們給 Haiku 5.5 一個包含兩個 bug 與三個失敗測試的購物車檔案。它修復了兩個 bug，三個測試皆通過，且我們僅被收費 $0.008。

不要依賴 Claude Code 所顯示的成本。對於那次 Haiku 執行，Claude Code 報告 $0.375，但實際收費僅 $0.008。Claude Code 以 Anthropic 自己的價格表為基礎定價，若無法辨識 OpenRouter 模型名稱，則會進行猜測。若要確定實際支出，請使用步驟 1 的指令檢查 limit_remaining，或開啟你的 Activity page。

步驟 5：當你的方案重置時切回

當您的方案限制重置時，輸入 claude 取代 claude-or。您不需要改動任何設定，因為 OpenRouter 的設定僅存在於函式內部。在我們的測試中，純粹的 claude 在方案模型上回應，且 OpenRouter 金鑰的使用量並未改變。

如果 API 金鑰用完會發生什麼？

當您的金鑰達到信用額度上限，或帳戶信用用盡時，我們會在請求到達模型前停止並回傳錯誤。錯誤訊息包含一個 limit_source 欄位，說明原因：

  • openrouter_key_limit 表示金鑰已用盡其限制。
  • openrouter_credits 表示您的帳戶信用用盡。

若要繼續使用，請在 API 金鑰頁面提升金鑰上限或為帳戶增加信用。我們的 限制頁面說明瞭所有型別的限制，包括團隊管理員可以設定的限制。

常見問題

OpenRouter 是否對 Claude Code 有使用限制？

沒有五小時或每週限制。唯一的限制是支出：您擁有的信用額、您為金鑰設定的上限，以及團隊管理員設定的任何預算。

模型是否與我的 Claude 計畫相同？

是的。它們是 Anthropic 的 Claude 模型。我們從 Anthropic 以及 Amazon Bedrock、Google Vertex 等雲端供應商取得，若某個供應商出現問題，我們會將您的請求轉發到另一個供應商。對於 Claude Code，我們建議 將 Anthropic 設為首選供應商，因為 Claude Code 僅保證在 Anthropic 上運作。

當達到限制時，我可以使用更便宜的模型嗎？

可以。Sonnet 5.5 每次會話的成本約為 Opus 5.5 的一半，而 Haiku 5.5 每次會話不到一分錢。您也可以在函式的變數中指定不同的模型。許多人透過 OpenRouter 在 Claude Code 中使用其他模型。本月，GLM 5.3 Flash 是我們 apps 頁面上 Claude Code 最常用的第二個模型，僅次於 Claude Opus 5.5。Claude Code 主要為 Claude 模型設計，建議先在小型任務上嘗試其他模型。若您從自己的程式碼呼叫我們的 API，也可以 列出備援模型，讓第一個模型失敗時請求轉到第二個模型。欲瞭解更多降低每次請求成本的方法，請參閱 我們在 OpenRouter 上最低成本 LLM 推論指南。

Claude Code 使用限制何時重置？

五小時限制會在該時段內第一次提示之後五小時重置。每週限制會在開始後七天重置。Claude Code 在停止您使用時會顯示重置時間，讓您知道何時可以再次輸入 claude。

我如何檢視剩餘使用量？

在您的 Claude 計畫中，Claude Code 會在停止您使用時告知重置時間。若使用 OpenRouter，請用 limit_remaining 搭配 GET /api/v1/key 檢查，或開啟您的 Activity 頁面。

接下來的步驟

我們的 Claude Code 設定指南 包含完整設定流程，並提供顯示您工作時成本的狀態列。若您想每天使用 OpenRouter 與 Claude Code，不僅在達到限制時，我們的 Claude Code 教學會帶您一步步操作。若不想管理金鑰，Ori Harness 可用一條指令啟動 Claude Code 或其他 agent CLI。若您為團隊設定，工作區預算允許您限制每個團隊可支出的金額。

來源： openrouter blog (openrouter.ai)
開啟原文
#教學/實務#Agent#程式開發