Skip to main content
Harness（介面顯示為「執行框架」）是一組可重複使用的預設，定義驅動 Agent 的方式：Agent 執行環境及其確切版本、選填的 Anthropic 相容 LLM 供應商，以及進階執行設定。設定一次後，就能在任何 Agent、知識庫建構器、App 建構器或資料建構器上選用。 沒有 Harness 時，一切都以內建的 Claude Agent SDK 搭配原生 Anthropic 執行。以下情況請建立 Harness：
  • 鎖定執行環境版本，讓映像檔更新永遠不會改變 Agent 的行為。
  • 把模型呼叫導向你自己的閘道 — LLM proxy、自架模型伺服器，或其他供應商的 Anthropic 相容端點。
  • 調整執行環境 — 壓縮（compaction）、思考預算、逾時設定。

​
開啟 Harness

在左側欄開啟 更多 選單，選擇 執行框架。每張卡片會摘要該預設，例如 sdk@0.3.204 · gateway.example.com · my-model · 2 項進階設定，或 內建 SDK · 原生 Anthropic。 管理員與建構者可以建立、編輯和刪除 Harness。所有成員都可以檢視。

​
執行環境：Claude Agent SDK vs Codex

Harness 建立後就無法更改執行環境；若要切換，請建立新的 Harness。

​
建立 Harness

1

開啟對話框

點選 新增執行框架。
2

名稱與執行環境

輸入 名稱（在工作區內不可重複，例如 gateway-prod）與選填的 描述。執行環境 保持 Claude Agent SDK。
3

鎖定版本（選填）

輸入確切的 版本，或留空使用內建預設。
4

指向閘道（選填）

填寫 LLM 供應商 欄位，把模型呼叫導向 Anthropic 相容端點。
5

新增進階設定（選填）

使用 + 新增設定… 調整執行環境。
6

建立

點選 建立，然後在你的 Agent 上選用這個 Harness。

​
版本鎖定

  • 只接受確切版本 — 不接受 latest 之類的標籤，也不接受 ^0.3 之類的範圍。浮動標籤會讓鎖定失去意義。
  • 若鎖定的版本與內建版本不同，會在執行開始時於沙盒內安裝，因此會增加啟動時間。
  • 當你的 Agent 已在某版本上驗證過，或你的閘道需要特定的傳輸行為時，請鎖定版本。

​
LLM 供應商（Anthropic 相容閘道）

Claude base URL 留空即使用原生 Anthropic，其他供應商欄位會維持停用。填入後，所有模型呼叫都會送往你的端點。

​
驗證權杖密鑰如何運作

驗證權杖密鑰 只儲存名稱，永遠不會儲存金鑰本身：
1

把供應商金鑰存成工作區密鑰

在工作區設定 -> 密鑰 新增閘道的金鑰，例如名稱為 gateway_api_key。選擇器會列出工作區的密鑰。
2

在 Harness 上選取

在 驗證權杖密鑰 選取它。儲存時會檢查該名稱是否存在於工作區密鑰，或工作區 Default 連線保險庫 的密鑰插槽中；找不到的名稱會被拒絕。
3

執行時

DataGen 會先在本次執行的連線保險庫所提供的密鑰中查找該名稱（不分大小寫，連字號視同底線），再到工作區密鑰中查找。其值會同時匯出為 ANTHROPIC_AUTH_TOKEN（以 Bearer 權杖送出）與 ANTHROPIC_API_KEY（以 x-api-key 送出），因此接受任一種標頭的閘道都能運作，而你真正的 Anthropic 金鑰永遠不會送到自訂網址。
選擇 不使用密鑰（使用預設驗證） 時，連線保險庫或工作區密鑰中既有的 ANTHROPIC_API_KEY 會被送到自訂 base URL。只要閘道不是由你營運，或它不預期收到你的 Anthropic 金鑰，就請選擇驗證權杖密鑰。設定自訂 base URL 時，Claude 訂閱的 OAuth 權杖一律會被移除。

​
模型優先順序

設定 供應商模型 後，綁定此 Harness 的每個 Agent 都會以它執行。Agent 的 預設模型 與任何自動化設定的模型都會被忽略，Agent 設定畫面也會顯示提示，說明此 Agent 一律使用哪個模型。若要讓各 Agent 的預設模型生效，請將 供應商模型 留空。

​
進階設定

+ 新增設定… 提供一份執行設定允許清單。每一項都會以同名環境變數注入沙盒；只接受以下鍵值。
轉譯到 OpenAI 風格後端（例如 vLLM）的閘道，可能會拒絕推理強度值 high。遇到這類閘道，請把 CLAUDE_CODE_EFFORT_LEVEL 設為 medium。

​
在哪裡選用 Harness

​
常見問題

Harness 設定了 供應商模型。請在 Harness 上清除它，或把這些 Agent 綁定到其他 Harness。
有些供應商無法對應 Claude 的模型名稱。請同時設定 供應商模型 與 供應商小型模型，讓每個模型插槽（包含子代理與快速背景呼叫）都使用供應商提供的模型。
驗證權杖密鑰 必須在儲存前已存在於工作區密鑰，或 Default 連線保險庫的密鑰中。請先建立，再選取。
清除 Claude base URL 也會一併清除驗證權杖密鑰與兩個模型欄位，讓 Harness 乾淨地回到原生 Anthropic。
綁定它的 Agent 會改用內建預設（內建 SDK、原生 Anthropic）。

​
下一步

資料總覽

連接資料庫並發布 Agent 可查詢的分析資料。

建立 Agent

在 Agent 上組合連線保險庫、沙箱環境與 Harness。