跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

​
開始前

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

​
步驟 1：安裝 Claude Code

To install Claude Code, use one of the following methods: You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine.

​
步驟 2：登入您的帳戶

Claude Code 需要帳戶才能使用。當您使用 claude 命令啟動互動式工作階段時，您需要登入： 
claude
# 首次使用時系統會提示您登入

/login
# 按照提示使用您的帳戶登入
您可以使用以下任何帳戶類型登入： 登入後，您的認證將被儲存，您無需再次登入。若要稍後切換帳戶，請使用 /login 命令。

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

在任何專案目錄中開啟您的終端並啟動 Claude Code： 
cd /path/to/your/project
claude
您將看到 Claude Code 歡迎畫面，其中包含您的工作階段資訊、最近的對話和最新更新。輸入 /help 以查看可用命令，或輸入 /resume 以繼續之前的對話。
登入後（步驟 2），您的認證將儲存在您的系統上。在認證管理中了解更多。

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

讓我們從了解您的程式碼庫開始。嘗試以下命令之一： 
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?
Claude Code 會根據需要讀取您的專案檔案。您無需手動新增內容。

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

現在讓我們讓 Claude Code 進行一些實際的編碼。嘗試一個簡單的任務： 
add a hello world function to the main file
Claude Code 將：
  1. 找到適當的檔案
  2. 向您顯示建議的變更
  3. 要求您的批准
  4. 進行編輯
Claude Code 在修改檔案前始終要求許可。您可以批准個別變更或為工作階段啟用「全部接受」模式。

​
步驟 6：使用 Git 與 Claude Code

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

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

Claude 擅長除錯和功能實現。 用自然語言描述您想要的內容： 
add input validation to the user registration form
或修復現有問題： 
there's a bug where users can submit empty forms - fix it
Claude Code 將：
  • 定位相關程式碼
  • 理解上下文
  • 實現解決方案
  • 如果可用，執行測試

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

有許多方式可以與 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
像與有幫助的同事交談一樣與 Claude 交談。描述您想要達成的目標，它將幫助您實現。

​
基本命令

以下是日常使用中最重要的命令：
命令功能範例
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
/clear清除對話歷史/clear
/help顯示可用命令/help
exit 或 Ctrl+D退出 Claude Codeexit
請參閱 CLI 參考以取得完整的命令清單。

​
初學者的專業提示

如需更多資訊，請參閱最佳實踐和常見工作流程。
不要這樣做：“修復錯誤”試試這樣：“修復登入錯誤，使用者輸入錯誤認證後看到空白畫面”
將複雜任務分解為步驟：
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 了解您的程式碼：
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、skills、hooks、MCP 等進行自訂

​
獲取幫助

  • 在 Claude Code 中：輸入 /help 或詢問「how do I…」
  • 文件：您在這裡！瀏覽其他指南
  • 社群：加入我們的 Discord 以獲取提示和支援