前兩天都還停留在介紹，今天終於要真的把 Claude Code 裝起來了。
我的目標很簡單：先成功安裝 Claude Code，確認指令可以使用，最後真的進去跟它說第一句話。
先不要急著做 Web App。至少要先確認工具可以正常使用，不然後面的 27 天大概也不用玩了。

Claude Code 要怎麼安裝？

Claude Code 是從終端機操作的工具，所以這次不會像一般軟體一樣，下載安裝程式後一直按「下一步」。
目前官方推薦使用 Native Install，也就是直接透過終端機安裝 Claude Code。
macOS 和 Windows 使用的指令不太一樣，所以這邊分開來看。
進階設定 - Claude Code Docs

macOS 安裝 Claude Code

如果使用 macOS，先打開「終端機 Terminal」。
也可以直接在 VS Code 裡開啟：

Terminal → New Terminal

接著輸入官方提供的安裝指令：

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

這行指令會下載 Claude Code 的安裝腳本並執行。
安裝完成後，可以先確認版本：

claude --version

如果有正常顯示版本資訊，就代表 Terminal 已經找得到 claude 這個指令。
接著輸入：

claude

第一次啟動時，按照畫面完成登入。
完成之後，就可以正式進入 Claude Code。

macOS 也可以用 Homebrew 安裝

如果原本就有使用 Homebrew，也可以使用：

brew install --cask claude-code

不過這次我會以官方推薦的 Native Install 為主。
兩種方式有一個差別要注意。
Native Install 會在背景自動更新 Claude Code。
如果是透過 Homebrew 安裝，之後則需要使用：

brew upgrade claude-code

來更新版本。

Windows 安裝 Claude Code

Windows 這邊我使用 PowerShell。
可以在 Windows 開始選單搜尋：

PowerShell

如果是在 VS Code 裡，也可以直接開啟 PowerShell 終端機。
看到類似：

PS C:\Users\使用者名稱>

就代表目前使用的是 PowerShell。
接著輸入：

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

這就是目前官方提供的 Windows PowerShell 安裝方式。
其中：

irm

是 PowerShell 的 Invoke-RestMethod，負責取得安裝腳本。
而：

iex

是 Invoke-Expression，負責執行取得的內容。
安裝完成後，我會先把 PowerShell 關掉，再重新開一個新的 PowerShell。
接著確認 Claude Code 版本：

claude --version

如果有正常顯示版本資訊，就可以啟動：

claude

第一次使用時一樣需要按照畫面完成登入。

Windows 也可以使用 WinGet

如果電腦有 WinGet，也可以使用：

winget install Anthropic.ClaudeCode

不過 WinGet 安裝的版本不會由 Claude Code 自己在背景更新。
之後可以使用：

winget upgrade Anthropic.ClaudeCode

進行更新。
這次文章後面的操作，我一樣以 Native Install 為主。

Windows 需要 Git for Windows 嗎？

這裡有一個 Windows 使用者比較容易搞混的地方。
目前 Claude Code 已經可以直接在 Windows 上執行，不一定要透過 WSL。
官方建議 Windows 安裝 Git for Windows，這樣 Claude Code 可以使用 Bash 工具。
如果沒有安裝 Git for Windows，Claude Code 則會改用 PowerShell。
所以它現在不是「沒有 Git for Windows 就完全不能使用」，但如果本來就有在寫程式、使用 Git，裝著 Git for Windows 會比較方便。

PowerShell 和 CMD 的指令不要混在一起

Windows 還有一個地方要注意。
前面這行：

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

是 PowerShell 指令。

如果使用的是 CMD，官方提供的是另一組：

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

可以看終端機前面的文字來判斷。

PowerShell 通常會看到：

PS C:\Users\使用者名稱>

CMD 則比較像：

C:\Users\使用者名稱>

如果在 CMD 輸入 irm，可能會看到找不到指令。
反過來，如果在 PowerShell 使用某些 CMD 的寫法，也可能出現語法錯誤。
所以安裝前先確認自己現在開的是哪一個終端機。

安裝完成卻找不到 claude？

Windows 如果安裝完成後輸入：

claude --version

卻看到類似：

'claude' is not recognized

或 PowerShell 顯示找不到 claude，先重新開啟終端機再試一次。
因為安裝程式可能已經修改 PATH，但原本開著的 PowerShell 還沒有讀到新的設定。
如果重新開啟後還是不行，再去檢查 PATH 和 Claude Code 的安裝位置。
不要看到找不到指令就一直重新安裝。

第一次啟動 Claude Code

不管前面使用 macOS 還是 Windows，安裝完成之後的操作就差不多了。
先建立一個測試資料夾：

mkdir ai-task-manager

接著進入資料夾：

cd ai-task-manager

這兩個指令分別是在做：

mkdir ai-task-manager
建立 ai-task-manager 資料夾

cd claude-test
進入 ai-task-manager 資料夾

接著啟動：

claude

第一次使用時，按照畫面完成登入或授權。
完成後就會正式進入 Claude Code。

第一次跟 Claude Code 說話

都裝好了，先問個最簡單的。
我輸入：

你好，請告訴我目前這個資料夾裡有什麼。

因為現在只是剛建立的測試資料夾，所以裡面應該沒有多少東西。
這個測試主要是在確認一件事情：Claude Code 現在是在我剛才進入的 ai-task-manager 資料夾裡工作。
這跟前一天提到的「Claude Code 可以在專案裡工作」開始接起來了。

再試一個小測試

既然已經可以對話，我想再多試一步。
這次我跟 Claude Code 說：

幫我建立一個 hello.py，執行後印出 Hello Claude Code。

這裡就要開始注意 Claude Code 的動作了。
不要看到 AI 說要修改檔案就一路按確認。
先看看它準備建立什麼檔案、內容是什麼，再決定要不要允許。
完成之後，可以看看資料夾裡是不是真的多出：

hello.py

接著執行：

python hello.py

macOS 如果使用的是 python3，則輸入：

python3 hello.py

如果看到：

Hello Claude Code

第一次的小測試就完成了。
這個程式本身當然沒什麼難度，我自己寫甚至更快。
今天真正要測試的是：我用一句話描述需求，Claude Code 理解之後，在目前的工作目錄建立了程式檔案。
接下來做 Web App 時，這種操作會一直出現。

今天先做到這裡

今天完成了 Claude Code 的安裝，也第一次讓它碰到實際的檔案。
目前還只是在一個空的測試資料夾裡操作。