快速入門

在終端機中安裝 Claude Code、登入，並使用 CLI 探索您的程式碼庫及進行第一次程式碼變更。

本快速入門介紹在終端機中使用 Claude Code：安裝 CLI、從第一個工作階段登入，以及在您自己的專案中將其用於常見的開發任務。

開始前

確保您擁有：

已開啟的終端機或命令提示字元
一個可以使用的程式碼專案
一個 Claude 訂閱（Pro、Max、Team 或 Enterprise）、Claude Console 帳戶，或透過支援的雲端提供商存取

步驟 1：安裝 Claude Code

若要安裝 Claude Code，請開啟終端機並執行適用於您系統的命令。如果您之前未使用過終端機，終端機指南會說明如何開啟終端機並貼上命令。

macOS、Linux、WSL：

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

在 Windows 上，當您在 PowerShell 中時，提示字元會顯示 PS C:\，而在 CMD 中時會顯示 C:\（不含 PS）。

Windows PowerShell：

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

Windows CMD：

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

安裝命令在下載 Claude Code 時不會顯示進度。當安裝程式完成時，請開啟新的終端機視窗並執行 claude --version。正常的安裝會列印版本號碼。如果您的 shell 說找不到 claude 或無法識別，安裝目錄還未在您的 PATH 上：請參閱修正您的 PATH。

如果您看到 The token '&&' is not a valid statement separator，表示您在 PowerShell 中，而非 CMD。如果您看到 'irm' is not recognized as an internal or external command，表示您在 CMD 中，而非 PowerShell。

如果安裝命令失敗並出現 syntax error near unexpected token '<'、403 或其他任何錯誤，請參閱疑難排解安裝以將錯誤與修正相對應，並查看替代安裝方法。

建議在原生 Windows 上安裝 Git for Windows，以便 Claude Code 可以使用 Bash 工具。如果未安裝 Git for Windows，Claude Code 會改用 PowerShell 作為殼層工具。WSL 設定不需要 Git for Windows。

brew install --cask claude-code

Homebrew 提供兩個 casks。claude-code 追蹤穩定版本通道，通常比最新版本晚約一週，並跳過有重大迴歸的版本。claude-code@latest 追蹤最新通道，並在新版本發佈時立即接收。

winget install Anthropic.ClaudeCode

您也可以在 Debian、Fedora、RHEL 和 Alpine 上使用 apt、dnf 或 apk 進行安裝。

若要確認安裝成功，請執行：

claude --version

此命令會列印版本號碼，後面跟著 (Claude Code)。

步驟 2：開始您的第一個工作階段

在任何專案目錄中開啟終端機，然後啟動 Claude Code：

cd /path/to/your/project
claude

將 /path/to/your/project 替換為您要處理的專案路徑。

Claude Code 會在首次使用時提示您登入。若使用 Claude 訂閱或 Console 帳戶，請依照提示在瀏覽器中完成身分驗證。如果您已設定 ANTHROPIC_API_KEY 環境變數，且在 Claude Code 詢問是否使用該金鑰時予以核准，Claude Code 便會略過登入提示。

您可以使用下列任一種帳戶類型登入：

Claude Pro、Max、Team 或 Enterprise（建議）
Claude Console（使用預付額度的 API 存取）。首次登入時，系統會自動在 Console 中建立一個「Claude Code」工作區，以便集中追蹤費用。
Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry（企業雲端供應商）
自行託管的 Claude apps 閘道（如果您的組織有執行的話）：您的管理員會預先設定閘道 URL，而 /login 會直接開啟 Cloud gateway 畫面，供您使用企業 SSO 登入

登入後，您的憑證會被儲存，之後不需要再次登入。如需了解更多資訊，請參閱憑證管理。

Claude Code 提示字元會出現，其上方會顯示版本、目前的模型及工作目錄。輸入 /help 以查看可用的命令，或輸入 /resume 以繼續先前的對話。若之後要切換帳戶或重新進行身分驗證，請在執行中的工作階段內輸入 /login。

步驟 3：提出您的第一個問題

試試以下其中一個命令：

what does this project do?

Claude 將分析您的檔案並提供摘要。您也可以提出更具體的問題：

what technologies does this project use?

