如何安裝並使用 Claude Code:首次安裝、登入與第一個程式任務
從官方安裝指令到瀏覽器登入,再到倉庫裡的第一個可審查改動。免費方案不能用。
第一次用 Claude Code 時,卡住的通常不是「會不會寫提示」,而是安裝指令、帳號檔和第一個能審查的改動對不上。依官方文件裝完、登入,再在你自己的倉庫做一件小事。
檢索詞是 如何安裝並使用 Claude Code。下文依 Anthropic 的安裝頁、認證頁和 code.claude.com/docs/en/quickstart 來寫。免費 Claude.ai 不含 Claude Code。裝好代理後要約短會對齊改動,用 wbmeet 建房即可,步驟見 如何建立與加入房間。
先核對能不能用
官方安裝頁寫:macOS 13.0+,Windows 10 1809+ 或 Windows Server 2019+,Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+,4 GB 記憶體,x64 或 ARM64,需要連網,且須在 Anthropic 支援的地區。也提供桌面端,本頁只走終端 CLI。
第一次:安裝、登入、改一行能審查的程式
- 1
用官方原生安裝
macOS、Linux、WSL:
curl -fsSL https://claude.ai/install.sh | bash。Windows PowerShell:irm https://claude.ai/install.ps1 | iex。提示字元帶PS才是 PowerShell;不帶則是 CMD,應改用install.cmd。也可brew install --cask claude-code或winget install Anthropic.ClaudeCode。原生安裝會背景自動更新;Homebrew 與 WinGet 預設要手動升級。 - 2
核對版本再開工作階段
新開終端,跑
claude --version,應看到類似2.1.211 (Claude Code)。失敗就跑claude doctor。原生安裝把啟動器放在~/.local/bin/claude(macOS/Linux)。command not found時先檢查 PATH,再查官方 Troubleshoot installation。 - 3
在專案目錄登入
cd到你擁有的倉庫,執行claude。首次會開啟瀏覽器。設了ANTHROPIC_API_KEY則只問一次是否用該金鑰。瀏覽器沒跳出時,按提示複製登入 URL。成功後終端寫 Login successful。工作階段裡/login可換號,/logout可退出。 - 4
做一個能審查的第一任務
先問:「這個專案做什麼?入口在哪?」再下一條:「給一個沒測試的輔助函式補單測,或給一個對外函式加輸入驗證。先出示 diff,等我同意再改。」官方 quickstart 也是先理解倉庫,再做小改動。用 Shift+Tab 切換權限模式;不要把金鑰寫進提示。
# Official native install · as of 2026-09
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
claude --version
cd /path/to/your/project
claude
# first task (inside the session)
# 1) what does this project do and where is the entry point?
# 2) add a unit test for one untested helper; show the diff first帳號、安裝通道、常見坑
| 路徑 | 官方怎麼寫 | 第一次注意 |
|---|---|---|
| 免費 Claude.ai | 不含 Claude Code | 先升級或改用 Console |
| Pro / Max / Team / Enterprise | 瀏覽器登入 | 官方建議訂閱檔 |
| Console API | 預付點數;會建 Claude Code workspace | 看用量,別當無限 |
| 原生 install.sh / .ps1 | 建議;背景自動更新 | 新開終端再跑 claude |
| Homebrew / WinGet | 不自動升級 | brew upgrade / winget upgrade |
裝完找不到指令
多半是 PATH。關掉舊視窗,新開終端。仍失敗就跑 claude doctor,或對照官方 Troubleshoot installation and login。
PowerShell 和 CMD 裝反了
&& 報錯表示你在 PowerShell;irm 找不到表示你在 CMD。提示字元帶 PS 才用 irm。
第一任務停在閒聊
「這個倉庫做什麼」只是熱身。要有一條可審查的改動:單測、驗證或修一個你點名的小 bug,並看 diff。
官方 quickstart:先理解程式庫,再讓 Claude Code 做一次實際編碼。具體指令與帳號檔以 code.claude.com/docs 為準。
- 原生安裝 ≠ Homebrew 自動更新
- 原生安裝會背景更新。Homebrew 的
claude-code跟穩定通道,大約晚一週;要手動brew upgrade claude-code。 - Windows 原生 ≠ 必須 WSL
- 可在 PowerShell / CMD 直接裝。官方建議裝 Git for Windows,以便使用 Bash 工具;不裝則走 PowerShell 工具。要 Linux 工具鏈或沙箱再進 WSL 2。
- 教學頁不是會議說明書
- 只講 Claude Code 第一次。短會白板見 wbmeet,以及何時不必再開沉重會議 App 的 對照筆記。
還想核對的問題
免費 Claude.ai 能用 Claude Code 嗎?
官方安裝頁寫:免費方案不含 Claude Code。需要 Pro、Max、Team、Enterprise 或 Console。企業雲另見 Bedrock、Agent Platform、Foundry。
裝完提示 command not found 怎麼辦?
先新開終端再跑 claude --version。仍失敗則 claude doctor,並核對本機 PATH 是否包含官方啟動器目錄(macOS/Linux 常見為 ~/.local/bin)。
Windows 該用哪條安裝指令?
提示字元是 PS C:\ 用 PowerShell 的 irm … | iex;是 C:\ 且沒有 PS,用 install.cmd。不要混用。
第一個任務必須改正式環境程式嗎?
不必。官方允許先問專案做什麼。建議緊接著做一件可回溯的小事(單測或驗證),並先看 diff。不要在提示裡貼金鑰。