Claude Code VS Code 插件使用教學：安裝、登入與常用操作

本文根據 Claude Code 官方文檔《Use Claude Code in VS Code》整理，核對日期 2026-10-07；截圖引用自官方文檔。擴展更新頻繁，部分功能註明了最低版本要求，以你安裝的擴展版本為準。

適用於誰

• 平時用 VS Code（或 Cursor 等 VS Code 系編輯器）寫代碼，不想切到終端用 Claude Code 的人；
• 搜「claude code vscode 使用教學」「vscode 切換模型」「vscode 配置」的人；
• 已經在用命令行版，想知道插件版和命令行版有什麼區別的人。

結論先說

1. 官方說 VS Code 擴展是在 VS Code 裏使用 Claude Code 的推薦方式：圖形介面、並排 diff、可以在 Markdown 裏批註 plan、多標籤多會話。
2. 要求：VS Code 1.94.0 及以上，以及任一付費 Claude 訂閱（Pro / Max / Team / Enterprise）或 Claude Console 帳號，不需要 API Key。
3. 擴展自帶一份 Claude Code 內核，但不會把 claude 命令加進系統 PATH；想在 VS Code 終端裏敲 claude，還得單獨安裝命令行版。
4. 選中代碼 Claude 會自動看到；Alt+K（Mac 是 Option+K）插入帶行號的 @文件#行號 引用；Ctrl+Esc（Mac Cmd+Esc）在編輯器和 Claude 輸入框之間切換焦點。
5. 插件版只支持部分斜槓命令，! 執行 shell、Tab 補全只在命令行版有。

圖片來源：Claude Code 官方文檔《Use Claude Code in VS Code》

步驟

1. 安裝擴展

在 VS Code 裏按 Ctrl+Shift+X（Mac Cmd+Shift+X）打開擴展視圖，搜尋「Claude Code」，認準發佈者 Anthropic，點擊 Install。Cursor 等其他 VS Code 系編輯器同樣在擴展視圖裏搜；裝不上的編輯器還可以從 Open VSX 安裝，或者乾脆在它的內置終端裏用命令行版。

擴展的版本號就是它內置的 Claude Code 版本號，比如某個功能要求 v2.1.286，就需要 2.1.286 及以上的擴展。裝完圖標沒出現，執行命令面板裏的「Developer: Reload Window」。

2. 打開面板並登入

Claude Code 在 VS Code 裏的標誌是一個火花（Spark）圖標。打開方式：

• 編輯器右上角工具欄的火花圖標（最快，但必須先打開一個文件才會顯示）；
• 左側活動欄的火花圖標：打開會話列表；
• 命令面板 Ctrl+Shift+P 輸入「Claude Code」，選「Open in New Tab」等；
• 窗口右下角狀態欄的「✻ Claude Code」（沒打開文件也能用）。

第一次打開會出現登入頁，點 Sign in 後在瀏覽器裏完成授權。之後如果看到「Not logged in · Please run /login」，擴展會自動重新彈出登入頁。

3. 提問與引用代碼

• 選中代碼直接問：Claude 自動能看到你選中的內容，輸入框底部會顯示選中了幾行。
• 插入引用：按 Alt+K 插入類似 @app.ts#5-10 的引用。
• @ 文件或文件夾：輸入 @auth 會模糊匹配 auth.js、AuthService.ts 等；文件夾結尾加 /，例如 @src/components/。
• 附圖片 / 文件：圖片直接粘貼進輸入框；文件按住 Shift 拖進輸入框。
• 多行輸入：Shift+Enter 換行，Enter 發送。

注意：Claude 預設還能看到你當前打開的是哪個文件；如果只想給它選中的部分，可以關掉 Attach Open File 設定。被 files.exclude、search.exclude 或 .gitignore 排除的文件，聊天面板只會發送路徑而不發送選中的文字。

4. 審閱改動

能不能直接改文件，取決於輸入框底部顯示的權限模式：

• Auto / Edit automatically：大部分文件直接改，不逐個詢問；
• Manual：要改文件時，先顯示原文件和修改方案的左右對比，再問你是否接受。你可以接受、拒絕，或者告訴 Claude 換個做法；也可以直接在 diff 裏手動改，Claude 會被告知你改過。

圖片來源：Claude Code 官方文檔《Use Claude Code in VS Code》

改動多時，可以用每處改動下方的 Accept this change / Reject this change 逐個審（v2.1.275 起；超過 100 處改動時只能整文件審）。

5. 切換權限模式、模型和 Plan

