---
title: 在您的伺服器上使用主控台
url: https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/console
description: 為自行託管的 Claude Managed Agents 伺服器上的主控台設定登入，然後在瀏覽器中建立代理並執行工作階段。
---

<Note>
  若要申請自行託管的 Claude Managed Agents 存取權，請聯絡您的 Anthropic 客戶團隊。
</Note>

您伺服器上的主控台是一個網頁，由自行託管的 Claude Managed Agents 伺服器在與其 API 相同的位址上提供。您可以在其中建立代理、執行工作階段，以及管理環境、憑證保管庫、記憶體儲存區和技能，無需使用 SDK 或 CLI。

它並非位於 platform.claude.com 的 Claude Console。它只會顯示您伺服器上的內容。

## 設定登入

管理員只需設定一次登入。若要改為在單一機器上試用主控台，請依照[在您的伺服器上試用主控台](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/quickstart#try-the-console-on-your-server)操作，該方式使用發行版本的模擬登入提供者。

<Steps>
  <Step title="設定單一登入和終端機登入">
    請依照[單一登入](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/configure#single-sign-on)操作，包括[讓開發人員從終端機登入](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/configure#let-developers-log-in-from-a-terminal)。主控台會透過您為終端機登入註冊的應用程式讓使用者登入。它會根據簽發者項目中 `audiences` 的第一個項目檢查每個權杖，因此請將該應用程式的 audience 列在第一位。
  </Step>

  <Step title="透過 HTTPS 提供主控台">
    在連接埠 8400 前方放置一個終止 TLS 的代理伺服器。[在伺服器前方加上 TLS](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/kubernetes#put-tls-in-front-of-the-server) 列出了代理伺服器必須執行的工作。若使用純 HTTP，登入僅能在 `localhost` 或 `127.0.0.1` 上運作。
  </Step>

  <Step title="將主控台的位址新增至應用程式">
    在您的身分識別提供者中，將您伺服器的 HTTPS 位址新增為該應用程式的第二個重新導向 URI，並加上結尾斜線：`https://cma.example.com/`。同時允許其來源 `https://cma.example.com` 進行跨來源（CORS）請求。
  </Step>
</Steps>

若要檢查設定，請[開啟主控台](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/console#open-the-console)並登入。

## 開啟主控台

如果您的應用程式呼叫 `https://cma.example.com`，請在瀏覽器中開啟 `https://cma.example.com/`，然後點選 **Continue with SSO**。

您會透過您的身分識別提供者登入。主控台不接受伺服器 API 金鑰。如果主控台顯示此伺服器尚未設定登入，則需要由管理員[設定登入](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/console#set-up-sign-in)。

## 從主控台執行代理

空白代理的內建工具（例如 `bash`）會在 worker 上執行，因此請選取有 worker 正在輪詢的環境。[各元件的執行位置](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted#what-runs-where)說明了 worker 是什麼。若沒有 worker，第一個工具呼叫會等待直到有 worker 執行它。環境由管理員建立，管理員可以在環境的 **Workers** 分頁上查看其 worker。

<Steps>
  <Step title="建立代理">
    在側邊欄中選取 **Agents**，然後點選 **Create agent**。選取一個起點，例如 **Blank agent**，然後輸入名稱。

    點選 **Create agent**。代理的頁面隨即開啟。
  </Step>

  <Step title="啟動工作階段">
    在代理的頁面上，點選 **Start session**。選取一個環境，然後點選 **Create session**。工作階段的頁面隨即開啟。
  </Step>

  <Step title="傳送訊息">
    在頁面底部的方塊中輸入訊息，然後傳送。頁面會隨著代理的運作而更新。如果工具呼叫等待您處理，其卡片會顯示 **Approve** 和 **Deny**。
  </Step>
</Steps>

當工具呼叫等待您處理時，工作階段的標記會顯示 **Idle**。

若要開啟任何其他工作階段，例如應用程式透過 API 啟動的工作階段，請在側邊欄中選取 **Sessions**，然後選取該工作階段。

## 誰可以看到什麼

您的角色決定主控台顯示的內容，與 API 中的情況相同：

* **管理員**可以查看並變更伺服器上的所有內容。
* **具有 `developer` 或 `user` 角色的使用者**可以看到所有環境。在代理、工作階段、保管庫、記憶體儲存區和技能中，他們只能看到以自己的登入身分建立的項目。

使用伺服器 API 金鑰建立的代理或工作階段（例如快速入門中的代理或工作階段）僅對管理員顯示。如需完整表格，請參閱[各角色可執行的操作](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/configure#what-each-role-can-do)。

## 關閉主控台

伺服器預設會提供主控台。若要關閉，請在[設定檔](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/configuration-reference#where-settings-go)中設定 `console.serve: false`，然後重新啟動伺服器。伺服器隨後會停止提供主控台。代理和工作階段仍可透過 API 繼續運作。

## 後續步驟

* [在自行託管的伺服器上呼叫 API](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted/call-the-api)：從您的程式碼或 `ant` CLI 執行相同的工作。
* [自行託管的 Claude Managed Agents 中的資料與存取](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted-data-and-access#who-can-reach-the-server)：查看誰可以連線至伺服器及其主控台。