如何安裝並使用 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。

4 GB
官方最低記憶體
0
免費方案存取
1
瀏覽器登入

第一次:安裝、登入、改一行能審查的程式

  1. 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-codewinget install Anthropic.ClaudeCode。原生安裝會背景自動更新;Homebrew 與 WinGet 預設要手動升級。

  2. 2

    核對版本再開工作階段

    新開終端,跑 claude --version,應看到類似 2.1.211 (Claude Code)。失敗就跑 claude doctor。原生安裝把啟動器放在 ~/.local/bin/claude(macOS/Linux)。command not found 時先檢查 PATH,再查官方 Troubleshoot installation。

  3. 3

    在專案目錄登入

    cd 到你擁有的倉庫,執行 claude。首次會開啟瀏覽器。設了 ANTHROPIC_API_KEY 則只問一次是否用該金鑰。瀏覽器沒跳出時,按提示複製登入 URL。成功後終端寫 Login successful。工作階段裡 /login 可換號,/logout 可退出。

  4. 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
01

裝完找不到指令

多半是 PATH。關掉舊視窗,新開終端。仍失敗就跑 claude doctor,或對照官方 Troubleshoot installation and login。

02

PowerShell 和 CMD 裝反了

&& 報錯表示你在 PowerShell;irm 找不到表示你在 CMD。提示字元帶 PS 才用 irm

03

第一任務停在閒聊

「這個倉庫做什麼」只是熱身。要有一條可審查的改動:單測、驗證或修一個你點名的小 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。不要在提示裡貼金鑰。

免費開始開會