Claude Code 中文入門教學（2026）：安裝、登入、第一個任務、常用命令

本文根據 Claude Code 官方文檔和公開教學整理（核對日期 2026-10-07），文中截圖引用自公開發布的教學並註明出處。Claude Code 更新很快，介面與命令以官方文檔為準。

適用於誰

• 已經開通 Claude Pro / Max（或團隊版）的用戶，想在自己電腦上讓 Claude 直接讀代碼、改代碼、跑命令。
• 會打開終端（命令行）但不一定是專業程式員的人：寫腳本、整理文件、改個小網站都可以用。
• 不適合：只想網頁聊天的用戶（直接用 claude.ai 即可）；免費版帳號（官方定價頁和安裝頁都寫明免費版不含 Claude Code）。

結論先說

1. 官方推薦用「原生安裝」：Mac / Linux 一行 curl，Windows 在 PowerShell 裏一行 irm，不需要先裝 Node.js。
2. 裝好後在項目目錄裏輸入 claude，第一次會跳瀏覽器登入，用 Claude 訂閱帳號或 Console（API）帳號都行。
3. 先讓它「讀懂項目」，再讓它「改一個小地方」，確認它改得對，再逐步放大任務。
4. 記住 6 個命令就夠日常用：/init、/clear、/compact、/model、/resume、/usage。

步驟

第 1 步：確認電腦滿足要求

官方要求（2026-10 setup 頁）：macOS 13.0+、Windows 10 1809+ / Windows Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine 3.19+；4 GB 以上內存，x64 或 ARM64 處理器；需要聯網。

另外，官方要求在 Anthropic 支持的國家和地區 使用，中國大陸目前不在該列表中，請遵守所在地法律和服務條款。

第 2 步：安裝

macOS / Linux / WSL：

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

Windows PowerShell（提示符以 PS C:\ 開頭）：

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

Windows CMD（提示符沒有 PS）：

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

Windows 上不需要以管理員身份運行。也可以用包管理器：Mac 上 brew install --cask claude-code，Windows 上 winget install Anthropic.ClaudeCode，Debian / Fedora / RHEL / Alpine 還可以用 apt、dnf、apk（官方 setup 頁有完整步驟）。注意這些包管理器方式預設不會自動更新，要自己定期升級；原生安裝會在後台自動更新。

安裝腳本跑完後會提示安裝成功、版本號和安裝位置，下面是在 macOS 終端裏的輸出示例：

圖片來源：Analytics Vidhya

裝完新開一個終端窗口，運行：

bash
claude --version

能打印出版本號（後面帶 (Claude Code)）就說明裝好了。提示找不到 claude，通常是安裝目錄還沒加進 PATH（上圖裏的「Setup notes」就是在提醒這件事），重開終端或按官方「Fix your PATH」處理。想進一步體檢，可以運行 claude doctor，它只做只讀檢查，會列出安裝和配置問題及修復建議。

Windows 用戶補充：官方建議裝 Git for Windows，這樣 Claude Code 能用 Bash 執行命令；不裝也能用，會改用 PowerShell 執行命令。用 WSL 的話不需要 Git for Windows。

第 3 步：登入

bash
cd 你的項目文件夾
claude

第一次運行會讓你選擇登入方式：用 Claude 訂閱帳號（Pro / Max / Team / Enterprise，官方推薦）、Claude Console 帳號（預充值 API 額度），或第三方雲平台（Amazon Bedrock 等）。

圖片來源：Analytics Vidhya

選訂閱帳號後會打開瀏覽器，確認授權即可回到終端。瀏覽器沒有自動打開時，可以按 c 複製登入連結自己粘貼到瀏覽器；如果瀏覽器最後顯示的是一串登入碼，就把它粘貼回終端的 Paste code here if prompted 提示處（WSL2、SSH、容器裏比較常見）。

圖片來源：Analytics Vidhya

登入一次後憑據會儲存下來，下次不用再登。之後想換帳號，在會話裏輸入 /login；想退出登入用 /logout。

還沒有訂閱的話，可以在本站開通：/chongzhi/claude-pro。

第 4 步：第一個任務——先讀懂，再動手

進入會話後，直接用中文提問：

text
這個項目是做什麼的？主要用了哪些技術？入口文件在哪？

