在 VS Code 中使用 Claude Code

安裝並配置 VS Code 的 Claude Code 擴充功能。透過內聯差異、@-提及、計畫審查和快捷鍵獲得 AI 編碼協助。

VS Code 編輯器，右側開啟 Claude Code 擴充功能面板，顯示與 Claude 的對話

VS Code 擴充功能為 Claude Code 提供了原生圖形介面，直接整合到您的 IDE 中。這是在 VS Code 中使用 Claude Code 的推薦方式。

使用此擴充功能，您可以在接受 Claude 的計畫之前進行審查和編輯，在進行編輯時自動接受，從您的選擇中 @-提及具有特定行範圍的檔案，存取對話歷史記錄，以及在單獨的標籤或視窗中開啟多個對話。

先決條件

安裝前，請確保您擁有：

VS Code 1.98.0 或更高版本
Anthropic 帳戶：任何付費 Claude 訂閱（Pro、Max、Team 或 Enterprise）或 Claude Console 帳戶都可以使用，不需要 API 金鑰。首次開啟擴充功能時，您將使用此帳戶登入。如果您透過第三方提供者（如 Amazon Bedrock 或 Google Vertex AI）存取 Claude，請參閱使用第三方提供者以取得設定說明。

安裝擴充功能

點擊您的 IDE 的連結以直接安裝：

或在 VS Code 中，按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows/Linux）開啟擴充功能檢視，搜尋「Claude Code」，然後點擊安裝。

擴充功能也會安裝在其他 VS Code 分支中，例如 Devin Desktop 或 Kiro。在編輯器的擴充功能檢視中搜尋「Claude Code」，或從 Open VSX registry 安裝。如果您的編輯器無法安裝擴充功能，請安裝 CLI 並在其整合終端中執行 claude。CLI 可在任何終端中運作。

開始使用

安裝後，您可以透過 VS Code 介面開始使用 Claude Code：

開啟 Claude Code 面板

在整個 VS Code 中，Spark 圖示表示 Claude Code：<img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Spark icon" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

開啟 Claude 的最快方式是點擊編輯器工具列（編輯器右上角）中的 Spark 圖示。當您開啟檔案時，該圖示才會出現。

開啟 Claude Code 的其他方式：

活動列：點擊左側邊欄中的 Spark 圖示以開啟工作階段清單。點擊任何工作階段以將其作為完整編輯器標籤開啟，或開始新的工作階段。此圖示在活動列中始終可見。
命令面板：Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Windows/Linux），輸入「Claude Code」，然後選擇一個選項，例如「在新標籤中開啟」
狀態列：點擊視窗右下角的 ✱ Claude Code。即使沒有開啟檔案，這也有效。

您可以拖動 Claude 面板以在 VS Code 中的任何位置重新定位它。有關詳細資訊，請參閱自訂您的工作流程。

傳送提示

要求 Claude 幫助您的程式碼或檔案，無論是解釋某些內容的工作原理、除錯問題還是進行變更。

以下是詢問檔案中特定行的範例：

VS Code 編輯器，在 Python 檔案中選擇了第 2-3 行，Claude Code 面板顯示關於這些行的問題，帶有 @-提及參考

審查變更

當 Claude 想要編輯檔案時，它會顯示原始內容和建議變更的並排比較，然後要求許可。您可以接受、拒絕或告訴 Claude 改為做什麼。如果您在接受前直接在差異檢視中編輯建議的內容，Claude 會被告知您修改了它，因此它不會假設檔案與其原始提案相符。

VS Code 顯示 Claude 建議變更的差異，以及詢問是否進行編輯的許可提示

有關您可以使用 Claude Code 做什麼的更多想法，請參閱常見工作流程。

使用提示框

提示框支援多項功能：

許可模式：點擊提示框底部的模式指示器以切換模式。在正常模式下，Claude 在每個操作前要求許可。在 Plan Mode 中，Claude 描述它將做什麼，並在進行變更前等待批准。VS Code 會自動將計畫作為完整 markdown 文件開啟，您可以在其中添加內聯評論以在 Claude 開始前提供反饋。在自動接受模式下，Claude 進行編輯而不詢問。在 VS Code 設定中的 claudeCode.initialPermissionMode 下設定預設值。
命令菜單：點擊 / 或輸入 / 以開啟命令菜單。選項包括附加檔案、切換模型、切換擴展思考、查看計畫使用情況（/usage）以及啟動 Remote Control 工作階段（/remote-control）。自訂部分提供對 MCP servers、hooks、memory、permissions 和 plugins 的存取。帶有終端機圖示的項目在整合終端機中開啟。
上下文指示器：提示框顯示您使用了多少 Claude 的 context window。Claude 在需要時會自動壓縮，或您可以手動執行 /compact。
擴展思考：讓 Claude 花更多時間推理複雜問題。透過命令菜單（/）切換它。Claude 的推理在對話中顯示為摺疊的區塊：點擊一個區塊以讀取它，或按 Ctrl+O 以展開或摺疊工作階段中的每個思考區塊。有關詳細資訊，請參閱 Extended thinking。
多行輸入：按 Shift+Enter 以添加新行而不傳送。這也適用於問題對話框的'其他'自由文字輸入。

參考檔案和資料夾

