本文將介紹一系列 Claude Code 安裝、初步使用與一些「你必須要知道」且「很多人不知道」的功能!
- 將 Claude Code 融合在 VS Code / Cursor... 中!(本文以 Cursor 為例)
- 安裝在 Windows 可能會遇到的問題
安裝
- 目前僅支援 Mac, Linux 安裝
- Windows 安裝,需額外安裝「WSL」:官方文件明確指出「Windows 需透過 WSL 間接支援」,因此 在安裝前必須先準備好一個 Linux 子系統。
- 安裝方式可以請 ChatGPT 協助,會引導你安裝某個 Linux 版本,如 Ubuntu
wsl --install
wsl --set-default-version 2 # 確保使用 WSL2
wsl --set-default Ubuntu # 如果系統中有多個發行版
官方網站:
安裝 Claude Code 前:- 先確保你已安裝「Node.js 18+」,保險起見,Windows 也請在 WSL 環境下安裝。
- 如果需要版本管控,切記需安裝 git
上述皆安裝完成,即可開啟終端機安裝 Claude Code,如個人電腦需系統管理員操作,記得在指令下 sudo。
npm install -g @anthropic-ai/claude-code
使用時,將終端機指向自己的專案上,執行 claude
就完成了!
Cursor + Claude 合體技!
所謂的「合體技」,亦即當你在程式碼中「框選段落」,Claude Code 會自動帶入上下文讓你問問題!

框選文字後,終端機右下方會出現「N lines selected」,就是代表 Claude 已經認得你程式碼段落,可以針對該段落問問題。同 Cursor Ctrl/Cmd+I 的概念
然而,少數狀況(如 Windows 用戶)可能框選後沒有任何反應,可在 Claude code 模式輸入「/ide」查看是否有「Cursor」選項。

如果沒有(如下方這個論壇的狀況,可能就會需要多一些程序)
上方論壇提供不少解方(包含我自己提供的XD)
若已經安裝 Claude Code 但 Windows 無法偵測 IDE 狀況...
- 將 Cursor 加入 PATH:將 Cursor 開啟後,按
Ctrl+Shift+P
呼叫「Command Palette」,輸入Shell Command: Install 'cursor' command in PATH
,按 Enter。 - 關閉並重新打開 Cursor,使變更生效。
- 重啟 Cursor 後,開啟 WSL 終端機輸入
cursor
,系統會再開啟另一個 Cursor 視窗,會是以 WSL 的模式打開的。 - 此時可先確認是否「外掛程式(Extension)」有 Claude Code 的存在,如果仍未出現,那還需手動拖曳。
- 當 IDE 無法偵測到本機 Claude Code 時,可用 VSIX 檔手動安裝。但由於安裝位置依各人環境而異,建議先用下列指令找出自己實際的
.vsix
路徑,再進行安裝。

如果成功安裝,應該外掛程式裡會有 Claude Code
# 方法一:利用 npm root 追蹤 CLI 安裝目錄(最快)
find "$(npm root -g)/@anthropic-ai/claude-code" -name "claude-code.vsix"
# 方法二:全面搜尋 ~/.claude 目錄(保險)
find ~/.claude -type f -name "claude-code.vsix"
直接手動將該位置的檔案拖曳到 Extension 中,重啟 Cursor,並確保使用 WSL 開啟 Cursor。
WSL 在 Windows 路徑上會比較奇怪,因為要仿照 Linux。
若 Windows 路徑為C:\Users\Alice
=> WSL 為/mnt/c/Users/Alice
仍有問題的話,可參考 Cursor 論壇這則,有滿滿的網友知識點!
(寫這篇純粹因為自己踩了兩天的雷,終於解決 Windows 安裝問題...)