Claude Code VS Code 教學：安裝擴充功能、Cursor、JetBrains 插件，同 Pro／Max 共用用量

想喺 VS Code 入面直接用 Claude Code，最常見的疑問是：擴充功能同 CLI 有乜分別、裝完點解終端機打唔到 claude、Cursor 同 JetBrains 用唔用到，以及 IDE 用量會唔會另外計。本文按 Anthropic 現行官方文件，一步步講 VS Code 擴充功能、Cursor 等 VS Code 分支和 JetBrains 插件的安裝、登入、權限模式、快捷鍵同常見錯誤。CLI 本身的安裝和更新，請看 Claude Code 安裝教學。

支援地區（2026 年 9 月 15 日核對）：Claude Code 官方系統要求把「Location：Anthropic supported countries」列為條件之一，而 VS Code 擴充功能和 JetBrains 插件都是用同一個 Claude 帳戶登入。截至 2026-09-15，香港並不在 Anthropic 官方支援國家／地區名單（涵蓋 Commercial API 及 Claude.ai）。名單會變，安裝或付款前請自行重查。本文只介紹官方設定步驟，不提供 VPN、外地地址、借用電話或身份等任何規避方法；香港用家請先讀 Claude 香港訂閱指南。

一句答案：VS Code 或 Cursor：在擴充功能檢視（Mac Cmd+Shift+X／Windows、Linux Ctrl+Shift+X）搜尋「Claude Code」，安裝 Anthropic 發佈的「Claude Code for VS Code」，打開任何一個檔案後按編輯器右上角的 Spark 圖示，再用 Pro、Max、Team、Enterprise 或 Console 帳戶登入；擴充功能已內置 CLI，唔使另外裝。JetBrains（IntelliJ IDEA、PyCharm 等）則相反：要先裝好 Claude Code CLI，再從 JetBrains Marketplace 安裝「Claude Code [Beta]」插件並重啟 IDE，之後在 IDE 內置終端機輸入 claude。Pro／Max 在 IDE 的用量與 claude.ai、終端機共用同一組上限；Claude 免費方案不包括 Claude Code。

資料核對日期：2026 年 9 月 15 日。當日 VS Code Marketplace 同 Open VSX 上的擴充功能版本是 2.1.272，與 Claude Code 官方 changelog 的最新版本一致；Claude Code 差不多每日都有新版本，不少版本的 changelog 都有標示 [VSCode] 的擴充功能改動，部分介面功能亦有最低版本要求（見下文）。畫面與本文不同時，以 官方 VS Code 文件和 JetBrains 文件為準。

開始前：邊啲方案可以喺 IDE 用 Claude Code？

官方 VS Code 文件寫明，擴充功能需要任何付費 Claude 訂閱（Pro、Max、Team 或 Enterprise）或 Claude Console 帳戶，而且不需要 API key；JetBrains 插件的要求一樣。

官方美元標價（Claude 價格頁及 Max 方案說明，2026-09-15 核對）：Pro 月繳 US$20，年繳折合每月 US$17（US$200 一次過預繳）；Max 5x 每月 US$100；Max 20x 每月 US$200（官方註明 Max 的標價是網頁訂閱價，經手機 App 內購可能不同）。以上不包括適用稅項，Anthropic 可隨時調整價格和方案；價格頁亦寫明 Claude Code 包含在所有付費方案，並與方案其餘部分共用用量上限，沒有固定訊息數。任何第三方或本站列出的港幣價，都不是 Anthropic 官方香港價格。應該揀 Pro、Max 5x 定 20x，請看 Claude Code 要用邊個 Claude 方案。

揀邊個介面：擴充功能、終端機 CLI 定 JetBrains 插件？

Anthropic 的平台總覽把 VS Code 擴充功能定位為「在 VS Code 內工作、毋須切換到終端機」，JetBrains 插件用於 IntelliJ、PyCharm、WebStorm 等 JetBrains IDE，而 CLI 則是終端機工作最完整的介面（腳本化和 Agent SDK 只限 CLI）。三者的最大分別，在於要唔要另外裝 CLI：