使用 @-提及為 Claude 提供有關特定檔案或資料夾的上下文。當您輸入 @ 後跟檔案或資料夾名稱時，Claude 會讀取該內容，並可以回答有關它的問題或對其進行變更。Claude Code 支援模糊匹配，因此您可以輸入部分名稱來找到您需要的內容：

> Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
> What's in @src/components/ (include a trailing slash for folders)

對於大型 PDF，您可以要求 Claude 讀取特定頁面而不是整個檔案：單一頁面、範圍（如第 1-10 頁）或開放式範圍（如第 3 頁起）。

當您在編輯器中選擇文字時，Claude 可以自動看到您突出顯示的程式碼。提示框頁腳顯示選擇了多少行。按 Option+K（Mac）/ Alt+K（Windows/Linux）以插入帶有檔案路徑和行號的 @-提及（例如 @app.ts#5-10）。點擊選擇指示器以切換 Claude 是否可以看到您突出顯示的文字 - 眼睛斜線圖示表示選擇對 Claude 隱藏。

您也可以在將檔案拖動到提示框時按住 Shift 以將它們添加為附件。點擊任何附件上的 X 以將其從上下文中移除。

恢復過去的對話

點擊 Claude Code 面板頂部的工作階段歷史記錄按鈕以存取您的對話歷史記錄。您可以按關鍵字搜尋或按時間瀏覽（今天、昨天、過去 7 天等）。點擊任何對話以使用完整訊息歷史記錄恢復它。新工作階段會根據您的第一條訊息接收 AI 生成的標題。將滑鼠懸停在工作階段上以顯示重新命名和移除操作：重新命名以給它一個描述性標題，或移除以將其從清單中刪除。有關恢復工作階段的更多資訊，請參閱 Manage sessions。

從 Claude.ai 恢復遠端工作階段

如果您使用網路上的 Claude Code，您可以直接在 VS Code 中恢復這些遠端工作階段。這需要使用 Claude.ai Subscription 登入，而不是 Anthropic Console。

開啟工作階段歷史記錄

點擊 Claude Code 面板頂部的工作階段歷史記錄按鈕。

選擇遠端標籤

對話框顯示兩個標籤：本機和遠端。點擊遠端以查看來自 claude.ai 的工作階段。

選擇要恢復的工作階段

瀏覽或搜尋您的遠端工作階段。點擊任何工作階段以下載它並在本機繼續對話。

檢查帳戶和使用情況

從命令菜單執行 /usage 以開啟「帳戶與使用情況」對話框。它顯示您登入的帳戶、方案，以及目前工作階段和本週的使用情況列，包括每個限制重設的時間。

該對話框也會分解對您的方案限制有貢獻的內容。它會標記佔最近使用情況 10% 或以上的行為，例如快取未命中、長上下文和子代理程式密集或高度平行的工作階段，每個都有減少它的提示。歸因表顯示每個技能、子代理程式、外掛程式和 MCP server 貢獻了多少使用情況。需要 Claude Code v2.1.174 或更新版本。

使用「日」和「週」切換以在過去 24 小時和過去 7 天之間切換。這些數字是近似值，並從此機器上的本機工作階段計算，因此不包括來自其他裝置或 claude.ai 的使用情況。有關追蹤和減少使用情況的更多資訊，請參閱 Track your costs。

自訂您的工作流程

一旦您啟動並執行，您可以重新定位 Claude 面板、執行多個工作階段或切換到終端機模式。

選擇 Claude 的位置

您可以拖動 Claude 面板以在 VS Code 中的任何位置重新定位它。抓住面板的標籤或標題列並拖動到：

次要邊欄：視窗的右側。在您編碼時保持 Claude 可見。
主要邊欄：左側邊欄，帶有資源管理器、搜尋等圖示。
編輯器區域：將 Claude 作為標籤與您的檔案一起開啟。適用於側面任務。

執行多個對話

使用命令面板中的在新標籤中開啟或在新視窗中開啟以開始其他對話。每個對話維護自己的歷史記錄和上下文，允許您並行處理不同的任務。

使用標籤時，spark 圖示上的小彩色點表示狀態：藍色表示許可請求待處理，橙色表示 Claude 在標籤隱藏時完成。

切換到終端機模式

預設情況下，擴充功能開啟圖形聊天面板。如果您偏好 CLI 風格的介面，請開啟使用終端機設定並勾選該框。

您也可以開啟 VS Code 設定（Mac 上的 Cmd+, 或 Windows/Linux 上的 Ctrl+,），前往「擴充功能」→「Claude Code」，然後勾選使用終端機。

管理 plugins

VS Code 擴充功能包含用於安裝和管理 plugins 的圖形介面。在提示框中輸入 /plugins 以開啟管理 plugins 介面。

安裝 plugins

plugin 對話框顯示兩個標籤：Plugins 和 Marketplaces。

在 Plugins 標籤中：

已安裝的 plugins 出現在頂部，帶有切換開關以啟用或停用它們
來自您配置的市場的可用 plugins 出現在下方
搜尋以按名稱或描述篩選 plugins
點擊任何可用 plugin 上的安裝

當您安裝 plugin 時，選擇安裝範圍：

為您安裝：在您的所有專案中可用（使用者範圍）
為此專案安裝：與專案協作者共享（專案範圍）
在本機安裝：僅適用於您，僅在此儲存庫中（本機範圍）

