MoleAPIMoleAPI
文件CLI 使用

VS Code 中的 Claude Code 外掛

在 VS Code 中安裝 Claude Code 擴充功能並接入 Mole API。Claude Code 2.0 起官方已封鎖第三方 API,本教學為全網首發。

全網首發

Claude Code 2.0 之後,官方已封鎖第三方 API 的說明與入口,使用中轉/代理 API(如 Mole API)在 VS Code 外掛中對接的教學在中文網際網路上幾乎找不到。本文為全網首發:手把手教你在 VS Code 裡安裝 Claude Code 擴充功能,並透過設定使用 Mole API,在編輯器內享受與終端版一致的第三方 API 體驗。

適用情境

  • 你主要在 VS Code 裡寫程式,希望使用 Claude Code 的圖形介面(側邊欄對話、內嵌 diff、@ 引用檔案等),而不只是開終端機。
  • 你想使用 Mole API 作為 Claude 的接入點,而不是官方直連,或僅限 Bedrock/Vertex/Foundry 等官方列出的第三方。

前置需求

  • VS Code 1.98.0 或更高版本(可在 VS Code 中透過 說明 → 關於 查看)。
  • 已在 Mole API 後台 取得你的 API Key(在個人中心或 Token 管理頁面產生並複製)。

第一步:在 VS Code 中安裝 Claude Code 擴充功能

  1. 開啟 VS Code,按 Ctrl+Shift+X(Windows/Linux)或 Cmd+Shift+X(macOS)開啟擴充功能檢視。
  2. 在搜尋框輸入 Claude Code
  3. 找到由 Anthropic 發布的 Claude Code 擴充功能,點擊 安裝

VS Code 擴充功能市集中搜尋並安裝 Claude Code 擴充功能的介面,顯示擴充功能名稱與安裝按鈕

安裝完成後,若擴充功能未出現,可嘗試重新啟動 VS Code,或透過命令面板(Ctrl+Shift+P / Cmd+Shift+P)執行 Developer: Reload Window

第二步:在 Claude Code 外掛設定中完成設定(重要)

使用 Mole API 前,必須先在 Claude Code 擴充功能的設定中完成以下幾項,否則可能會跳出登入視窗,或無法走第三方 API。

開啟 Claude Code 擴充功能設定

開啟 VS Code 設定:Ctrl+,(Windows/Linux)或 Cmd+,(macOS),在左側選擇 Extensions → Claude Code,或直接搜尋 Claude Code

VS Code 設定頁面中展開的 Claude Code 擴充功能設定項目清單

1. 勾選 Hide Onboarding,避免跳出登入畫面

在設定中找到 Hide Onboarding,勾選此項。這樣在使用時就不會跳出官方登入畫面。

Claude Code 設定中的 Hide Onboarding 選項,勾選後可隱藏引導並避免登入彈窗

2. 設定 Selected Model(選擇模型)

在設定中找到 Selected Model,修改為你想使用的模型,例如你在 Mole API 中已開通的模型名稱(如 gpt-5.4 或你在後台看到的模型 ID)。

Claude Code 設定中的 Selected Model 下拉選單,用於選擇對話使用的模型

3. 在 settings.json 中設定環境變數

在設定中找到 Environment Variables(環境變數)。點擊下方的 在 settings.json 中編輯(或 "Edit in settings.json"),在 VS Code 中開啟使用者或工作區的 settings.json

Claude Code 設定中的 Environment Variables 區域及「在 settings.json 中編輯」入口

settings.json 中找到 claudeCode.environmentVariables。在其陣列內新增兩行(若該項不存在,則先加入 "claudeCode.environmentVariables": [],再於陣列中加入這兩項):

{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.moleapi.com" },
{ "name": "ANTHROPIC_API_KEY", "value": "sk-your-moleapi-apikey" }

請將 sk-your-moleapi-apikey 替換為你在 Mole API 後台 取得的真實 API Key。

在 settings.json 中編輯 claudeCode.environmentVariables,新增 ANTHROPIC_BASE_URL 與 ANTHROPIC_API_KEY

然後按 Ctrl+S(macOS 為 Cmd+S)儲存此 JSON,關閉設定頁即可。

第三步:開啟 Claude Code 並驗證

  1. 在 VS Code 中點擊編輯器右上角的 ✱ 圖示,或點擊狀態列右下角的「✱ Claude Code」,或透過命令面板輸入 Claude Code 並選擇 Open in New Tab 等方式,開啟 Claude Code 外掛。
  2. 沒有跳出登入視窗,可在輸入框中隨便送出一段內容(例如「你好」),看是否有正常回覆。
  3. 若成功收到回覆,可前往 Mole API 後台請求日誌中查看對應請求,確認使用的模型是否為你設定的 Selected Model

常見問題

擴充功能一直提示登入

請確認已在設定中勾選 Hide Onboarding,並確認 settings.json 裡的 claudeCode.environmentVariables 已正確加入 ANTHROPIC_BASE_URLANTHROPIC_API_KEY。儲存後重新開啟 Claude Code 面板,或執行 Developer: Reload Window

請求失敗或 401

  • 檢查 ANTHROPIC_API_KEY 是否與 Mole API 後台 中的 key 一致(包含前綴如 sk-),且未過期。
  • 確認 ANTHROPIC_BASE_URLhttps://api.moleapi.com,且未多填路徑(如 /v1 等)。

想同時使用終端版 Claude Code

在 VS Code 整合式終端機中執行 claude 即可。若終端版也要走 Mole API,需在 ~/.claude/settings.jsonenv 中設定相同變數,或確保啟動終端機時已載入包含這些環境變數的環境。

參考連結

這篇文件對您有幫助嗎?

最後更新於

返回首頁網關