• 權限模式：點輸入框底部的模式標識，可選 Manual、Edit automatically、Plan、Auto、Bypass permissions（最後一個要先在擴展設定裏打開 Allow dangerously skip permissions）。v2.1.283 起預設從 Auto 開始。想固定起始模式，在 VS Code 用戶設定裏設 claudeCode.initialPermissionMode。各模式區別詳見本站《Claude Code 權限模式詳解：auto、手動、plan、bypass 與權限規則配置》。
• Plan 模式：Claude 先寫方案，VS Code 會把方案作為完整的 Markdown 文檔打開，你可以在裏面加行內批註反饋，再批准執行。也可以在輸入框輸入 /plan 修復登入 bug。
• 切換模型（常被搜成「vscode claude code 切換模型」）：點輸入框底部的模型名，或在 / 選單裏選「Switch model…」；新版本直接輸入 /model 也能打開選擇器。支持推理強度的模型會多一行 Effort。
• 擴展思考：在 / 命令選單裏打開。

6. 多會話、歷史與回退

• 多個對話並行：命令面板裏「Open in New Tab」或「Open in New Window」，每個對話有獨立的上下文。
• 歷史記錄：面板頂部的 Session history 按鈕，可以搜尋、重命名、歸檔。14 天沒動靜的會話預設會自動歸檔（可在設定裏改）。
• 回退：滑鼠懸停在任意消息上點回退按鈕，可選「從這裏分叉對話」「把代碼回退到這裏」「分叉並回退代碼」。
• 和命令行互通：擴展和命令行版共用對話歷史，在終端裏 claude --resume 可以接着擴展裏的對話繼續。
• 繼續網頁版的雲端會話：用 Claude.ai 訂閱登入時，Session history 裏有 Web 標籤，可以把 claude.ai 上的雲端會話拉到本地繼續。

7. 查看用量

在輸入框輸入 /usage 打開 Account & usage 窗口：訂閱帳號會顯示當前會話和本週額度的進度條及重置時間，還會提示哪些行為（緩存未命中、長上下文、大量子代理等）消耗較多。額度規則詳見本站《Claude 使用限制與額度：用量怎麼看、什麼時候重置（Free / Pro / Max / Claude Code）》。

常用快捷鍵

插件版和命令行版的區別

需要命令行獨有的功能時，在 VS Code 的集成終端（` Ctrl+ `）裏運行 claude` 即可，它會自動和編輯器集成（顯示 diff、共享診斷資訊）。前提是已經單獨裝了命令行版，安裝方法詳見本站《Claude Code 中文入門教學（2026）：安裝、登入、第一個任務、常用命令》。喜歡命令行介面又想留在擴展裏，也可以在擴展設定裏勾選 Use Terminal。

常見問題

Q：找不到火花圖標？

官方排查順序：先打開一個文件（只打開文件夾不顯示）；確認 VS Code 版本 ≥1.94.0（幫助 → 關於）；執行「Developer: Reload Window」；臨時停用其他 AI 擴展（如 Cline、Continue）；確認工作區不是「受限模式」（擴展在受限模式下不工作）。也可以直接點右下角狀態欄的「✻ Claude Code」。

Q：設定了 ANTHROPIC_API_KEY 還是讓我登入？

VS Code 可能沒繼承你的 shell 環境變量。官方建議在終端裏用 code . 啟動 VS Code，或者直接用 Claude 帳號登入。

Q：Mac 上 Cmd+Esc 沒反應？

macOS Tahoe 及以後，系統的「遊戲疊加層」預設佔用了 Cmd+Esc。到「系統設定 → 鍵盤 → 鍵盤快捷鍵 → 遊戲控制器」取消勾選，或在 VS Code 快捷鍵設定裏給「Claude Code: Focus input」換個鍵。

Q：發了消息一直沒反應？

檢查網絡；新開一個對話試試；在終端裏運行 claude 看是否有更詳細的報錯。仍有問題可以到官方 GitHub（anthropics/claude-code）提 issue。

Q：怎麼徹底卸載？

擴展視圖裏搜「Claude Code」點 Uninstall。注意：只要你在 VS Code 集成終端裏運行過 claude，它會自動把擴展裝回來；想避免，在 /config 裏關掉 Auto-install IDE extension，或設定 autoInstallIdeExtension 為 false。

參考資料

• Use Claude Code in VS Code（官方）：https://code.claude.com/docs/en/vs-code
• Choose a permission mode（官方）：https://code.claude.com/docs/en/permission-modes
• Checkpointing（官方）：https://code.claude.com/docs/en/checkpointing
• Advanced setup（官方）：https://code.claude.com/docs/en/setup