跳到內容

管理 API 金鑰

本指南說明 Control Center 使用的每一項憑證存放在何處,以及如何變更它們。

你正在輸入的這台機器上不會儲存任何東西。 每一項憑證都存放在伺服器上;某個請求由哪一項憑證回答,取決於它背後是否有真人。

憑證 儲存位置 使用者
你的程式碼託管/工單憑證 伺服器的 0600 機密檔案,以你的使用者 id 為鍵 你要求的任何內容:PR 介面、你的代理執行、你的映像
伺服器的應用程式身分 同一個檔案,非機密項目則放在 server_settings 沒有真人要求的工作:webhook、PR 輪詢、工單同步
模型供應商金鑰與 OAuth 權杖 伺服器自有的憑證存放區 內建配接器,供該安裝上的每個工作區使用
Slack 機器人權杖 伺服器上的 <dataDir>/<workspaceId>/chat_credentials/ 該工作區的聊天橋接
外部 CLI 憑證 該 CLI 使用的任何儲存方式 伺服器主機上的 Claude Code

兩種 GitHub 憑證,各自回答不同的問題

標題為「兩種 GitHub 憑證,各自回答不同的問題」的章節
  • 你自己的,來自登入(裝置流程)或貼上權杖。所有代表你發出的請求都用它,因此以你的名義張貼的留言會帶有你的名字。其他成員無法讀取它,他們會連接自己的憑證
  • 伺服器的,來自操作者註冊的 GitHub App。它回答一切沒有呼叫者的請求——因此當某個人離開或輪替權杖時,程式碼託管存取不會消失

你自己的憑證是在 設定 → 工作區 → 個人資料與身分 的程式碼託管卡片中設定;伺服器的憑證則在 設定 → 伺服器 → 單一登入 的供應商應用程式中設定。參見設定 GitHub 整合與建立 GitHub App。

內建配接器會自行向供應商完成驗證,而那些憑證存放在伺服器上。

  1. 前往 設定 → 伺服器 → 模型供應商
  2. 捲動至供應商與模型
  3. 連接供應商——OpenAI、Codex、Cursor 與 Kimi Code 使用瀏覽器 OAuth;Anthropic 與其餘供應商則使用 API 金鑰

完整清單以及新增自訂端點的方法,請參見管理配接器與模型。

這些憑證是主機全域的:一個金鑰就為該安裝上的每個工作區服務。OAuth 權杖會在到期前重新整理。

外部配接器 CLI 會以自己的設定,在伺服器主機上保存自己的憑證——Control Center 並不管理它們。請依照 Claude Code 自身文件的說明,在執行 cc_server 的機器上完成驗證。

每個配接器的環境變數對話方塊看起來像是可以為其中之一放置金鑰的地方,但其實不是:它會寫入你的裝置,而伺服器讀取的是自己的副本,兩者之間沒有任何東西橋接。參見管理配接器與模型。

設定 → 工作區 → 一般 的工單卡片同時容納同一個決定的兩半:你的工單存放在哪個供應商,以及該供應商的憑證。選擇本機會隱藏憑證列——本機工單存放在這台伺服器自己的資料庫中,沒有需要驗證的對象。

你的金鑰會像程式碼託管憑證一樣,以你的使用者 id 存放在伺服器上。伺服器另外單獨保存自己的 Linear 金鑰(供應商應用程式),當沒有真人要求時,工單同步就是用它執行。代理的沙箱中不會注入任何工單金鑰;代理透過 Control Center 的工具寫入工單,這些工具會詢問寫入外部追蹤器規則。參見設定 Linear 整合。

  • 你的 GitHub 憑證:按下中斷連線,然後重新登入或貼上新權杖。在 GitHub 上撤銷舊的憑證
  • 伺服器的應用程式:在該應用程式的 GitHub 頁面上產生新的私密金鑰或用戶端密鑰,貼到供應商應用程式中並按下測試
  • 某個模型供應商:在其資料列上登出(OAuth)或移除金鑰,然後重新連接
  • Slack:在連接對話方塊中重新貼上權杖。參見設定 Slack 整合

PR 清單是空的,但我的權杖在 curl 中可用

標題為「PR 清單是空的,但我的權杖在 curl 中可用」的章節

檢查程式碼託管列的副標題。如果它顯示的是另一個來源(「透過此伺服器的應用程式」、「來自環境變數」),那麼你正在測試的憑證並不是在回答的那一個——你的憑證沒有被儲存。

權杖在儲存時就會被探測,因此該列會顯示它背後的帳號——但只有帳號,沒有範圍。範圍不足的權杖可以連線,之後卻會在個別請求上失敗。檢查範圍與到期時間:

終端機視窗
curl -H "Authorization: token YOUR_TOKEN" https://api.github.com/user