跳至主要內容

您在 Claude Code 的第一天

今日已更新

目標:在大約 15 分鐘內,您將安裝 Claude Code、登入並完成您的第一個 AI 輔助變更。本指南僅涵蓋第一天所需的內容;更深入的資料連結位於末尾。


步驟 1:安裝 Claude Code(2 分鐘)

選擇與您的機器相符的命令,並將其貼到終端機中。

您的設定

命令

macOS / Linux / WSL

Windows (PowerShell)

Homebrew

brew install --cask claude-code

npm (Node 18+)

npm install -g @anthropic-ai/claude-code

提示:不要使用 sudo 執行 npm install,因為這會導致稍後出現檔案權限問題。

驗證安裝:

claude --version


步驟 2:登入(2 分鐘)

您的驗證方式取決於您的組織如何佈建存取權限。選擇以下其中一項:

如果您的組織使用…

執行此操作

Claude Enterprise 席位

執行 claude,然後執行 /login 並在瀏覽器中核准請求(如果出現提示,包括 SSO)。這是最常見的路徑。

Anthropic Console API 金鑰

執行 export ANTHROPIC_API_KEY=sk-ant-…,然後執行 claude

Amazon Bedrock

執行 export CLAUDE_CODE_USE_BEDROCK=1,設定您的 AWS 認證,然後執行 claude

Google Vertex AI

執行 export CLAUDE_CODE_USE_VERTEX=1,設定您的 GCP 認證,然後執行 claude

如果您不確定適用哪種方法,請洽詢您的管理員或先嘗試 /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斜線命令互動模式快捷鍵 的深入內容。

如果您在安裝或登入期間遇到問題,請參閱 疑難排解指南

是否回答了您的問題?