管理市場

切換到 Marketplaces 標籤以添加或移除 plugin 來源：

輸入 GitHub 儲存庫、URL 或本機路徑以添加新市場
點擊重新整理圖示以更新市場的 plugin 清單
點擊垃圾桶圖示以移除市場

進行變更後，橫幅會提示您重新啟動 Claude Code 以應用更新。

有關 plugin 系統的更多資訊，請參閱 Plugins 和 Plugin marketplaces。

使用 Chrome 自動化瀏覽器任務

將 Claude 連接到您的 Chrome 瀏覽器以測試網路應用程式、使用主控台日誌進行除錯，以及在不離開 VS Code 的情況下自動化瀏覽器工作流程。這需要 Claude in Chrome extension 版本 1.0.36 或更高版本。

在提示框中輸入 @browser 後跟您想要 Claude 做的事情：

@browser go to localhost:3000 and check the console for errors

您也可以開啟附件菜單以選擇特定的瀏覽器工具，例如開啟新標籤或讀取頁面內容。

Claude 為瀏覽器任務開啟新標籤並共享您的瀏覽器登入狀態，因此它可以存取您已登入的任何網站。

有關設定說明、完整功能清單和故障排除，請參閱使用 Claude Code 與 Chrome。

VS Code 命令和快捷鍵

開啟命令面板（Mac 上的 Cmd+Shift+P 或 Windows/Linux 上的 Ctrl+Shift+P）並輸入「Claude Code」以查看 Claude Code 擴充功能的所有可用 VS Code 命令。

某些快捷鍵取決於哪個面板「獲得焦點」（接收鍵盤輸入）。當您的游標在程式碼檔案中時，編輯器獲得焦點。當您的游標在 Claude 的提示框中時，Claude 獲得焦點。使用 Cmd+Esc / Ctrl+Esc 在它們之間切換。

命令	快捷鍵	描述
Focus Input	`Cmd+Esc`（Mac）/ `Ctrl+Esc`（Windows/Linux）	在編輯器和 Claude 之間切換焦點
Open in Side Bar	-	在左側邊欄中開啟 Claude
Open in Terminal	-	在終端機模式中開啟 Claude
Open in New Tab	`Cmd+Shift+Esc`（Mac）/ `Ctrl+Shift+Esc`（Windows/Linux）	將新對話作為編輯器標籤開啟
Open in New Window	-	在單獨的視窗中開啟新對話
New Conversation	`Cmd+N`（Mac）/ `Ctrl+N`（Windows/Linux）	開始新對話。需要 Claude 獲得焦點且 `enableNewConversationShortcut` 設定為 `true`
Reopen Closed Session	`Cmd+Shift+T`（Mac）/ `Ctrl+Shift+T`（Windows/Linux）	重新開啟最近關閉的 Claude 工作階段標籤。當最後關閉的標籤不是 Claude 工作階段時，會回退到 VS Code 的正常重新開啟關閉編輯器。使用 `enableReopenClosedSessionShortcut` 停用
Insert @-Mention Reference	`Option+K`（Mac）/ `Alt+K`（Windows/Linux）	插入對目前檔案和選擇的參考（需要編輯器獲得焦點）
Show Logs	-	檢視擴充功能除錯日誌
Logout	-	登出您的 Anthropic 帳戶

從其他工具啟動 VS Code 標籤

擴充功能在 vscode://anthropic.claude-code/open 註冊 URI 處理程式。使用它從您自己的工具開啟新的 Claude Code 標籤：shell 別名、瀏覽器書籤，或任何可以開啟 URL 的指令碼。如果 VS Code 尚未執行，開啟 URL 會先啟動它。如果 VS Code 已在執行，URL 會在目前獲得焦點的視窗中開啟。

使用您的作業系統的 URL 開啟程式叫用處理程式。

open "vscode://anthropic.claude-code/open"

xdg-open "vscode://anthropic.claude-code/open"

在 PowerShell 中：

Start-Process "vscode://anthropic.claude-code/open"

在 cmd.exe 中，start 將其第一個引號引數視為視窗標題，因此在 URL 之前傳遞空標題：

start "" "vscode://anthropic.claude-code/open"

處理程式接受兩個選擇性查詢參數：

參數	描述
`prompt`	要在提示框中預先填入的文字。必須進行 URL 編碼。提示會預先填入但不會自動提交。
`session`	要恢復的工作階段 ID，而不是開始新對話。工作階段必須屬於目前在 VS Code 中開啟的工作區。如果找不到工作階段，會改為開始新的對話。如果工作階段已在標籤中開啟，該標籤會獲得焦點。若要以程式設計方式擷取工作階段 ID，請參閱繼續對話。

例如，若要開啟預先填入「review my changes」的標籤：

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

若要啟動終端機工作階段而不是 VS Code 標籤，請使用 CLI 的 claude-cli:// 處理程式。請參閱從連結啟動工作階段。

配置設定

擴充功能有兩種類型的設定：

VS Code 中的擴充功能設定：控制擴充功能在 VS Code 中的行為。使用 Cmd+,（Mac）或 Ctrl+,（Windows/Linux）開啟，然後前往「擴充功能」→「Claude Code」。您也可以輸入 / 並選擇一般配置以開啟設定。
~/.claude/settings.json 中的 Claude Code 設定：在擴充功能和 CLI 之間共享。用於允許的命令、環境變數、hooks 和 MCP servers。有關詳細資訊，請參閱設定。

