pi-vertex-anthropic 是做什麼的？
🌍 透過 Pi Vertex Anthropic 擴充功能，輕鬆啟用 Claude 模型，整合 Google Cloud 的 Vertex AI，實現高效編碼與成本追蹤。
概觀
此技能（擴充功能）讓 Claude Code 或其他 AI 代理工具能夠直接透過 Google Cloud Vertex AI 呼叫 Anthropic 的 Claude 模型。這不僅簡化了模型存取的流程，還利用 Vertex AI 的企業級基礎設施來增強效能與安全性，並提供內建的成本監控功能。
功能特色
- 無縫整合：將 Anthropic 模型無縫整合至 Vertex AI，避免直接管理多個 API 金鑰。
- 成本追蹤：自動記錄每次模型呼叫的費用，協助開發者最佳化使用量。
- 低延遲：透過 Vertex AI 的全球網路，實現更快的模型回應。
- 企業就緒：繼承 Google Cloud 的 IAM 角色、VPC-SC 等安全與治理功能。
先決條件
- 有效的 Google Cloud Platform (GCP) 專案。
- 已啟用 Vertex AI API。
- 擁有以下任一身分驗證：
- 服務帳戶金鑰（JSON 檔案）
- 已安裝並設定的
gcloudCLI（使用gcloud auth application-default login）
安裝與設定
1. 安裝技能
將此技能新增至您的 AI 代理工具（例如 Claude Code）的技能目錄中。通常複製此儲存庫或新增為 Git 子模組。
2. 設定環境變數
在您的專案根目錄建立 .env 檔案或直接在環境中設定：
export VERTEX_AI_PROJECT_ID="您的-gcp-專案-id"
export VERTEX_AI_LOCATION="us-central1" # 或其他支援的區域
# 如果使用服務帳戶：
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account-key.json"
3. 更新設定檔
在您的 claude-code.json 或相關設定檔中，加入或更新以下項目：
{
"model": "claude-3-opus-20240229",
"provider": "vertex-ai",
"projectId": "${VERTEX_AI_PROJECT_ID}",
"region": "${VERTEX_AI_LOCATION}"
}
使用方式
設定完成後，即可像平常一樣使用 Claude Code。所有 API 請求將會自動導向 Vertex AI。
例如：
claude "Explain the SOLID principles with code examples in Python."
成本監控
此技能會自動在每個對話或工作階段結束時輸出成本摘要。您也可以在 Vertex AI 主控台的「監控」->「成本」頁面，查看更詳細的費用明細。
疑難排解
| 問題 | 可能原因 | 解決方案 |
|---|---|---|
Permission denied | IAM 權限不足 | 確保服務帳戶具有 roles/aiplatform.user 角色 |
Model not found | 區域不支援該模型 | 確認 VERTEX_AI_LOCATION 設為支援 Claude 的區域 (如 us-central1) |
Quota exceeded | API 配額用完 | 在 GCP 主控台申請增加配額 |