兩點常見誤會：第一，Microsoft Visual Studio 不是 VS Code，Anthropic 的 Claude Code FAQ 寫明現時沒有 Visual Studio 2022 整合。第二，擴充功能和 CLI 並不互斥，你可以平時用圖形面板，需要 CLI 專屬功能時在同一個 VS Code 視窗的終端機跑 claude，兩邊共用對話歷史。如果你用的是 OpenAI Codex，VS Code 設定另見 Codex VS Code 教學。

VS Code 安裝教學：Claude Code for VS Code

步驟 1：確認 VS Code 版本

擴充功能要求 VS Code 1.94.0 或以上。在 VS Code 選單按 Help → About 查看版本號，太舊就先更新 VS Code。

步驟 2：安裝官方擴充功能

1. 按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows／Linux）打開擴充功能檢視。
2. 搜尋「Claude Code」。
3. 確認是官方版本再安裝：名稱「Claude Code for VS Code」、發佈者「Anthropic」（Marketplace 顯示已驗證網域 anthropic.com）、擴充功能 ID anthropic.claude-code。
4. 按 Install。

你亦可以在 官方 VS Code 文件按「Install for VS Code」連結（vscode:extension/anthropic.claude-code）直接開啟 VS Code 安裝頁。搜尋結果有其他名稱相近的擴充功能時，以上述 ID 和發佈者為準，不要安裝來歷不明的修改版。

步驟 3：打開 Claude Code 面板

最快的方法是按編輯器右上角「Editor Toolbar」上的 Spark 圖示。留意這個圖示只會在打開了檔案時出現，只開資料夾並不足夠。其他開啟方法：

• Activity Bar：左側欄的 Spark 圖示會一直顯示，按下會打開 session 清單，可以揀舊對話或開新對話。
• Command Palette：按 Cmd+Shift+P／Ctrl+Shift+P，輸入「Claude Code」，揀例如「Open in New Tab」。
• Status Bar：如果你把 preferredLocation 設為 sidebar，或用「Claude Code: Open in Side Bar」開過，可以按視窗右下角的「✻ Claude Code」，沒有打開檔案亦可用。

Claude 面板可以拖到右側副側欄、左側主側欄或編輯區當分頁使用。

步驟 4：登入

1. 第一次打開面板會出現登入畫面，按 Sign in。
2. 在瀏覽器完成授權，用你平時登入 Claude 的同一個帳戶；Pro 和 Max 用家不需要另開帳戶。
3. 之後如果見到 Not logged in · Please run /login，擴充功能會自動重新打開登入畫面；沒有出現的話，在 Command Palette 執行 Developer: Reload Window。

登入後會出現「Learn Claude Code」清單，可以逐項按 Show me 學習，或按 X 關閉；想重新顯示，到 VS Code 設定 Extensions → Claude Code 取消勾選 Hide Onboarding。Command Palette 的「Claude Code: Open Walkthrough」亦有基本操作導覽。

步驟 5：在測試 repo 送出第一個提示

第一次請在一個受 Git 管理、可以隨時還原的測試項目練習（建立方法見 安裝教學的「第一個 session」一節）。在編輯器選取幾行程式碼時，Claude 會自動看到選取內容，提示框底部會顯示選了多少行；按 Option+K（Mac）／Alt+K（Windows／Linux）可以插入附檔案路徑和行數的 @ 參照，例如 @app.ts#5-10。以下是示例提示，不是實測結果：

1. （示例）「@app.ts#5-10 呢幾行做乜？先解釋，唔好改任何檔案。」
2. （示例）「幫我喺呢個檔案加一個輸入檢查。先列出計劃同會改動的檔案，等我確認先動手。」
3. （示例）「列出你剛才改動了哪些檔案，逐一解釋原因。」

Claude 亦會看到你目前打開的檔案（即使沒有選取任何內容），提示框會顯示檔名；只想傳送選取內容，可以關閉「Attach Open File」設定（需要 v2.1.271 或以上）。不想 Claude 收到某段選取內容，按選取指示器上的 X。