擴充功能設定

設定	預設值	描述
`useTerminal`	`false`	以終端機模式而不是圖形面板啟動 Claude
`initialPermissionMode`	`default`	控制新對話的批准提示：`default`、`plan`、`acceptEdits` 或 `bypassPermissions`。請參閱許可模式。
`preferredLocation`	`panel`	Claude 開啟的位置：`sidebar`（右側）或 `panel`（新標籤）
`autosave`	`true`	Claude 讀取或寫入檔案前自動儲存檔案
`useCtrlEnterToSend`	`false`	使用 Ctrl/Cmd+Enter 而不是 Enter 來傳送提示
`enableNewConversationShortcut`	`false`	啟用 Cmd/Ctrl+N 以開始新對話
`enableReopenClosedSessionShortcut`	`true`	使用 Cmd/Ctrl+Shift+T 重新開啟最近關閉的 Claude 工作階段標籤。當最後關閉的標籤不是 Claude 工作階段時，快捷鍵會改為執行 VS Code 的正常重新開啟已關閉編輯器命令。
`hideOnboarding`	`false`	隱藏入門檢查清單（畢業帽圖示）
`respectGitIgnore`	`true`	從檔案搜尋中排除 .gitignore 模式
`usePythonEnvironment`	`true`	執行 Claude 時啟動工作區的 Python 環境。需要 Python 擴充功能。
`environmentVariables`	`[]`	為 Claude 程序設定環境變數。改為使用 Claude Code 設定以進行共享配置。
`disableLoginPrompt`	`false`	跳過身份驗證提示（用於第三方提供者設定）
`allowDangerouslySkipPermissions`	`false`	將 Bypass permissions 添加到模式選擇器。僅在沒有網際網路存取的 sandbox 中使用。
`claudeProcessWrapper`	-	用於啟動 Claude 程序的可執行檔。當存在時，捆綁的二進制檔案路徑會作為引數傳遞。如果擴充功能組建不包含您平台的二進制檔案，請將此設定為單獨安裝的 `claude` 二進制檔案。

VS Code 擴充功能與 Claude Code CLI

Claude Code 既可作為 VS Code 擴充功能（圖形面板）也可作為 CLI（終端機中的命令列介面）使用。某些功能僅在 CLI 中可用。如果您需要 CLI 專用功能，請在 VS Code 的整合終端機中執行 claude。這需要獨立 CLI 安裝：擴充功能不會將 claude 新增到您的 PATH。請參閱在 VS Code 中執行 CLI。

功能	CLI	VS Code 擴充功能
命令和 skills	全部	子集（輸入 `/` 以查看可用的）
MCP server 配置	是	部分（透過 CLI 添加伺服器；使用聊天面板中的 `/mcp` 管理現有伺服器）
Checkpoints	是	是
`!` bash 快捷方式	是	否
Tab 完成	是	否

使用 checkpoints 進行倒帶

VS Code 擴充功能支援 checkpoints，它們追蹤 Claude 的檔案編輯並讓您倒帶到先前的狀態。將滑鼠懸停在任何訊息上以顯示倒帶按鈕，然後從三個選項中選擇：

從此處分支對話：從此訊息開始新的對話分支，同時保持所有程式碼變更完整
將程式碼倒帶到此處：將檔案變更還原回對話中的此點，同時保持完整的對話歷史記錄
分支對話並倒帶程式碼：開始新的對話分支並將檔案變更還原到此點

有關 checkpoints 如何工作及其限制的完整詳細資訊，請參閱 Checkpointing。

在 VS Code 中執行 CLI

若要在 VS Code 中使用 CLI，請開啟整合終端機（Windows/Linux 上的 Ctrl+` 或 Mac 上的 Cmd+`）並執行 claude。CLI 會自動與您的 IDE 整合，以獲得差異檢視和診斷共享等功能。

安裝擴充功能不會將 claude 放在您的 shell PATH 上。擴充功能為其聊天面板捆綁了 CLI 的私有副本，但在終端機中輸入 claude 需要獨立 CLI 安裝。執行一次安裝，此頁面上的命令（包括 claude mcp add 和 claude --resume）在任何終端機中都可以運作。如果安裝後仍未找到 claude，請驗證您的 PATH。

如果使用外部終端機，請在 Claude Code 中執行 /ide 以將其連接到 VS Code。

在擴充功能和 CLI 之間切換

擴充功能和 CLI 共享相同的對話歷史記錄。若要在 CLI 中繼續擴充功能對話，請在終端機中執行 claude --resume。這會開啟一個互動式選擇器，您可以在其中搜尋並選擇您的對話。

在提示中包含終端機輸出

使用 @terminal:name 在您的提示中參考終端機輸出，其中 name 是終端機的標題。這讓 Claude 可以看到命令輸出、錯誤訊息或日誌，而無需複製貼上。

監控背景程序

當 Claude 執行長時間執行的命令時，擴充功能在狀態列中顯示進度。但是，與 CLI 相比，背景任務的可見性受限。為了獲得更好的可見性，讓 Claude 輸出命令，以便您可以在 VS Code 的整合終端機中執行它。

使用 MCP 連接到外部工具