where is the main entry point?

explain the folder structure

您也可以詢問 Claude 關於其自身功能的問題：

what can Claude Code do?

how do I create custom skills in Claude Code?

can Claude Code work with Docker?

步驟 4：進行您的第一次程式碼變更

試試一個小任務：

add a hello world function to the main file

Claude Code 會找到適當的檔案並向您顯示變更內容。如果它在進行變更前詢問，請選擇 Yes 以核准。

工作階段的權限模式決定了 Claude 可以在不先詢問您的情況下執行哪些動作。隨時按下 Shift+Tab 即可切換您目前所在工作階段的權限模式。

步驟 5：搭配 Claude Code 使用 Git

Claude Code 讓 Git 操作變得像對話一樣自然：

what files have I changed?

commit my changes with a descriptive message

您也可以透過提示詞執行更複雜的 Git 操作：

create a new branch called feature/quickstart

show me the last 5 commits

help me resolve merge conflicts

步驟 6：修正錯誤或新增功能

以自然語言描述您想要的內容：

add input validation to the user registration form

或修正現有問題：

there's a bug where users can submit empty forms - fix it

步驟 7：試用其他常見工作流程

再試試幾個提示詞。您可以請 Claude 重構程式碼、撰寫測試、更新文件，或審查您的變更：

refactor the authentication module to use async/await instead of callbacks

write unit tests for the calculator functions

update the README with installation instructions

review my changes and suggest improvements

基本命令

以下是日常使用中最重要的命令，依執行位置分組。

Shell 命令

從您的終端機執行這些命令以啟動或繼續 Claude Code。

命令	功能	範例
`claude`	啟動互動模式	`claude`
`claude "task"`	使用初始提示啟動互動模式	`claude "fix the build error"`
`claude -p "query"`	執行一次性查詢，然後退出	`claude -p "explain this function"`
`claude -c`	在目前目錄中繼續最近的對話	`claude -c`
`claude -r`	恢復之前的對話	`claude -r`

請參閱 CLI 參考以取得完整的 shell 命令清單。

工作階段命令

在 Claude Code 啟動後於其內部執行這些命令。

命令	功能	範例
`/clear`	清除對話歷史	`/clear`
`/help`	顯示可用命令	`/help`
`/exit` 或 Ctrl+D 兩次	退出 Claude Code	`/exit`

請參閱命令參考以取得完整的工作階段命令清單。

初學者的專業提示

如需更多資訊，請參閱最佳實踐和常見工作流程。

不要這樣做："修復錯誤"

試試這樣："修復登入錯誤，使用者輸入錯誤認證後看到空白畫面"

使用逐步說明

將複雜任務分解為步驟：

1. create a new database table for user profiles
2. create an API endpoint to get and update user profiles
3. build a webpage that allows users to see and edit their information

讓 Claude 先探索

在進行變更之前，讓 Claude 了解您的程式碼：

analyze the database schema

build a dashboard showing products that are most frequently returned by our UK customers

使用快捷方式節省時間

輸入 / 查看所有命令和 skills
使用 Tab 進行命令完成
按 ↑ 查看命令歷史
按 Shift+Tab 循環切換權限模式

接下來呢？

現在您已經學習了基礎知識，請探索更多進階功能：

Claude Code 如何運作：了解代理式迴圈、內建工具以及 Claude Code 如何與您的專案互動
最佳實踐：透過有效的提示和專案設定獲得更好的結果
常見工作流程：常見任務的逐步指南
擴展 Claude Code：使用 CLAUDE.md、skill、hook、MCP 等進行自訂

請參閱進階設定以了解安裝選項、手動更新或解除安裝說明。

獲取幫助

在 Claude Code 中：輸入 /help 或詢問「how do I」問題
文件：瀏覽本網站上的其他指南
課程：參加 Claude Code 101 和其他免費自學課程，位於 Claude Academy
社群：加入 Discord 伺服器以獲取提示和支援

quickstart.md +16 −14

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

54 ```54 ```

55 55

