跳到主要內容
開發者資源
開發者資源

Claude Code in VS Code & Cursor

在 VS Code 或 Cursor 中安裝 Claude Code 擴充功能,並將其共用設定連線至 RunAPI。

概覽

官方 Claude Code 擴充功能可在 VS Code 和 Cursor 中執行。兩種編輯器使用相同的 Claude Code 使用者設定,因此本指南安裝相符的擴充功能,並在 ~/.claude/settings.json 中一次性設定 RunAPI。

開始之前

  • 安裝支援的 VS Code 或 Cursor 版本。VS Code 的最低版本需求請參閱官方擴充套件指南
  • 依照身分驗證指南建立一組標準 API 金鑰。請勿將其放入工作區設定或版本控制中。
  • 模型目錄複製支援 Anthropic Messages 的模型識別碼。

安裝

安裝官方 anthropic.claude-code 擴充功能:

  • VS Code: 開啟 VS Code Marketplace 頁面,或在擴充功能中搜尋 Claude Code
  • Cursor: 開啟 cursor:extension/anthropic.claude-code,或在擴充功能中搜尋 Claude Code

此擴充功能包含其聊天面板所需的執行環境。僅在您同時需要在整合終端機中執行 claude 時,才需安裝獨立的 CLI。

設定 RunAPI

開啟 ~/.claude/settings.json 並新增共用的使用者層級環境設定:

JSON
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

在 VS Code 或 Cursor 設定中,搜尋 Claude Code login 並為此自訂端點啟用停用登入提示。使用者設定與 CLI 共用;VS Code 擴充功能設定僅控制擴充功能的行為。

請勿將真實金鑰放入 .claude/settings.json 和編輯器工作區設定,因為這些檔案可能會被提交至版本控制。

選擇模型

YOUR_RUNAPI_MODEL_ID 替換為模型目錄中的確切識別碼。在 Claude Code 面板中,/model 可變更目前的選擇,/status 可顯示目前使用的模型。

驗證

  1. 變更擴充功能或設定後,重新載入編輯器視窗。
  2. 開啟 Claude Code Spark 面板。
  3. 執行 /status,並確認使用者設定與模型。
  4. 傳送 Describe this repository in one sentence.,並確認收到正常回應。

疑難排解

  • 擴充功能無法安裝: 請確認編輯器版本符合官方需求
  • Spark 圖示不見了: 請重新載入編輯器視窗,然後重新啟動編輯器。
  • 仍然顯示登入提示: 請在 Claude Code 擴充功能設定中啟用 Disable Login Prompt
  • 面板未繼承 shell 變數: 請使用 ~/.claude/settings.json,或從已設定的終端機啟動編輯器。GUI 應用程式通常不帶終端機環境啟動。
  • CLI 可正常運作但面板無法使用: 請重新載入視窗,並使用獨立的 CLI 重現請求,以取得更詳細的診斷資訊。
  • 身分驗證或模型選擇失敗: 請透過身分驗證指南確認金鑰,並從模型目錄複製正確的識別碼。

後續步驟

有關協定行為,請參閱 LLM API 快速入門;有關請求欄位,請參閱 Anthropic Messages API 參考。若要在編輯器中新增 RunAPI 工具,請繼續參閱 MCP 概覽