步驟 6：審查改動

你看到甚麼，取決於提示框底部顯示的權限模式：在 Auto 或 Edit automatically 模式，Claude 會直接編輯工作區內大部分檔案，不逐一詢問；在 Manual 模式，Claude 每次想改檔案都會先顯示原文與建議改動的並排比較，再請你批准，你可以接受、拒絕或告訴 Claude 改用其他做法。如果你在接受前直接修改 diff 內容，Claude 會被告知你改過，不會假設檔案與它原本的建議相同。

權限模式：模式指示器的選項

按提示框底部的模式指示器即可切換。VS Code 的介面標籤與設定值對應如下：

預設用哪個？官方文件寫明，Pro、Max 和 Team 方案無論在終端機或 VS Code 擴充功能，內建的起始模式都是 Auto；Enterprise 方案或 Claude Console API key 則由 Manual 開始。不過安裝或升級後的第一個 session，可能因功能設定未下載而以 Manual 開始；Auto 作為預設亦要求 Claude Code 2.1.228 或以上（macOS、Linux、WSL）或 2.1.233 或以上（原生 Windows）。實際模式以提示框底部顯示為準。

想固定由 Manual 開始：在 VS Code 的使用者設定（Cmd+,／Ctrl+,，或直接編輯使用者 settings.json）加入：

{
  "claudeCode.initialPermissionMode": "manual"
}

這個設定接受 default、manual、acceptEdits、plan 或 bypassPermissions，但不接受 auto；想由 Auto 開始，就不要設定它，並在模式指示器揀一次 Auto。擴充功能決定新對話起始模式的次序是：

1. claudeCode.initialPermissionMode（只讀使用者設定，忽略工作區設定）；
2. 你上次在模式指示器揀的模式（只限 Manual、Edit automatically 或 Auto；揀 Plan 或 Bypass permissions 只適用於該次對話）；
3. Pro、Max、Team 方案，而且 Claude Code 取得到功能設定（feature flags）時，managed settings 或 ~/.claude/settings.json 的 permissions.defaultMode；
4. 你的方案、供應商和機構設定對應的內建預設。

留意擴充功能永遠不會讀取項目的 .claude/settings.json 或 .claude/settings.local.json 來決定起始模式，所以在 repo 內設定 defaultMode 對擴充功能無效。建議做法：第一次使用和處理陌生 repo 時用 Manual，熟悉之後才決定是否用回 Auto；每次讓 Claude 大改之前先 git commit。

快捷鍵同 @ 參照

兩邊的 @ 參照快捷鍵不同，由 VS Code 轉用 JetBrains 時最易撳錯。另外，/ 指令選單可以附加檔案、切換模型和開關 extended thinking；按提示框底部的模型名稱亦可以換模型（模型名稱按鈕和 Effort 一欄需要 v2.1.257 或以上）。

Checkpoints：還原到之前某一步

擴充功能支援 checkpoints，會追蹤 Claude 的檔案改動。把滑鼠移到任何一則訊息上，會出現 rewind 按鈕，有三個選項：

• Fork conversation from here：由這則訊息開一條新對話分支，保留所有程式碼改動。
• Rewind code to here：把檔案改動還原到這一點，但保留完整對話歷史。
• Fork conversation and rewind code：開新對話分支，同時把檔案還原到這一點。

Checkpoints 方便試錯，但不代替版本控制；大改之前仍然建議先 git commit，完成後用 git diff 檢查。

用 /usage 查看帳戶同用量

在提示框執行 /usage 會打開「Account & usage」對話框。它需要以 claude.ai 帳戶登入，會顯示已登入的帳戶、你的方案，以及方案上限的用量條，例如目前 session 和本週，每條都會顯示距離重設的時間；亦會列出佔近期用量較多的行為和減少用量的提示。官方註明這些數字是近似值，只按這部電腦上的本機 session 計算，不包括其他裝置或 claude.ai 的用量。五小時 session、每週上限和點樣減少 context 浪費，請看 Claude 用量限制與 Claude Code 共用用量。