MCP（Model Context Protocol）servers 讓 Claude 存取外部工具、資料庫和 API。

若要添加 MCP server，請開啟整合終端機（Ctrl+` 或 Cmd+`）並執行 claude mcp add。下面的範例添加了 GitHub 的遠端 MCP server，它使用作為標頭傳遞的個人存取令牌進行身份驗證：

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

配置後，要求 Claude 使用工具（例如「Review PR #456」）。

若要在不離開 VS Code 的情況下管理 MCP servers，請在聊天面板中輸入 /mcp。MCP 管理對話框讓您啟用或停用伺服器、重新連接到伺服器以及管理 OAuth 身份驗證。有關可用伺服器，請參閱 MCP 文件。

使用 git

Claude Code 與 git 整合以幫助直接在 VS Code 中進行版本控制工作流程。要求 Claude 提交變更、建立拉取請求或跨分支工作。

建立提交和拉取請求

Claude 可以暫存變更、編寫提交訊息並根據您的工作建立拉取請求：

> commit my changes with a descriptive message
> create a pr for this feature
> summarize the changes I've made to the auth module

建立拉取請求時，Claude 會根據實際程式碼變更生成描述，並可以添加有關測試或實現決策的上下文。

使用 git worktrees 進行並行任務

使用 --worktree（-w）標誌以在具有自己的檔案和分支的隔離 worktree 中啟動 Claude：

claude --worktree feature-auth

每個 worktree 維護獨立的檔案狀態，同時共享 git 歷史記錄。這可防止 Claude 實例在處理不同任務時相互干擾。有關更多詳細資訊，請參閱使用 Git worktrees 執行並行工作階段。

使用第三方提供者

預設情況下，Claude Code 直接連接到 Anthropic 的 API。如果您的組織使用 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 來存取 Claude，請配置擴充功能以改為使用您的提供者：

停用登入提示

開啟停用登入提示設定並勾選該框。

您也可以開啟 VS Code 設定（Mac 上的 Cmd+, 或 Windows/Linux 上的 Ctrl+,），搜尋'Claude Code login'，然後勾選停用登入提示。

配置您的提供者

遵循您的提供者的設定指南：

這些指南涵蓋在 ~/.claude/settings.json 中配置您的提供者，這確保您的設定在 VS Code 擴充功能和 CLI 之間共享。

安全和隱私

您的程式碼保持私密。Claude Code 處理您的程式碼以提供協助，但不使用它來訓練模型。有關資料處理和如何選擇退出日誌記錄的詳細資訊，請參閱資料和隱私。

啟用自動編輯許可後，Claude Code 可以修改 VS Code 配置檔案（如 settings.json 或 tasks.json），VS Code 可能會自動執行。為了在處理不受信任的程式碼時降低風險：

為不受信任的工作區啟用 VS Code 受限模式
使用手動批准模式而不是自動接受進行編輯
在接受變更前仔細審查它們

內建 IDE MCP server

當擴充功能處於活動狀態時，它會執行一個本機 MCP server，CLI 會自動連接到該伺服器。這是 CLI 在 VS Code 的原生差異檢視器中開啟差異、讀取您目前的選擇以進行 @-提及，以及 — 當您在 Jupyter notebook 中工作時 — 要求 VS Code 執行儲存格的方式。

伺服器名為 ide，從 /mcp 隱藏，因為沒有什麼可配置的。但是，如果您的組織使用 PreToolUse hook 來允許列出 MCP 工具，您需要知道它存在。

選擇和開啟檔案的內容。 連接時，CLI 會在您傳送的每個提示上包含您目前的編輯器選擇和活動檔案的路徑作為內容。當發生這種情況時，文字記錄會顯示 ⧉ Selected N lines from <file> 行。若要排除敏感檔案（如 .env），請為其路徑新增 Read 拒絕規則。匹配的拒絕規則會防止該檔案的選定文字和開啟檔案通知到達 Claude。

傳輸和身份驗證。 伺服器綁定到 127.0.0.1 上的隨機高埠，無法從其他機器訪問。每次擴充功能啟動都會生成一個新的隨機身份驗證令牌，CLI 必須提供該令牌才能連接。令牌會寫入 ~/.claude/ide/ 下的鎖定檔案，權限為 0600，在 0700 目錄中，因此只有執行 VS Code 的使用者可以讀取它。

向模型公開的工具。 伺服器託管十幾個工具，但只有兩個對模型可見。其餘的是 CLI 用於自己的 UI 的內部 RPC — 開啟差異、讀取選擇、儲存檔案 — 在工具清單到達 Claude 之前被篩選出來。

工具名稱（如 hooks 所見）	它的作用	寫入？
`mcp__ide__getDiagnostics`	返回語言伺服器診斷 — VS Code 的「問題」面板中的錯誤和警告。可選地限定於一個檔案。	否
`mcp__ide__executeCode`	在活動 Jupyter notebook 的核心中執行 Python 程式碼。請參閱下面的確認流程。	是

Jupyter 執行始終先詢問。 mcp__ide__executeCode 無法以靜默方式執行任何內容。在每次呼叫時，程式碼會作為新儲存格插入到活動 notebook 的末尾，VS Code 會將其滾動到檢視中，原生 Quick Pick 會要求您執行或取消。取消 — 或使用 Esc 關閉選擇器 — 會向 Claude 返回錯誤，沒有任何內容執行。當沒有活動 notebook、未安裝 Jupyter 擴充功能（ms-toolsai.jupyter）或核心不是 Python 時，該工具也會直接拒絕。

