本文將介紹一系列 Claude Code 安裝、初步使用與一些「你必須要知道」且「很多人不知道」的功能！
- 將 Claude Code 融合在 VS Code / Cursor... 中！（本文以 Cursor 為例）
- 安裝在 Windows 可能會遇到的問題
安裝
(2025.11更新)
Anthropics 官方11月發布更新，全平台可不必使用 npm 安裝，使用 curl 安裝即可！
官方強烈建議安裝方法改為如下：
- Homebrew (macOS, Linux)
brew install --cask claude-code
- macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
- Windows PowerShell
irm https://claude.ai/install.ps1 | iex
- Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
(2025.06以前 仍將過去資料放置於此供參考)
- 過去僅支援 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）
(2025.09 以前的狀況)若已經安裝 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 安裝問題...）