終端機模式同兩類設定

喜歡 CLI 風格的介面，可以打開 VS Code 設定，到 Extensions → Claude Code 勾選 Use Terminal。擴充功能有兩類設定，要分清楚：

• VS Code 擴充功能設定：只控制擴充功能在 VS Code 內的行為，在 Extensions → Claude Code 修改，或在提示框輸入 / 揀「General config…」。直接編輯 settings.json 時，下表的鍵要加上 claudeCode. 前綴，例如 claudeCode.useTerminal。
• Claude Code 設定 ~/.claude/settings.json：擴充功能與 CLI 共用，用來設定允許的指令、環境變數、hooks 和 MCP 伺服器。

想在 VS Code 內管理 MCP 伺服器，可在聊天面板輸入 /mcp（在對話框新增和移除伺服器需要 v2.1.261 或以上）；MCP 的設定和權限風險，請看 Claude Code MCP 教學。

擴充功能同 CLI 點樣互通

• 共用對話歷史：擴充功能與 CLI 共用同一套對話紀錄；在終端機執行 claude --resume，可以搜尋並繼續擴充功能內的對話（需要獨立 CLI 安裝）。
• 在 VS Code 內置終端機跑 CLI：按 Ctrl+`（Windows／Linux）或 Cmd+`（Mac）打開終端機，輸入 claude；CLI 會自動與 IDE 整合，在 VS Code 顯示 diff 和分享診斷。
• 用外部終端機：在 Claude Code 內執行 /ide，把它連接到 VS Code。
• 引用終端機輸出：在提示中寫 @terminal:名稱（名稱即終端機標題），Claude 就能看到指令輸出和錯誤訊息，毋須複製貼上。

Cursor 同其他 VS Code 分支

• Cursor：用的是同一個 Claude Code 擴充功能。可在官方文件按「Install for Cursor」連結（cursor:extension/anthropic.claude-code），或在 Cursor 的擴充功能檢視搜尋「Claude Code」安裝。之後的開啟、登入和權限模式步驟與上文相同。
• 其他 VS Code 分支：官方文件舉例 Devin Desktop 和 Kiro，可在編輯器的擴充功能檢視搜尋「Claude Code」，或從 Open VSX registry 安裝；Open VSX 上的名稱同樣是「Claude Code for VS Code」。
• 裝不到擴充功能：官方建議改為安裝 CLI，在該編輯器的內置終端機執行 claude；CLI 在任何終端機都可以用。

Anthropic 說明 Pro 和 Max 方案涵蓋 VS Code、Cursor 及其他 VS Code 分支，登入用同一組 Claude 帳戶資料。本文只列出官方文件點名的分支；其他編輯器是否裝得到，以該編輯器的擴充功能檢視為準。

JetBrains 教學：IntelliJ IDEA、PyCharm 等 IDE

官方 JetBrains 插件支援大部分 JetBrains IDE，包括 IntelliJ IDEA、PyCharm、Android Studio、WebStorm、PhpStorm 和 GoLand。它和 VS Code 擴充功能最大的分別是：插件會在 IDE 內置終端機執行 claude 指令並連接它，本身不內置 CLI，所以兩樣都要裝。

步驟 1：先安裝 Claude Code CLI

按 Claude Code 安裝教學完成原生安裝，再在終端機執行 claude --version 確認指令可用。claude 不在 PATH 時，插件會顯示「Cannot launch Claude Code」通知。

步驟 2：從 JetBrains Marketplace 安裝插件

在 IDE 的 Plugins 設定搜尋並安裝 Claude Code [Beta]，發佈者是已驗證的「Anthropic PBC」，然後重啟 IDE。插件名稱至今仍標示 Beta，功能和設定位置可能隨版本改變。

步驟 3：在 IDE 內置終端機執行 claude

