Claude Code VS Code 教學:安裝擴充套件、怎麼打開、跟終端機版差在哪

依官方文件2026.10.13

Claude Code 有官方的 VS Code 擴充套件,裝好之後編輯器裡多一個 Claude 的面板,改檔案時直接用左右對照的方式給你看差異。這篇照官方文件整理安裝條件、四種打開的方式、常用快捷鍵、它比終端機版少了哪些功能,還有圖示不見、快捷鍵沒反應這類常見問題。版本的部分用我電腦上實際看到的情況說明。

更新 2026/10/13・約 8 分鐘讀完・查證環境:依 Claude Code 官方文件〈Use Claude Code in VS Code〉,2026 年 10 月 13 日讀取。這台 Mac 的 VS Code 裝了官方擴充套件,我看的是它在硬碟上的資料夾名稱、版本和大小;擴充套件的畫面我沒有實際操作,所以安裝步驟、快捷鍵、每個功能都是照文件寫的

先講結論

  • 官方擴充套件的名字就叫 Claude Code,在 VS Code 的擴充功能頁搜尋就有。需要 VS Code 1.94.0 以上,還有付費的 Claude 方案或 Console 帳號。
  • 裝了擴充套件,不代表終端機裡可以打 claude。擴充套件自己帶一份給面板用,終端機的要另外裝。
  • 大部分功能兩邊都有。擴充套件少的是一部分斜線指令、驚嘆號開頭直接跑指令、Tab 補完。
目錄
  1. 一句話
  2. 需要什麼
  3. 安裝
  4. 四種打開的方式
  5. 在編輯器裡多出來的用法
  6. 常用的快捷鍵
  7. 跟終端機版差在哪
  8. 擴充套件有自己的版本
  9. 文件列的幾個常見問題
  10. 在 Cursor 裡用
  11. 如果不想用編輯器
  12. 這篇沒有測的

你本來就整天開著 VS Code。要用 Claude Code,不想另外開一個終端機視窗切來切去。

官方有做 VS Code 的擴充套件,就是給這個情況用的。

先交代:這篇主要是照官方文件整理的。我的電腦有裝這個擴充套件,但我沒有實際去操作它的畫面,所以步驟和快捷鍵都是文件上寫的。我自己看到的只有版本那一段。

一句話

它是 Anthropic 官方出的擴充套件,裝好之後 VS Code 裡多一個 Claude 的面板。

你在面板裡用講的請它做事。它要改檔案的時候,直接在編輯器裡用左右對照的方式給你看改了哪裡。文件說,這是在 VS Code 裡使用 Claude Code 的建議方式。

Claude Code 本身是什麼,在Claude Code 是什麼。

需要什麼

文件列了兩個條件。

VS Code 要 1.94.0 以上。

要有可以登入的帳號。付費的 Claude 方案都可以,Pro、Max、Team、Enterprise;或是 Claude Console 的帳號。不需要另外準備 API key。方案的差別在Claude Code 費用。

安裝

在 VS Code 按 Cmd+Shift+X,Windows 和 Linux 是 Ctrl+Shift+X,打開擴充功能頁。搜尋「Claude Code」,按 Install。

發行者是 Anthropic,擴充套件的識別名稱是 anthropic.claude-code。名字很像的擴充套件不只一個,我電腦上就另外裝了一個社群做的,要認這個識別名稱。

裝完如果沒有出現,文件說重新啟動 VS Code,或從指令面板執行 Developer: Reload Window。

四種打開的方式

文件說,整個 VS Code 裡代表 Claude Code 的是一個星芒形狀的圖示。

編輯器右上角的工具列。點那個圖示最快。要注意,它只有在你開著一個檔案的時候才會出現。

左邊的活動列。這裡的圖示一直都在,點了會打開對話清單。

指令面板。按 Cmd+Shift+P,輸入 Claude Code,選 Open in New Tab 這類的項目。

右下角的狀態列。點「✻ Claude Code」,沒有開任何檔案的時候也能用。

第一次打開會出現登入畫面,按 Sign in 之後到瀏覽器完成授權。登入後會有一份 Learn Claude Code 的清單帶你認識基本操作,不想看可以關掉。

在編輯器裡多出來的用法

這幾樣是擴充套件才有的方便。

你選取的文字,它自己看得到。在編輯器裡把幾行程式碼反白,直接問它這幾行在做什麼就可以,不用複製貼上。

想明確指給它看,按 Option+K,Windows 和 Linux 是 Alt+K。它會在輸入框插入一個帶檔名和行號的參照,像 @app.ts#5-10。

圖片可以直接從剪貼簿貼進輸入框。檔案要按住 Shift 再拖進去。

權限模式在輸入框的下緣切換。Manual 模式下,它要改檔案時會顯示原本和改後的左右對照,然後問你。你可以整個接受、整個拒絕,也可以一處一處決定。

Plan 模式下,它會把計畫開成一份 Markdown 文件,你可以在裡面逐行加意見,它看了再調整。

常用的快捷鍵

做什麼 Mac Windows/Linux
在編輯器和 Claude 之間切換 Cmd+Esc Ctrl+Esc
用新分頁開一段對話 Cmd+Shift+Esc Ctrl+Shift+Esc
插入目前檔案和選取範圍的參照 Option+K Alt+K
打開指令面板 Cmd+Shift+P Ctrl+Shift+P