修復常見問題

擴充功能無法安裝

確保您有相容的 VS Code 版本（1.98.0 或更高版本）

檢查 VS Code 是否有權限安裝擴充功能

嘗試從 VS Code Marketplace 直接安裝

Spark 圖示不可見

當您開啟檔案時，Spark 圖示會出現在編輯器工具列（編輯器右上角）中。如果您看不到它：

開啟檔案：該圖示需要開啟檔案。僅開啟資料夾是不夠的。
檢查 VS Code 版本：需要 1.98.0 或更高版本（幫助 → 關於）
重新啟動 VS Code：從命令面板執行「Developer: Reload Window」
停用衝突的擴充功能：暫時停用其他 AI 擴充功能（Cline、Continue 等）
檢查工作區信任：擴充功能在受限模式下不工作

或者，點擊狀態列（右下角）中的「✱ Claude Code」。即使沒有開啟檔案，這也有效。您也可以使用命令面板（Cmd+Shift+P / Ctrl+Shift+P）並輸入「Claude Code」。

macOS 上的 Cmd+Esc 無法執行任何操作

在 macOS Tahoe 及更新版本上，系統遊戲覆蓋快捷鍵預設綁定到 Cmd+Esc，並在按鍵到達 VS Code 之前攔截它。若要釋放快捷鍵：

開啟系統設定
前往鍵盤，然後鍵盤快捷鍵，然後遊戲控制器
清除遊戲覆蓋核取方塊

或者，將擴充功能重新綁定到不同的鍵：開啟 VS Code 鍵盤快捷鍵編輯器（Cmd+K Cmd+S），搜尋 Claude Code: Focus input，並指派新的綁定。

Claude Code 從不回應

如果 Claude Code 沒有回應您的提示：

檢查您的網際網路連接：確保您有穩定的網際網路連接
開始新對話：嘗試開始新的對話以查看問題是否持續
嘗試 CLI：從終端機執行 claude 以查看您是否獲得更詳細的錯誤訊息

如果問題持續，請在 GitHub 上提交問題，並提供有關錯誤的詳細資訊。

卸載擴充功能

若要卸載 Claude Code 擴充功能：

開啟擴充功能檢視（Mac 上的 Cmd+Shift+X 或 Windows/Linux 上的 Ctrl+Shift+X）
搜尋「Claude 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"

如需其他幫助，請參閱故障排除指南。

後續步驟

現在您已在 VS Code 中設定了 Claude Code：

探索常見工作流程以充分利用 Claude Code
設定 MCP servers 以使用外部工具擴展 Claude 的功能。使用 CLI 添加伺服器，然後使用聊天面板中的 /mcp 管理它們。
配置 Claude Code 設定以自訂允許的命令、hooks 等。這些設定在擴充功能和 CLI 之間共享。

vs-code.md +35 −9

19安裝前，請確保您擁有：19安裝前，請確保您擁有：

20 20

21* VS Code 1.98.0 或更高版本21* VS Code 1.98.0 或更高版本

