Skip to main content
本快速入門指南將在幾分鐘內讓您使用 AI 驅動的編碼協助。完成後，您將了解如何使用 Claude Code 進行常見的開發任務。

​
開始前

確保您擁有：
本指南涵蓋終端 CLI。Claude Code 也可在網頁、桌面應用程式、VS Code 和 JetBrains IDE、Slack 中使用，以及透過 GitHub Actions 和 GitLab 進行 CI/CD。請參閱所有介面。

​
步驟 1：安裝 Claude Code

若要安裝 Claude Code，請使用下列其中一種方法：
macOS、Linux、WSL：
Windows PowerShell：
Windows CMD：
如果您看到 The token '&&' is not a valid statement separator，表示您在 PowerShell 中，而非 CMD。如果您看到 'irm' is not recognized as an internal or external command，表示您在 CMD 中，而非 PowerShell。當您在 PowerShell 中時，提示符會顯示 PS C:\，而在 CMD 中時會顯示 C:\（不含 PS）。如果安裝命令失敗並出現 syntax error near unexpected token '<'、403 或其他 curl 錯誤，請參閱疑難排解安裝以將錯誤與修正相對應，並查看替代安裝方法。建議在原生 Windows 上安裝 Git for Windows，以便 Claude Code 可以使用 Bash 工具。如果未安裝 Git for Windows，Claude Code 會改用 PowerShell 作為殼層工具。WSL 設定不需要 Git for Windows。
原生安裝會在背景自動更新，以保持您使用最新版本。
您也可以在 Debian、Fedora、RHEL 和 Alpine 上使用 apt、dnf 或 apk 進行安裝。 若要確認安裝成功，請執行：
此命令會列印版本號碼，後面跟著 (Claude Code)。

​
步驟 2：登入您的帳戶

Claude Code 需要帳戶才能使用。使用 claude 命令啟動互動式工作階段，首次使用時系統會提示您登入：
對於 Claude 訂閱或 Console 帳戶，請按照提示在瀏覽器中完成驗證。如果您已設定 ANTHROPIC_API_KEY 環境變數，Claude Code 會略過登入提示，改為要求您核准該金鑰。若要稍後切換帳戶或重新驗證，請在執行中的工作階段內輸入 /login：
您可以使用以下任何帳戶類型登入： 登入後，您的認證將被儲存，您無需再次登入。深入瞭解 認證管理。

​
步驟 3：啟動您的第一個工作階段

在任何專案目錄中開啟您的終端並啟動 Claude Code：
將 /path/to/your/project 替換為您要處理的專案路徑。 您將看到 Claude Code 提示，其中顯示版本、目前的模型和工作目錄。輸入 /help 以查看可用命令，或輸入 /resume 以繼續之前的對話。

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

讓我們從了解您的程式碼庫開始。嘗試以下命令之一：
Claude 將分析您的檔案並提供摘要。您也可以提出更具體的問題：
您也可以詢問 Claude 其自身的功能：
Claude Code 會根據需要讀取您的專案檔案。您無需手動新增內容。

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

現在讓我們讓 Claude Code 進行一些實際的編碼。嘗試一個簡單的任務：
Claude Code 找到適當的檔案並向您顯示變更。如果它在進行變更前詢問，請選擇 是 以批准。 Auto mode 是 內建的起始權限模式，適用於 Pro、Max 和 Team 方案上的互動式終端工作階段：分類器會檢查動作而不是由您檢查，Claude 可以在不詢問的情況下編輯大多數檔案並執行大多數命令。在其他方案上，Manual mode 是內建的起始權限模式。對於您安裝後立即開始的工作階段，請參閱 安裝或升級後的第一個工作階段。
您的設定或您的組織可以設定不同的起始權限模式。工作階段開始時的權限模式 列出了相關內容。隨時按 Shift+Tab 以切換您所在工作階段的權限模式。

​
步驟 6：使用 Git 與 Claude Code

Claude Code 使 Git 操作變得對話式：
您也可以提示進行更複雜的 Git 操作：

​
步驟 7：修復錯誤或新增功能

Claude 擅長除錯和功能實現。 用自然語言描述您想要的內容：
或修復現有問題：
Claude Code 將：
  • 定位相關程式碼
  • 理解上下文
  • 實現解決方案
  • 如果可用，執行測試

​
步驟 8：測試其他常見工作流程

有許多方式可以與 Claude 合作： 重構程式碼
編寫測試
更新文件
程式碼審查
像與有幫助的同事交談一樣與 Claude 交談。描述您想要達成的目標，它將幫助您實現。

​
基本命令

以下是日常使用中最重要的命令。Shell 命令從您的終端機執行以啟動或繼續 Claude Code。工作階段命令在 Claude Code 啟動後在其內部執行。 Shell 命令 工作階段命令 請參閱 CLI 參考以取得完整的 shell 命令清單，以及 命令參考以取得完整的工作階段命令清單。

​
初學者的專業提示

如需更多資訊，請參閱最佳實踐和常見工作流程。
不要這樣做：“修復錯誤”試試這樣：“修復登入錯誤，使用者輸入錯誤認證後看到空白畫面”
將複雜任務分解為步驟：
在進行變更之前，讓 Claude 了解您的程式碼：
  • 輸入 / 查看所有命令和 skills
  • 使用 Tab 進行命令完成
  • 按 ↑ 查看命令歷史
  • 按 Shift+Tab 循環切換權限模式

​
接下來呢？

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

Claude Code 如何運作

了解代理迴圈、內建工具以及 Claude Code 如何與您的專案互動

最佳實踐

透過有效的提示和專案設定獲得更好的結果

常見工作流程

常見任務的逐步指南

擴展 Claude Code

使用 CLAUDE.md、skills、hooks、MCP 等進行自訂

​
獲取幫助

  • 在 Claude Code 中：輸入 /help 或詢問「how do I」問題
  • 文件：您在這裡！瀏覽其他指南
  • 課程：參加 Claude Code 101 和其他免費自學課程，位於 Claude Academy
  • 社群：加入我們的 Discord 以獲取提示和支援