目標:在大約 15 分鐘內,您將安裝 Claude Code、登入並完成您的第一個 AI 輔助變更。本指南僅涵蓋第一天所需的內容;更深入的資料連結位於末尾。
步驟 1:安裝 Claude Code(2 分鐘)
選擇與您的機器相符的命令,並將其貼到終端機中。
您的設定 | 命令 |
macOS / Linux / WSL | `curl -fsSL https://claude.ai/install.sh |
Windows (PowerShell) | |
Homebrew |
|
npm (Node 18+) |
|
提示:不要使用 sudo 執行 npm install,因為這會導致稍後出現檔案權限問題。
驗證安裝:
claude --version
步驟 2:登入(2 分鐘)
您的驗證方式取決於您的組織如何佈建存取權限。選擇以下其中一項:
如果您的組織使用… | 執行此操作 |
Claude Enterprise 席位 | 執行 |
Anthropic Console API 金鑰 | 執行 |
Amazon Bedrock | 執行 |
Google Vertex AI | 執行 |
如果您不確定適用哪種方法,請洽詢您的管理員或先嘗試 /login,這是大多數組織的預設值。
步驟 3:開啟專案(1 分鐘)
cd path/to/your/project claude
Claude Code 會按需讀取您的檔案,因此無需上傳或附加任何內容。只需從您想要處理的儲存庫內啟動它。
步驟 4:了解唯一的安全規則(1 分鐘)
Claude 將始終在變更檔案或執行命令前詢問。當它提出變更時,您將看到差異和三個選擇:
是 — 套用此單一變更。
是,且不再詢問編輯 — 在工作階段的其餘時間自動核准檔案編輯。
否 — 拒絕變更並說明原因。
您可以隨時按 Shift+Tab 在模式之間循環(計畫 → 接受編輯 → 預設)。如果變更產生意外結果,您的 git 歷史記錄在您提交之前保持不變,因此 git checkout 將撤銷它。
步驟 5:首先嘗試的五件事
將這些逐一複製並貼到提示中。每個範例都展示了不同的核心功能。
1. 了解方向
Give me a 5-bullet summary of what this codebase does and where the entry point is.
為什麼這很有用:它展示了 Claude 如何自行探索檔案,而無需指向特定路徑。
2. 尋找某些內容
Where is user authentication handled? Show me the file and the key function.
為什麼這很有用:當您不知道確切的符號或檔案名稱時,它通常比 grep 更快。
3. 進行安全編輯
Add a docstring to the function <name> in <file>. Keep it to 2 lines.
為什麼這很有用:它讓您練習檢查和核准低風險變更的差異。
4. 修復真實問題
This test is failing: <paste the error>. Find the cause and fix it.
為什麼這很有用:這是主要工作流程 — 您描述症狀,Claude 調查並提出修復。
5. 讓它處理 git
Stage my changes and write a commit message that follows our existing style.
為什麼這很有用:Claude 可以代表您執行 git(經過核准),並將符合您儲存庫的現有提交慣例。
步驟 6:在您結束今天的工作之前
每個專案執行一次:
/init
這會在您的專案根目錄生成一個 CLAUDE.md 檔案,該檔案捕捉您的程式碼庫的慣例。Claude 在每個工作階段開始時會自動讀取它,因此未來的回應將已針對您的專案進行量身定制。這是您可以採取的單一最高價值設定步驟。
後續步驟
您現在已安裝 Claude Code、進行驗證、進行編輯並設定專案記憶體。當您準備好進一步進行時,官方文件涵蓋 記憶體和 CLAUDE.md、斜線命令 和 互動模式快捷鍵 的深入內容。
如果您在安裝或登入期間遇到問題,請參閱 疑難排解指南。