1. 打開你的項目，在 IDE 內置終端機（位於項目根目錄）輸入 claude，所有整合功能便會啟用。
2. 第一次執行會提示你登入，用 Pro、Max、Team、Enterprise 或 Console 帳戶即可，不需要 API key。
3. 也可以在外部終端機執行 /ide 連接 JetBrains IDE，成功時會顯示類似 Connected to IntelliJ IDEA. 的訊息；如果偵測到正在執行的 IDE 未裝插件，/ide 會代你安裝並請你重啟 IDE。想 Claude 看到與 IDE 相同的檔案，要在 IDE 項目根目錄啟動 Claude Code。

步驟 4：設定 diff 顯示位置

在 Claude Code 內輸入 /config，把 Diff tool 設為 auto（在 IDE 的 diff 檢視器顯示改動）或 terminal（留在終端機）。這個選項只會在 Claude Code 已連接 IDE 時出現，所以要先在 JetBrains 終端機執行 claude，或在外部終端機先執行 /ide。

插件設定同 ESC 鍵

插件設定位於 Settings → Tools → Claude Code [Beta]：

• Claude command：自訂啟動 Claude 的指令，例如 claude 或完整路徑 /usr/local/bin/claude；IDE 找不到 claude 時在這裏填完整路徑。
• Suppress notification for when Claude Command is not found：不再顯示找不到指令的通知。
• Enable using Option+Enter for multi-line prompts：只限 macOS，開啟後 Option+Enter 會換行；要重啟終端機生效。
• Enable automatic updates：自動檢查及安裝插件更新，重啟後生效。

如果在 JetBrains 終端機按 ESC 無法中斷 Claude：到 Settings → Tools → Terminal，取消勾選「Move focus to the editor with Escape」，或按「Configure terminal keybindings」刪除「Switch focus to Editor」快捷鍵，然後套用。

WSL 用家：指令設定同「No available IDEs detected」

在 Windows 用 JetBrains、但 Claude Code 裝在 WSL 內，可把插件的 Claude command 設為以下指令（Ubuntu 換成你的 WSL 發行版名稱）：

wsl -d Ubuntu -- bash -lic "claude"

如果在 WSL2 執行 /ide 時出現「No available IDEs detected」，官方指出原因通常是 WSL2 的 NAT 網絡或 Windows 防火牆阻擋了 WSL2 與 Windows 主機上 IDE 之間的連線（WSL1 直接用主機網絡，不受影響）。這是本機虛擬網絡設定，官方提供兩個方法：

方法 A（官方推薦）：用 Windows 防火牆放行 WSL2 內部流量。保留原有的 WSL2 網絡模式。

1. 在 WSL shell 執行 hostname -I 查看 WSL2 的內部位址，取頭兩段再加上 .0.0/16 作為子網。官方例子：位址是 172.21.123.45，子網就是 172.21.0.0/16。
2. 以系統管理員身份開 PowerShell，按你的子網調整後執行：

   New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16

3. 關閉並重開 IDE 和 Claude Code，令新規則生效。

方法 B：把 WSL2 改為 mirrored networking。需要 Windows 11 22H2 或以上，Windows 10 請用方法 A。在 Windows 使用者資料夾的 .wslconfig 加入以下內容，再在 PowerShell 執行 wsl --shutdown 重啟 WSL：

[wsl2]
networkingMode=mirrored

插件另有一個「Accept connections from all network interfaces」選項（Settings → Tools → Claude Code [Beta] → Networking (Advanced)），原意是照顧 WSL2 NAT 或遠端 IDE 等無法經 loopback 連線的情況。官方警告，開啟後 IDE 的連接埠可從你的本地網絡連入；連線雖然仍要驗證 token，但因為使用未加密的 ws://，session 內容和 token 都會以明文經過網絡。官方建議只在 loopback 行不通時才開啟，WSL2 用家應優先用方法 B（mirrored networking），讓連線留在 loopback；平時請保持這個選項關閉。

JetBrains Remote Development

使用 JetBrains Remote Development 時，插件必須經 Settings → Plugin (Host) 安裝在遠端主機，而不是你本機的 client。

JetBrains 的權限提醒

