Claude Code 安裝教學（2026）：Windows、Mac 一步步裝好並完成第一個任務

如果你想讓 AI 不只是「回答問題」，而是真的幫你動手寫程式、整理檔案、跑指令，Claude Code 是目前最值得先學的 AI 代理之一。這篇 Claude Code 安裝教學會從零開始，帶你在 Windows 或 Mac 上裝好它，並用它完成第一個任務。

Claude Code 是什麼？

Claude Code 是 Anthropic 推出的 AI 編程代理（AI coding agent）。它跑在終端機裡，你用一般的中文描述想做的事，它就會讀取你的專案、提出修改、直接編輯檔案或執行指令。

和在聊天網頁問 AI 最大的不同是：它能直接對你電腦上的檔案動手。也因為這樣，它在修改檔案或執行指令之前，預設會先問你同不同意。

如果你還不熟「代理」這個概念，可以先看名詞小辭典，或回到 AI 代理總覽。

安裝前準備

開始之前，先確認三件事：

1. 作業系統：Windows 10（1809 版以上）、macOS 13 以上，或 Ubuntu 20.04、Debian 10 以上的 Linux。記憶體 4 GB 以上。
2. 帳號：需要 Claude Pro、Max、Team、Enterprise 方案，或 Anthropic Console（API）帳號。免費方案不能使用 Claude Code。
3. 會打開終端機：
   • Windows：按開始鍵，搜尋「PowerShell」並打開。看到開頭是 PS C:\Users\你的名字> 就對了。
   • Mac：按 Command + 空白鍵，搜尋「終端機」（Terminal）並打開。

不需要先安裝 Node.js，官方安裝指令會直接下載 Claude Code 本體。

Claude Code 安裝教學：Windows

在 PowerShell 裡貼上這行指令，按 Enter：

irm https://claude.ai/install.ps1 | iex

幾個要注意的地方：

• 不需要用系統管理員身分執行，一般開啟的 PowerShell 就可以。
• 安裝過程不會顯示進度，看起來像卡住是正常的，等它跑完就好。
• 如果你用的是「命令提示字元」（CMD，開頭沒有 PS），要改用這行：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

建議同時安裝 Git for Windows。 這不是必須的，沒有它時 Claude Code 會改用 PowerShell 執行指令；但裝了之後它能使用 Git Bash，很多開發工具的相容性會更好。

也可以用 WinGet 安裝：winget install Anthropic.ClaudeCode。不過 WinGet 版本不會自動更新，要自己定期執行 winget upgrade Anthropic.ClaudeCode。新手建議直接用上面的官方指令。

Claude Code 安裝教學：Mac 與 Linux

打開終端機，貼上這行指令，按 Enter：

curl -fsSL https://claude.ai/install.sh | bash

Mac 使用者也可以用 Homebrew 安裝：

brew install --cask claude-code

Homebrew 版本同樣不會自動更新，需要自己執行 brew upgrade claude-code。

確認安裝成功

安裝完成後，關掉目前的終端機，開一個新的視窗，輸入：

claude --version

只要有印出版本號（例如 2.1.xxx (Claude Code)），就代表安裝成功。

想更完整地檢查安裝和設定，可以執行：

claude doctor

它會列出安裝狀態、設定檔有沒有錯誤，以及建議的修正方式。

第一次啟動與登入

1. 用 cd 進入你想讓 Claude Code 幫忙的資料夾，例如：

cd Documents\my-project

2. 輸入 claude 啟動。
3. 第一次會跳出瀏覽器，用你的 Claude 帳號登入並授權，回到終端機就能開始使用。

小提醒：Claude Code 能讀寫的是你啟動它的那個資料夾。第一次練習時，建議先開一個新的空資料夾，不要直接在重要的工作資料夾裡試。

用 Claude Code 完成第一個任務

登入後，直接用中文輸入你想做的事。第一次可以試試這個：

幫我在這個資料夾建立一個簡單的網頁，標題是「我的第一個 AI 專案」，再寫一份 README 說明怎麼打開它。

接下來你會看到：

• Claude Code 先說明它打算怎麼做；
• 要建立或修改檔案、執行指令時，它會停下來詢問你是否同意，確認內容沒問題再按同意；
• 完成後，資料夾裡就會出現它建立的檔案。

幾個一開始就很好用的操作：

• /init：讓它讀過整個專案，產生一份 CLAUDE.md，記錄這個專案的說明和慣例，之後每次啟動它都會先參考。
• /help：列出所有可用的指令。
• Esc：覺得方向不對時，按一下就能打斷它正在做的事。

常見錯誤排除

輸入 claude 顯示「不是內部或外部命令」或 command not found 先關掉終端機、開新視窗再試一次。還是不行，代表安裝路徑沒有加進 PATH，照官方問題排除文件的「Fix your PATH」修正。

出現 The token '&&' is not a valid statement separator 你現在在 PowerShell，卻貼了 CMD 用的指令。改用 irm https://claude.ai/install.ps1 | iex。

出現 'irm' is not recognized as an internal or external command 你現在在 CMD，卻貼了 PowerShell 用的指令。改用 CMD 那行指令，或換成 PowerShell 再試。

安裝時出現 403 或其他錯誤 可能和網路環境或所在地區有關。Claude Code 只能在 Anthropic 支援的國家和地區使用，詳細對照請看官方的問題排除文件。

下一步

裝好 Claude Code 之後，你已經有了一個能直接動手的 AI 助手。接下來可以：

• 到 AI 代理總覽 看看其他主流代理，比較它們適合做什麼；
• 想自己寫程式呼叫 AI，可以從 LLM API 分區開始；
• 對圖片和影片生成有興趣，可以看 Windows 安裝 ComfyUI + Manager。

這篇教學依照 Claude Code 官方文件整理，工具更新很快，如果你照著做遇到不一樣的畫面，歡迎到 YouTube 影片底下留言告訴我們。