56 當安裝程式完成時，請開啟新的終端機視窗並執行 `claude --version`。正常的安裝會列印版本號碼。如果您的殼層說找不到 `claude` 或無法識別，安裝目錄還未在您的 PATH 上：請參閱[修正您的 PATH](/docs/zh-TW/troubleshoot-install#command-not-found-claude-after-installation)。56 安裝命令在下載 Claude Code 時不會顯示進度。當安裝程式完成時，請開啟新的終端機視窗並執行 `claude --version`。正常的安裝會列印版本號碼。如果您的 shell 說找不到 `claude` 或無法識別，安裝目錄還未在您的 PATH 上：請參閱[修正您的 PATH](/docs/zh-TW/troubleshoot-install#command-not-found-claude-after-installation)。

57 57

58 如果您看到 `The token '&&' is not a valid statement separator`，表示您在 PowerShell 中，而非 CMD。如果您看到 `'irm' is not recognized as an internal or external command`，表示您在 CMD 中，而非 PowerShell。58 如果您看到 `The token '&&' is not a valid statement separator`，表示您在 PowerShell 中，而非 CMD。如果您看到 `'irm' is not recognized as an internal or external command`，表示您在 CMD 中，而非 PowerShell。

59 59

229 步驟 7：試用其他常見工作流程229 步驟 7：試用其他常見工作流程

230</h2>230</h2>

231 231

232與 Claude 協作的方式有很多種：232再試試幾個提示詞。您可以請 Claude 重構程式碼、撰寫測試、更新文件，或審查您的變更：

~~233~~

234**重構程式碼**

235 233

236```text wrap theme={null}234```text wrap theme={null}

237refactor the authentication module to use async/await instead of callbacks235refactor the authentication module to use async/await instead of callbacks

238```236```

239 237

240**撰寫測試**

~~241~~

242```text wrap theme={null}238```text wrap theme={null}

243write unit tests for the calculator functions239write unit tests for the calculator functions

244```240```

245 241

246**更新文件**

~~247~~

248```text wrap theme={null}242```text wrap theme={null}

249update the README with installation instructions243update the README with installation instructions

250```244```

251 245

252**程式碼審查**

~~253~~

254```text wrap theme={null}246```text wrap theme={null}

255review my changes and suggest improvements247review my changes and suggest improvements

256```248```

263 基本命令255 基本命令

264</h2>256</h2>

265 257

266以下是日常使用中最重要的命令。Shell 命令從您的終端機執行以啟動或繼續 Claude Code。工作階段命令在 Claude Code 啟動後在其內部執行。258以下是日常使用中最重要的命令，依執行位置分組。

267 259

268**Shell 命令**260<h3 id="shell-commands">

261 Shell 命令

262</h3>

263

264從您的終端機執行這些命令以啟動或繼續 Claude Code。

269 265

270| 命令 | 功能 | 範例 |266| 命令 | 功能 | 範例 |

271| - | - | - |267| - | - | - |

277 273

278**工作階段命令**274請參閱 [CLI 參考](/docs/zh-TW/cli-reference)以取得完整的 shell 命令清單。

275

276<h3 id="session-commands">

277 工作階段命令

278</h3>

279

280在 Claude Code 啟動後於其內部執行這些命令。

279 281

280| 命令 | 功能 | 範例 |282| 命令 | 功能 | 範例 |

281| - | - | - |283| - | - | - |

285 287

286請參閱 [CLI 參考](/docs/zh-TW/cli-reference)以取得完整的 shell 命令清單，以及 [命令參考](/docs/zh-TW/commands)以取得完整的工作階段命令清單。288請參閱 [命令參考](/docs/zh-TW/commands)以取得完整的工作階段命令清單。

287 289

288<h2 id="pro-tips-for-beginners">290<h2 id="pro-tips-for-beginners">

289 初學者的專業提示291 初學者的專業提示

quickstart.md 2026-10-07 23:59 UTC to 2026-10-08 13:02 UTC

快速入門

開始前

步驟 1：安裝 Claude Code

步驟 2：開始您的第一個工作階段

步驟 3：提出您的第一個問題

步驟 4：進行您的第一次程式碼變更

步驟 5：搭配 Claude Code 使用 Git

步驟 6：修正錯誤或新增功能

步驟 7：試用其他常見工作流程

基本命令

Shell 命令

工作階段命令

初學者的專業提示

接下來呢？

獲取幫助