官方提醒，Claude Code 在 JetBrains IDE 以 acceptEdits 模式執行時，可能修改 IDE 會自動執行的設定檔，從而繞過 bash 指令的權限提示；而 acceptEdits 和 Auto 模式都會在工作目錄內自動批准編輯（受保護路徑除外）。所以官方建議在 JetBrains 用 Manual mode 處理編輯，只使用你信任的提示，並清楚 Claude Code 有權修改哪些檔案。

JetBrains 插件是在 IDE 終端機執行 Claude Code，所以切換模式與 CLI 一樣：Pro、Max、Team 方案的 session 通常由 Auto 開始，在終端機按 Shift+Tab，由 Auto 按一下即轉為 Manual，狀態列會顯示 ⏸ manual mode on；亦可以用 claude --permission-mode manual 啟動（manual 這個別名需要 v2.1.200 或以上）。

帳戶同用量：IDE 同 Pro／Max 共用一組上限

• 同一個登入：Anthropic 說明 Pro 或 Max 方案亦涵蓋支援的 IDE，包括 VS Code、Cursor 及其他 VS Code 分支，以及 IntelliJ、PyCharm 等 JetBrains IDE；登入時用與終端機相同的 Claude 帳戶資料。
• 同一組上限：IDE 用量計入 Claude 和 Claude Code 共用的同一組用量上限，即是你在 claude.ai 聊天、在終端機跑 Claude Code、在 VS Code 或 JetBrains 用 Claude，全部扣同一份用量，並沒有另外一份 IDE 額度。
• Team／Enterprise：seat 同樣涵蓋上述 IDE，IDE 用量與終端機用量以同一方式限制及計費。

小心 API key 計費陷阱

Anthropic 支援頁提醒：如果系統設定了 ANTHROPIC_API_KEY 環境變數，Claude Code 會使用這條 API key 驗證，而不是你的訂閱，結果產生 API 用量費用。官方驗證文件補充兩點：這條環境變數同樣適用於包住 CLI 的介面，包括 VS Code 擴充功能；而在互動模式，Claude Code 會先問你一次是否批准使用這條 key，批准之後才會改用 API 計費，你的選擇亦會被記住（想改回，可在 /config 的「Use custom API key」開關調整，這個開關只在設定了該變數時才出現）。非互動模式（claude -p）則一定會用這條 key。IDE 有兩個特別情況要留意：

• VS Code 未必繼承 shell 環境：官方指出，如果你在 shell 設定了 ANTHROPIC_API_KEY，但 VS Code 仍然要求登入，多數是 VS Code 沒有繼承你的 shell 環境。可以在終端機用 code . 啟動 VS Code 令它繼承環境變數，或改用 Claude 帳戶登入。反過來說，如果你習慣在已設定這條 key 的終端機用 code . 開 VS Code，擴充功能就會繼承它，之後便會出現批准這條 key 的提示——一按批准，用量就改為按 API 收費，不再扣 Pro／Max 內含用量。
• 想用 Pro／Max 訂閱：就不要讓 IDE 讀到舊項目遺留的 key。移除環境變數的做法見 安裝教學的 API key 一節，之後在擴充功能執行 /usage，確認顯示的是你的帳戶和方案；在終端機 CLI 則可以用 /status，它會標示目前生效的是哪一種驗證方式。

如果公司經 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry 使用 Claude，要在擴充功能設定勾選 Disable Login Prompt 並按供應商指引設定；在第三方供應商下，擴充功能不提供需要 claude.ai 帳戶的功能，例如用量追蹤、語音聽寫和雲端 session 的 Web 分頁。

安全設定：陌生 repo 同敏感檔案

