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

Claude Code(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 並為此自訂端點啟用 Disable Login Prompt。使用者設定與 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 概覽