Claude 會自己去讀需要的文件，不用你手動粘貼代碼。

然後給一個小而具體的修改任務，比如：

text
在 README 裏補一段「如何本地運行」的說明，命令從 package.json 裏找

它會找到要改的文件並展示改動。會不會先問你，取決於當前的權限模式：

• 官方文檔寫明，v2.1.283 及以後的版本，交互式終端預設進入 auto 模式：由一個分類器模型代替你審核操作，大多數改文件、跑命令的動作不再逐個詢問。
• 如果你的設定或組織另有規定，或者 auto 模式在當前會話不可用，就會以 Manual（手動）模式開始，改文件、跑命令前都會彈出確認，選 Yes 才會執行。剛安裝後的第一個會話起始模式也可能不同，以輸入框下方狀態欄顯示的模式為準。

圖片來源：Real Python

隨時按 Shift+Tab 可以在 auto、manual、accept edits（自動接受改文件）、plan（只讀規劃）之間切換。新手想每一步都自己把關，可以切到 manual 模式。

第 5 步：讓它記住項目規矩

在項目裏運行 /init，Claude 會分析代碼並生成一份 CLAUDE.md，裏面寫構建命令、測試方法、代碼風格。以後每次會話都會自動讀取它。只對你自己生效的偏好寫在 ~/.claude/CLAUDE.md。

第 6 步：養成三個好習慣

• 說具體：不要只說「修一下 bug」，而是「登入時輸錯密碼後頁面變成空白，幫我找原因並修復」。描述越具體，它找文件越準。
• 大任務拆小步：先建數據表，再寫接口，最後做頁面，每一步確認沒問題再進行下一步。
• 先探索後動手：複雜改動前先讓它「分析一下數據庫結構」「列出會受影響的文件」，看完方案再讓它改（也可以切到 plan 模式只出方案）。

這三條也是官方快速開始頁給新手的建議。用 Git 管理項目的話，還可以直接讓它「看看我改了哪些文件」「用合適的說明提交這些改動」。

常用命令速查

在終端裏（啟動前）：

在會話裏：

常見問題

Q：PowerShell 裏報 The token '&&' is not a valid statement separator？

你把 CMD 的命令貼進了 PowerShell。PowerShell 用 irm ... | iex 那條。反過來在 CMD 裏提示 'irm' is not recognized，就換用 CMD 那條。

Q：必須裝 Node.js 嗎？

原生安裝不需要。只有用 npm 安裝（npm install -g @anthropic-ai/claude-code）時才需要 Node.js，官方 setup 頁寫的是 22 及以上；版本偏舊時 npm 只會給出警告，裝好的程序本身並不依賴 Node.js 運行。官方明確不要加 sudo。

Q：免費帳號能用嗎？

不能。官方 setup 頁和定價頁都寫明：免費版 claude.ai 不包含 Claude Code，需要 Pro、Max、Team、Enterprise 或 Console 帳號。

Q：會不會亂改我的文件？

建議在 Git 倉庫裏使用，開始前先提交一次；改壞了可以用 /rewind 回退，或用 Git 還原。權限模式可以隨時用 Shift+Tab 或 /permissions 調整；不放心 auto 模式就切到 manual。

Q：不想用終端怎麼辦？

官方還提供桌面 App、VS Code / JetBrains 插件和網頁版（claude.ai/code），用同一個帳號登入即可；各入口支持的功能略有差異，以官方文檔對應頁面為準。

參考資料

• Claude Code 快速開始（官方）：https://code.claude.com/docs/en/quickstart
• 安裝、系統要求、更新與卸載（官方）：https://code.claude.com/docs/en/setup
• 登入與帳號類型（官方）：https://code.claude.com/docs/en/authentication
• 權限模式（官方）：https://code.claude.com/docs/en/permission-modes
• 命令參考（官方）：https://code.claude.com/docs/en/commands
• CLI 參考（官方）：https://code.claude.com/docs/en/cli-reference
• CLAUDE.md 與記憶（官方）：https://code.claude.com/docs/en/memory
• 套餐對比（官方）：https://claude.com/pricing
• 支持的國家和地區（官方）：https://www.anthropic.com/supported-countries
• 安裝與登入截圖：Analytics Vidhya《How to Install Claude Code》、Real Python《How to Use Claude Code》