連接 Claude Code

透過 Unity Gateway 搭配模型、MCP 工具和技能使用 Claude Code 或 Claude 桌面應用程式。 對於 Claude Code，請使用 Unity Gateway CLI（ug）或手動設定連線。 對於桌面應用程式，請在應用程式的設定中設定連線。

在你開始之前

你需要 Azure Databricks 工作區的 URL 以及你想使用的模型存取權。 桌面設定時，安裝最新的 Claude 桌面應用程式 ，並向你的帳號管理員索取 OAuth 用戶端 ID，如下所述。

如果您的管理員已經設定了您的裝置，請依照組織的登入與啟動指示操作。

克勞德密碼

安裝 ug，然後從你的專案目錄執行這個指令：

ug claude

依照指示選擇你的工作區並登入。 ug 設定連線並在你的終端機中開啟 Claude Code。 開始使用你已經使用的相同提示詞和指令。 要更改模型，請輸入 /model。

要新增 MCP 工具或技能，請在終端機執行以下指令，然後重新啟動 Claude Code：

ug mcp add
ug skills add

每個指令都可以讓你選擇要新增的內容。 詳情請參見 新增工具與技能 。

手動設定 Claude 程式碼

將以下設定合併為 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_MODEL": "<model-api-name>",
    "ANTHROPIC_BASE_URL": "https://<workspace-hostname>/ai-gateway/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<databricks-personal-access-token>",
    "ANTHROPIC_CUSTOM_HEADERS": "x-databricks-use-coding-agent-mode: true",
    "CLAUDE_CODE_USE_GATEWAY": "1",
    "ENABLE_PROMPT_CACHING_1H": "1",
    "ENABLE_TOOL_SEARCH": "true"
  }
}

用你的工作區主機名稱替換 <workspace-hostname> ，不帶 https://。 將 <model-api-name> 設為你可存取的 Claude 模型 API 的完整 Unity Catalog 名稱，並提供你的 Azure Databricks 個人存取權杖。

從你的專案目錄執行 claude 。 其他設定請參見 Claude Code 設定。

手動新增 MCP 工具

在你的工作區中，找到 Unity Gateway > MCP 下的 MCP 服務的三部分名稱，然後用 Claude Code 註冊：

claude mcp add --transport http --scope user \
  --client-id claude-code --callback-port 3118 \
  databricks-tools \
  "https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service-name>"

替換主機名稱和服務名稱。 打開 Claude Code，輸入 /mcp，並用你的 Azure Databricks 帳號驗證伺服器。 重複這個步驟，為你想新增的每個服務分別使用不同的伺服器名稱。

手動連接技能

若要將已發佈的 Unity Gateway 技能公開為工具，請將技能登錄註冊為 HTTP MCP 伺服器：

claude mcp add --transport http --scope user \
  --header "Authorization: Bearer <databricks-personal-access-token>" \
  databricks-skill-registry \
  "https://<workspace-hostname>/ai-gateway/skills/?schema=<catalog>.<schema>"

用你的工作區、代幣和技能架構替換佔位符。 在 ?schema 前保留結尾斜線。 若要包含多個結構，重複參數： ?schema=main.default&schema=ml.prod。

重新啟動 Claude Code，並檢查與 /mcp 的連線。 請使用技能的完整名稱來要求 Claude 使用該技能，例如 Use <catalog>.<schema>.<skill-name> to review this query.。此連線會將技能作為 MCP 工具公開；ug skills add 則會下載技能以供原生探索。

Claude 桌面應用程式

1. 取得 OAuth 客戶 ID

請你的帳號管理員 建立一個 OAuth 應用程式連線。 在 Azure Databricks 帳號主控台中，開啟設定>、應用程式連接>、新增連線並使用：

Setting Value
身份類型 標準應用
應用程式名稱 claude-desktop
產生用戶端密碼 未勾選（公開用戶端）
重定向網址 http://127.0.0.1:53180/callback
存取範圍 ai-gateway

儲存連線並複製 客戶端 ID。 如果你打算結合技能，也請註冊 http://127.0.0.1:53280/callback。

2. 連接 Unity Gateway

在桌面應用程式的登入畫面中，選擇 「協助 > 故障排除 > 啟用開發者模式」，然後選擇 「開發者 > 配置第三方推論」。

在 連接 頁面，選擇 閘道 並輸入：

Setting Value
證書類型 互動式登入
閘道基底網址 https://<workspace-hostname>/ai-gateway/anthropic
用戶端識別碼 你的 OAuth 客戶 ID
簽發者網址 https://<workspace-hostname>/oidc
持有者令牌 存取憑證
Scopes ai-gateway
附錄 offline_access 已啟用
重新導向端口 53180

將 <workspace-hostname> 取代為您的 Azure Databricks 工作區主機名稱。 其他設定保持預設狀態。 詳情請參閱 Anthropic 的閘道配置。

點選測試連線並登入 Azure Databricks。 選擇 「套用變更」，然後「 儲存並重新啟動」。 在登入畫面中，選擇第三方設定，並在 Code 或 Cowork 中開始對話。

3. 新增 MCP 工具與技能

開啟 開發人員 > 設定第三方推論 > 連接器。 在 管理 MCP 伺服器中，為你想使用的每個 MCP 服務或技能登錄檔新增一個項目。

以下設定適用於兩種接頭：

Setting Value
Transport 可串流 HTTP 协议
OAuth 帶你自己的客戶
用戶端識別碼 你的 OAuth 客戶 ID
客戶端密碼 保留空白
授權伺服器 ["https://<workspace-hostname>/oidc"]
Scope ai-gateway
請求 offline_access 已啟用
回撥主持人 127.0.0.1

對於 MCP 服務，請在工作區的 Unity Gateway > MCP 中找到其三部分名稱。 給連接器一個描述性名稱，將 回調埠 設為 53180，並使用以下網址：

https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service-name>

針對技能，請將連接器命名為 databricks-skill-registry，將 回調埠 設為 53280，並使用：

https://<workspace-hostname>/ai-gateway/skills/?schema=<catalog>.<schema>

在 ?schema 前保留結尾斜線。 若要包含多個結構，重複參數： ?schema=main.default&schema=ml.prod。 這些技能會透過連接器以工具的形式提供給 Claude。

對每個連接器，點擊登入 並測試 ，完成登入。 選擇 「套用變更」，然後「 儲存並重新啟動」。 要求 Claude 使用已連接的工具或技能時，請使用其完整名稱。 請參閱 新增工具與技能 以了解存取需求及更多選項。

Troubleshooting

Claude Code 無法連線：如果您使用 ug，請執行 ug doctor。 手動設定時，請檢查工作區主機名稱、標記、模型名稱和模型權限。

桌面登入失敗： 檢查客戶 ID、 /oidc 發行機構和 ai-gateway 範圍。 註冊的重定向 URL 必須與連接器的主機與埠口相符： 53180 適用於模型與 MCP 服務，或 53280 本指南中的技能。 OAuth 申請變更可能需時長達 30 分鐘 才能生效。

缺少桌面模型： 請檢查你的模型權限。 在 Connection > Models > 清單中，加入該模型的完整 Unity 目錄名稱。 明確清單取代了自動發現，所以請包含你想使用的所有模型。 套用變更後重新開始。

MCP 或技能連接器失敗： 請檢查其網址與權限。 授權伺服器欄位必須包含上述 JSON 陣列。 點擊 登入並測試 以檢查錯誤。

下一步

  • Last updated on