• 只裝官方版本：VS Code Marketplace 上的發佈者是已驗證網域 anthropic.com 的「Anthropic」（ID anthropic.claude-code）；JetBrains Marketplace 上是已驗證的「Anthropic PBC」。
• 設定檔可被自動執行：官方提醒，開啟自動編輯權限時，Claude Code 可以修改 VS Code 會自動執行的設定檔，例如 settings.json 或 tasks.json。處理不信任的程式碼時，官方建議為不信任的工作區開啟 VS Code Restricted Mode、以 Manual mode 代替 Edit automatically 或 Auto 處理編輯，並仔細審查每項改動。留意擴充功能本身在 Restricted Mode 下不能運作，所以真正要 Claude 處理陌生 repo 時，最少要用 Manual mode。
• 敏感檔案：連接 IDE 時，Claude Code 會把目前的選取內容和使用中檔案的路徑作為 context 傳送。想排除 .env 之類的敏感檔案，可為它的路徑加入 Read deny 規則；符合的規則會同時阻止該檔案的選取內容和開啟檔案通知傳到 Claude，JetBrains 亦一樣。例如在 ~/.claude/settings.json 或項目的 .claude/settings.json 加入：

{
  "permissions": {
    "deny": [
      "Read(./.env)"
    ]
  }
}

• 不要共用登入：Claude 帳戶和登入憑證不要借給別人或與人共用，任何聲稱「共用帳戶或轉交憑證很安全」的說法都不可信。帳戶保安可以用 AI 帳戶安全檢查表逐項核對。
• 截圖前遮蓋資料：分享 IDE 截圖求助前，先遮蓋電郵、帳戶及機構名稱、所在地、IP 位址，以及含使用者名稱的檔案路徑。

常見錯誤一覽：錯誤、原因、解決方法

解除安裝

1. 打開擴充功能檢視（Cmd+Shift+X／Ctrl+Shift+X），搜尋「Claude Code」，按 Uninstall。
2. 留意自動重裝：之後只要在 VS Code 內置終端機執行 claude，Claude Code 會自動把擴充功能裝返。想保持移除，可在 /config 關閉 Auto-install IDE extension，或在 ~/.claude.json 把 autoInstallIdeExtension 設為 false；亦可以把環境變數 CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL 設為 1。
3. 想一併刪除擴充功能資料並重設所有設定，刪除 VS Code 的擴充功能儲存資料夾（以下路徑只適用於 VS Code）：

macOS：

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

Linux：

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

Windows PowerShell：

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

擴充功能、JetBrains 插件和 CLI 都會寫入 ~/.claude/，這個資料夾存有與 CLI 共用的設定、MCP 設定和 session 歷史。除非確定要完全清除 Claude Code，否則不要刪除它；完整移除步驟見 安裝教學的「解除安裝」一節。

下一步

• 未裝 CLI 或想用 Desktop app：看 Claude Code 安裝教學：Windows、Mac、登入 Pro／Max。
• 想做第一個實際項目：看 Claude Code 新手教學：用 CLAUDE.md 做第一個項目。
• 未決定用哪個方案：看 Claude Code 要用邊個 Claude 方案。
• 經常撞到用量上限：看 Claude 用量限制與 Claude Code 共用用量。

如果你已按文首方格核對好資格，只是想了解本站的 Claude Code 相關服務，可到 Claude Code 服務頁查看（Claude Code 包含在 Pro 及以上方案，IDE 用量與方案共用）。頁面上的港幣金額是 HK Learn AI 的獨立服務總價，不是 Anthropic 官方香港價格；本站與 OpenAI／Anthropic 並無從屬關係。付款前請閱讀服務條款，並了解代充與成品號涉及的憑證、條款和停權風險。任何方式都不會改變文首所述的官方支援地區狀態。

結論

在 VS Code 或 Cursor 用 Claude Code，只要裝好 Anthropic 官方的「Claude Code for VS Code」擴充功能、打開檔案按 Spark 圖示、用付費帳戶登入即可，擴充功能已內置 CLI；想在終端機用齊全部指令，才需要另外安裝 CLI。JetBrains 則一定要先裝 CLI，再裝仍屬 Beta 的插件。真正要花心機的是其餘幾步：確認沒有被 ANTHROPIC_API_KEY 改成 API 計費、第一次和陌生 repo 用 Manual mode、用 checkpoints 和 Git 保留還原點，以及記住 IDE 用量與 claude.ai、終端機共用同一組上限。至於所在地是否受支援，請以官方名單為準，不要依賴任何繞過方法。