觀點 · 資訊分享

Claude API 金鑰改成「跟著人走」：同事離開組織，他的金鑰就自動失效

Claude Console 推出個人金鑰與服務帳號金鑰，每把金鑰都綁定一個使用者或服務帳號，帳號被移出組織時金鑰跟著停用。舊的工作區金鑰還能用，但官方已列為舊做法。

一句話看懂：Claude API 的金鑰改成綁定「人」或「服務帳號」，人被移出組織，他的金鑰就自動失效，不會再有被遺忘的舊金鑰。

Claude 金鑰改成綁定身分資訊圖卡：每把金鑰都有主人，主人被移出組織，金鑰就停用

先用白話講：金鑰跟著誰有什麼差別？

想像公司大門的鑰匙。以前的做法是「鑰匙掛在辦公室」：誰都能拿去用，同事離職了，他手上那把鑰匙還是開得了門，除非有人記得去換鎖。

新的做法是「門禁卡跟著人走」：每張卡都登記在某個人名下，人資把他的帳號停掉，卡就刷不過了。

API 金鑰就是程式呼叫 Claude 時用的那把鑰匙。這次 Anthropic 把它從「掛在辦公室」改成「登記在人名下」。

Anthropic 在 8 月 27 日的平台更新紀錄宣布，Claude Console 現在可以建立兩種新金鑰：

兩者都是「身分型」金鑰：每次請求都算在某個身分頭上，該身分被移出組織時，金鑰就停止運作。官方說這樣管理員比較容易追蹤每個帳號的用量，也比較能確認金鑰是被正當使用。

原本的工作區金鑰仍然可以用，但官方已經把它列為舊做法。

金鑰	代表誰	什麼時候失效	適合
個人金鑰	你本人	你被移出組織	自己的開發與腳本
服務帳號金鑰	服務帳號	服務帳號被封存	正式服務、CI
工作區金鑰（舊）	沒有人，屬於工作區	到期、停用或刪除	既有整合，建議汰換

官方文件特別提醒：不要把個人金鑰拿去給整個團隊共用，它代表一個人，那個人離開時就會壞掉，共用的工作請改用服務帳號。

POST /v1/messages
Authorization: Bearer YOUR_API_KEY
anthropic-workspace-id: YOUR_WORKSPACE_ID
anthropic-version: 2023-06-01

接案最常見的金鑰問題不是被駭，而是「沒人知道這把金鑰是誰的」。專案做完、合作結束，當初建的金鑰還在某台伺服器上跑，帳單一直來，卻找不到負責人。身分型金鑰把這個問題從制度面解決了：金鑰一定有主人，主人離開就失效。

我的建議是：替客戶建 Claude API 整合時，正式環境一律用服務帳號金鑰，不要用自己的個人金鑰。不然哪天我被移出客戶的組織，客戶的服務就跟著停了，這是很難看的交接意外。

個人金鑰和服務帳號金鑰差在哪？

個人金鑰代表你本人，權限跟你一樣，你離開組織就失效；服務帳號金鑰代表一個由管理員建立的「機器帳號」，適合正式服務與 CI，不會因為某個員工離職就壞掉。

舊的工作區金鑰會被停用嗎？

目前不會。官方說工作區金鑰仍然支援，只是列為舊做法，建議新的整合改用個人金鑰、服務帳號金鑰或工作負載身分聯合（WIF）。

沒指定工作區的金鑰要怎麼用？

如果建立金鑰時沒有限定工作區，每次請求都要用 anthropic-workspace-id 標頭指定要用哪個工作區；限定單一工作區的金鑰則可以省略。

要怎麼把舊金鑰換掉？

先決定用個人金鑰還是服務帳號金鑰，必要時請管理員建立服務帳號，建好新金鑰後替換環境變數或密鑰管理服務裡的值，確認請求都正常，再刪除舊的工作區金鑰。

作者

接案做系統開發、網站與主機託管。觀點裡的文章都是我自己寫的,寫的是做專案時第一手遇到的事。