跟終端機版差在哪

大部分功能兩邊都有。文件列的差別是這幾項:

功能 終端機版 VS Code 擴充套件
斜線指令和技能 全部 一部分,打 / 看得到有哪些
MCP 伺服器 有 有
檢查點,可以倒回先前的狀態 有 有
驚嘆號開頭直接跑指令 有 沒有
Tab 補完 有 沒有

有一件事很多人會搞錯:裝了擴充套件,不代表終端機裡可以打 claude。文件寫得很直接,擴充套件不會把 claude 加進系統的路徑,它帶的那一份只給自己的面板用。

所以需要終端機版才有的功能時,要另外把終端機版裝起來,然後在 VS Code 內建的終端機裡執行。安裝方法在Claude Code 安裝教學。

兩邊的對話是通的。在擴充套件裡聊到一半,想換到終端機繼續,打 claude --resume 就會列出來讓你挑。

擴充套件有自己的版本

這一段是我在自己電腦上看到的。

文件寫,擴充套件的版本號,就是它裡面帶的那一份 Claude Code 的版本。某個功能如果要求 2.1.286 以上,看的是擴充套件的版本,不是你終端機裡的。

我的電腦上,擴充套件的資料夾名稱寫的是 2.1.278,終端機裡的 claude 是 2.1.280,兩個不一樣,也都不是當時最新的 2.1.296。

還有一件小事:我的擴充套件資料夾裡留著三個版本,2.1.274、2.1.276、2.1.278,每個大約 215 MB。

版本要怎麼查、怎麼更新,在Claude Code 怎麼更新。

OpenAI 的 Codex 擴充套件也是同樣的設計。我把它拆開,裡面帶的是一份 294 MB 的 Codex CLI,版本跟另外裝的終端機版不一定一樣,在 Codex VS Code 教學。

文件列的幾個常見問題

星芒圖示不見了。它要有檔案開著才會出現,只開資料夾不算。另外文件提到,在受限模式下擴充套件不會運作,其他 AI 擴充套件也可能衝突,可以先暫時停用試試。再不行就點右下角狀態列的「✻ Claude Code」。

在 Mac 上按 Cmd+Esc 沒反應。文件說,macOS Tahoe 之後,系統把這組按鍵預設給了遊戲用的 Game Overlay,按鍵還沒到 VS Code 就被攔走。解法是到系統設定的鍵盤、鍵盤快速鍵、遊戲控制器,把 Game Overlay 取消勾選,或是在 VS Code 裡把這個功能改綁別的按鍵。

裝不起來。先確認 VS Code 是 1.94.0 以上,再試著從 VS Code Marketplace 的頁面直接安裝。

在 Cursor 裡用

官方文件有給 Cursor 的安裝連結,所以 Claude Code 的擴充套件也能裝進 Cursor。Cursor 自己的 AI 怎麼收費、跟 Claude Code 差在哪,我寫在Claude Code 跟 Cursor 怎麼選。

用的是 IntelliJ IDEA、PyCharm 這些 JetBrains 的 IDE,接法不一樣:要另外裝 Claude Code 本體,再裝官方外掛,整理在Claude Code IDE 整合。

如果不想用編輯器

Claude Code 還有另外兩種用法。完全不想碰程式編輯器和終端機的話,桌面版比較適合,我寫在Claude Code 桌面版怎麼用。習慣終端機的,看Claude Code 教學。

這篇沒有測的

擴充套件的畫面操作,包括安裝、登入、面板、左右對照的差異、Plan 模式。

所有快捷鍵。

Cursor 和其他編輯器。

Windows 和 Linux。

常見問題

Claude Code 的 VS Code 擴充套件要錢嗎?

擴充套件本身可以直接安裝,但要登入才能用。文件寫需要付費的 Claude 方案,Pro、Max、Team、Enterprise 都可以,或是 Claude Console 的帳號,不需要另外準備 API key。

裝了擴充套件,終端機裡就能打 claude 嗎?

不行。文件寫擴充套件不會把 claude 加進系統的路徑,它帶的那一份只給自己的面板用。想在 VS Code 的終端機裡打 claude,要另外安裝終端機版。

Cursor 可以裝 Claude Code 擴充套件嗎?

可以,官方文件有給 Cursor 的安裝連結。其他從 VS Code 分出來的編輯器,文件說可以在它的擴充功能頁搜尋,或從 Open VSX 安裝。

擴充套件和終端機版的對話紀錄互通嗎?

互通。文件寫兩邊共用同一份對話紀錄,在終端機打 claude --resume 會出現選單,可以挑在擴充套件裡開始的那一段接著做。

這篇怎麼查證的

這篇依官方文件整理,查證日期 2026/10/13,作者沒有在這個環境實際執行(依 Claude Code 官方文件〈Use Claude Code in VS Code〉,2026 年 10 月 13 日讀取。這台 Mac 的 VS Code 裝了官方擴充套件,我看的是它在硬碟上的資料夾名稱、版本和大小;擴充套件的畫面我沒有實際操作,所以安裝步驟、快捷鍵、每個功能都是照文件寫的)。價格與方案以官方頁面為準,工具改版後內容可能過期。