22* Anthropic 帳戶（首次開啟擴充功能時您將登入）。如果您使用第三方提供者（如 Amazon Bedrock 或 Google Vertex AI），請改為參閱[使用第三方提供者](#use-third-party-providers)。22* Anthropic 帳戶：任何付費 Claude 訂閱（Pro、Max、Team 或 Enterprise）或 Claude Console 帳戶都可以使用，不需要 API 金鑰。首次開啟擴充功能時，您將[使用此帳戶登入](/zh-TW/authentication#log-in-to-claude-code)。如果您透過第三方提供者（如 Amazon Bedrock 或 Google Vertex AI）存取 Claude，請參閱[使用第三方提供者](#use-third-party-providers)以取得設定說明。

23 23

24<Tip>24<Tip>

25 此擴充功能包含 CLI（命令列介面），您可以從 VS Code 的整合終端機存取它以獲得進階功能。有關詳細資訊，請參閱 [VS Code 擴充功能與 Claude Code CLI](#vs-code-extension-vs-claude-code-cli)。25 此擴充功能包含其自有的 CLI（命令列介面）副本供聊天面板使用。若要在 VS Code 的整合終端機中執行 `claude`，您還需要[獨立 CLI 安裝](/zh-TW/setup)。詳細資訊請參閱 [VS Code 擴充功能與 Claude Code CLI](#vs-code-extension-vs-claude-code-cli)。

26</Tip>26</Tip>

27 27

28<h2 id="install-the-extension">28<h2 id="install-the-extension">

36 36

37或在 VS Code 中，按 `Cmd+Shift+X`（Mac）或 `Ctrl+Shift+X`（Windows/Linux）開啟擴充功能檢視，搜尋「Claude Code」，然後點擊**安裝**。37或在 VS Code 中，按 `Cmd+Shift+X`（Mac）或 `Ctrl+Shift+X`（Windows/Linux）開啟擴充功能檢視，搜尋「Claude Code」，然後點擊**安裝**。

38 38

39擴充功能也會安裝在其他 VS Code 分支中，例如 Devin Desktop 或 Kiro。在編輯器的擴充功能檢視中搜尋「Claude Code」，或從 [Open VSX registry](https://open-vsx.org/extension/Anthropic/claude-code) 安裝。如果您的編輯器無法安裝擴充功能，請在其整合終端中執行 `claude`。[CLI](/zh-TW/quickstart) 可在任何終端中運作。39擴充功能也會安裝在其他 VS Code 分支中，例如 Devin Desktop 或 Kiro。在編輯器的擴充功能檢視中搜尋「Claude Code」，或從 [Open VSX registry](https://open-vsx.org/extension/Anthropic/claude-code) 安裝。如果您的編輯器無法安裝擴充功能，請[安裝 CLI](/zh-TW/quickstart) 並在其整合終端中執行 `claude`。CLI 可在任何終端中運作。

40 40

41<Note>如果安裝後擴充功能未出現，請重新啟動 VS Code 或從命令面板執行「Developer: Reload Window」。</Note>41<Note>如果安裝後擴充功能未出現，請重新啟動 VS Code 或從命令面板執行「Developer: Reload Window」。</Note>

42 42

70 70

71 如果您在 shell 中設定了 `ANTHROPIC_API_KEY` 但仍然看到登入提示，VS Code 可能沒有繼承您的 shell 環境。使用 `code .` 從終端機啟動 VS Code，以便它繼承您的環境變數，或改為使用您的 Claude 帳戶登入。71 如果您在 shell 中設定了 `ANTHROPIC_API_KEY` 但仍然看到登入提示，VS Code 可能沒有繼承您的 shell 環境。使用 `code .` 從終端機啟動 VS Code，以便它繼承您的環境變數，或改為使用您的 Claude 帳戶登入。

72 72

73 登入後，會出現**學習 Claude Code** 檢查清單。透過點擊**顯示給我**來完成每一項，或用 X 關閉它。若要稍後重新開啟它，請在 VS Code 設定中的'擴充功能'→'Claude Code'下取消勾選**隱藏入門**。73 登入後，會出現**學習 Claude Code** 檢查清單。透過點擊**顯示給我**來完成每一項，或用 X 關閉它。若要稍後重新開啟它，請在 VS Code 設定中的擴充功能 → Claude Code 下取消勾選**隱藏入門**。

74 </Step>74 </Step>

75 75

76 <Step title="傳送提示">76 <Step title="傳送提示">

131 131

132點擊 Claude Code 面板頂部的**工作階段歷史記錄**按鈕以存取您的對話歷史記錄。您可以按關鍵字搜尋或按時間瀏覽（今天、昨天、過去 7 天等）。點擊任何對話以使用完整訊息歷史記錄恢復它。新工作階段會根據您的第一條訊息接收 AI 生成的標題。將滑鼠懸停在工作階段上以顯示重新命名和移除操作：重新命名以給它一個描述性標題，或移除以將其從清單中刪除。有關恢復工作階段的更多資訊，請參閱 [Manage sessions](/zh-TW/sessions)。132點擊 Claude Code 面板頂部的**工作階段歷史記錄**按鈕以存取您的對話歷史記錄。您可以按關鍵字搜尋或按時間瀏覽（今天、昨天、過去 7 天等）。點擊任何對話以使用完整訊息歷史記錄恢復它。新工作階段會根據您的第一條訊息接收 AI 生成的標題。將滑鼠懸停在工作階段上以顯示重新命名和移除操作：重新命名以給它一個描述性標題，或移除以將其從清單中刪除。有關恢復工作階段的更多資訊，請參閱 [Manage sessions](/zh-TW/sessions)。

133 133

134<h3 id="resume-remote-sessions-from-claude-ai">134<h3 id="resume-cloud-sessions-from-claude-ai">

135 從 Claude.ai 恢復遠端工作階段135 從 Claude.ai 恢復遠端工作階段

136</h3>136</h3>

137 137

155 只有使用 GitHub 儲存庫啟動的網路工作階段才會出現在遠端標籤中。恢復會在本機載入對話歷史記錄；變更不會同步回 claude.ai。155 只有使用 GitHub 儲存庫啟動的網路工作階段才會出現在遠端標籤中。恢復會在本機載入對話歷史記錄；變更不會同步回 claude.ai。

156</Note>156</Note>

157 157

158<h3 id="check-account-and-usage">

159 檢查帳戶和使用情況

160</h3>

161

162從命令菜單執行 `/usage` 以開啟「帳戶與使用情況」對話框。它顯示您登入的帳戶、方案，以及目前工作階段和本週的使用情況列，包括每個限制重設的時間。

163

164該對話框也會分解對您的方案限制有貢獻的內容。它會標記佔最近使用情況 10% 或以上的行為，例如快取未命中、長上下文和子代理程式密集或高度平行的工作階段，每個都有減少它的提示。歸因表顯示每個技能、子代理程式、外掛程式和 MCP server 貢獻了多少使用情況。需要 Claude Code v2.1.174 或更新版本。

165

166使用「日」和「週」切換以在過去 24 小時和過去 7 天之間切換。這些數字是近似值，並從此機器上的本機工作階段計算，因此不包括來自其他裝置或 claude.ai 的使用情況。有關追蹤和減少使用情況的更多資訊，請參閱 [Track your costs](/zh-TW/costs#track-your-costs)。

167

158<h2 id="customize-your-workflow">168<h2 id="customize-your-workflow">

159 自訂您的工作流程169 自訂您的工作流程

160</h2>170</h2>

366 VS Code 擴充功能與 Claude Code CLI376 VS Code 擴充功能與 Claude Code CLI

367</h2>377</h2>

368 378

369Claude Code 既可作為 VS Code 擴充功能（圖形面板）也可作為 CLI（終端機中的命令列介面）使用。某些功能僅在 CLI 中可用。如果您需要 CLI 專用功能，請在 VS Code 的整合終端機中執行 `claude`。379Claude Code 既可作為 VS Code 擴充功能（圖形面板）也可作為 CLI（終端機中的命令列介面）使用。某些功能僅在 CLI 中可用。如果您需要 CLI 專用功能，請在 VS Code 的整合終端機中執行 `claude`。這需要[獨立 CLI 安裝](/zh-TW/setup)：擴充功能不會將 `claude` 新增到您的 PATH。請參閱[在 VS Code 中執行 CLI](#run-cli-in-vs-code)。

370 380

371| 功能 | CLI | VS Code 擴充功能 |381| 功能 | CLI | VS Code 擴充功能 |

372| ------------- | --------------------- | ---------------------------------------- |382| ------------- | --------------------- | ---------------------------------------- |

394 404

395若要在 VS Code 中使用 CLI，請開啟整合終端機（Windows/Linux 上的 `` Ctrl+` `` 或 Mac 上的 `` Cmd+` ``）並執行 `claude`。CLI 會自動與您的 IDE 整合，以獲得差異檢視和診斷共享等功能。405若要在 VS Code 中使用 CLI，請開啟整合終端機（Windows/Linux 上的 `` Ctrl+` `` 或 Mac 上的 `` Cmd+` ``）並執行 `claude`。CLI 會自動與您的 IDE 整合，以獲得差異檢視和診斷共享等功能。

396 406

407安裝擴充功能不會將 `claude` 放在您的 shell PATH 上。擴充功能為其聊天面板捆綁了 CLI 的私有副本，但在終端機中輸入 `claude` 需要[獨立 CLI 安裝](/zh-TW/setup)。執行一次安裝，此頁面上的命令（包括 `claude mcp add` 和 `claude --resume`）在任何終端機中都可以運作。如果安裝後仍未找到 `claude`，請[驗證您的 PATH](/zh-TW/troubleshoot-install#verify-your-path)。

408

397如果使用外部終端機，請在 Claude Code 中執行 `/ide` 以將其連接到 VS Code。409如果使用外部終端機，請在 Claude Code 中執行 `/ide` 以將其連接到 VS Code。

398 410

399<h3 id="switch-between-extension-and-cli">411<h3 id="switch-between-extension-and-cli">

530 修復常見問題542 修復常見問題

531</h2>543</h2>

532 544

533<h3 id="extension-won-t-install">545<h3 id="extension-won’t-install">

534 擴充功能無法安裝546 擴充功能無法安裝

535</h3>547</h3>

536 548

5862. 搜尋「Claude Code」5982. 搜尋「Claude Code」

5873. 點擊**卸載**5993. 點擊**卸載**

588 600

589若要也移除擴充功能資料並重設所有設定：601若要也移除擴充功能資料並重設所有設定，請刪除您平台的擴充功能儲存目錄。

602

603在 macOS 上：

590 604

591```bash theme={null}605```bash theme={null}

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

607```

608

609在 Linux 上：

610

611```bash theme={null}

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

613```

614

615在 Windows 上，在 PowerShell 中：

616

617```powershell theme={null}

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

593```619```

594 620

595如需其他幫助，請參閱[故障排除指南](/zh-TW/troubleshooting)。621如需其他幫助，請參閱[故障排除指南](/zh-TW/troubleshooting)。

vs-code.md 2026-06-16 21:57 UTC to 2026-06-17 17:02 UTC

在 VS Code 中使用 Claude Code

先決條件

安裝擴充功能

開始使用

開啟 Claude Code 面板

登入

傳送提示

審查變更

使用提示框

參考檔案和資料夾

恢復過去的對話

從 Claude.ai 恢復遠端工作階段

開啟工作階段歷史記錄

選擇遠端標籤

選擇要恢復的工作階段

檢查帳戶和使用情況

自訂您的工作流程

選擇 Claude 的位置

執行多個對話

切換到終端機模式

管理 plugins

安裝 plugins

管理市場

使用 Chrome 自動化瀏覽器任務

VS Code 命令和快捷鍵

從其他工具啟動 VS Code 標籤

配置設定

擴充功能設定

VS Code 擴充功能與 Claude Code CLI

使用 checkpoints 進行倒帶

在 VS Code 中執行 CLI

在擴充功能和 CLI 之間切換

在提示中包含終端機輸出

監控背景程序

使用 MCP 連接到外部工具

使用 git

建立提交和拉取請求

使用 git worktrees 進行並行任務

使用第三方提供者

停用登入提示

配置您的提供者

安全和隱私

內建 IDE MCP server

修復常見問題

擴充功能無法安裝

Spark 圖示不可見

macOS 上的 Cmd+Esc 無法執行任何操作

Claude Code 從不回應

卸載擴充功能

後續步驟