Claude Code 新手上路:第一次使用就上手

上一篇文章中,我們介紹了 Claude Code 的定位、功能與安裝方式。現在你已經成功安裝了 Claude Code,接下來就讓我們實際動手操作,從啟動指令、對話介面、到讀取檔案與編輯程式碼,帶你一步步熟悉 Claude Code 的核心操作流程。

啟動 Claude Code(Starting Claude Code)

安裝完成後,開啟終端機並進入你的專案目錄,然後執行以下指令啟動 Claude Code:

cd your-project
claude

第一次啟動時,Claude Code 會引導你進行身份驗證。你可以選擇以下其中一種方式登入:

  • Claude 訂閱帳號:如果你有 Claude Pro 或 Max 訂閱,直接使用你的 Claude 帳號登入即可
  • Anthropic Console API Key:如果你使用 API 存取,需要在 Anthropic Console 中取得 API Key
  • 第三方雲端供應商:支援 Amazon Bedrock、Google Vertex AI、Microsoft Foundry 等企業雲端平台

登入完成後,你會看到 Claude Code 的歡迎畫面,包含工作階段資訊、最近的對話記錄和最新更新。輸入 /help 可以查看所有可用指令,輸入 /resume 可以繼續之前的對話。

對話介面操作(Conversation Interface)

Claude Code 的操作方式就像與一位資深工程師對話。你用自然語言描述你想做的事情,Claude 會分析、規劃並執行。整個互動過程分為三個階段:蒐集上下文採取行動驗證結果

基本對話方式

你可以直接用中文或英文與 Claude 對話,以下是幾個常見的使用方式:

# 詢問專案相關問題
這個專案是做什麼的?

# 請 Claude 分析程式碼
解釋一下 src/auth/ 目錄下的程式碼架構

# 請 Claude 執行任務
幫我寫一個 hello world 函式加到主檔案中

# 請 Claude 處理 Git
把我的修改用有意義的訊息提交

Claude Code 是對話式的,你不需要一次就給出完美的指令。可以先描述你想要的效果,然後根據 Claude 的回應逐步調整方向:

# 第一步:描述問題
登入功能有 Bug

# Claude 調查後,你可以進一步補充
問題出在 session 處理的部分

# Claude 調整方向後繼續處理

中斷與引導 Claude

如果 Claude 正在處理的方向不對,你可以隨時打斷它。只要輸入你的修正指示並按下 Enter,Claude 就會停下來並根據你的新指示調整方向,不需要等它完成或重新開始。

讀取檔案與理解程式碼(Reading Files)

當你在專案目錄中啟動 Claude Code 時,它可以存取整個專案的檔案結構。這意味著你可以直接詢問關於程式碼的問題,Claude 會自動讀取相關檔案來回答你:

# 了解專案結構
解釋一下這個專案的資料夾結構

# 分析特定檔案
讀取 src/utils/helpers.js 並解釋它的功能

# 追蹤問題
找出所有使用到 deprecated API 的地方

# 搜尋程式碼
搜尋所有包含 TODO 的註解

Claude Code 內建了強大的搜尋工具,包含依照檔名模式搜尋(Glob)和依照內容搜尋(Grep),它會根據你的需求自動選擇最適合的工具。

編輯程式碼(Editing Code)

Claude Code 最強大的功能之一就是直接編輯你的程式碼。當你要求 Claude 修改或新增程式碼時,它會經歷以下流程:

  1. 找到相關檔案:Claude 會搜尋並讀取需要修改的檔案
  2. 顯示變更預覽:在修改前,Claude 會向你展示即將做出的變更
  3. 等待你的核准:你可以選擇接受或拒絕變更
  4. 執行修改:獲得核准後,Claude 會實際修改檔案

以下是一些實際的編輯操作範例:

# 新增功能
在 user model 中加入 email 驗證的功能

# 修復 Bug
登入表單有一個 Bug,使用者可以提交空白表單,請修復它

# 重構程式碼
把 authentication 模組從 callbacks 改成 async/await

# 寫測試
幫 calculator 的所有函式寫單元測試

每次修改檔案前,Claude Code 都會自動建立快照(Checkpoint)。如果修改結果不理想,你可以按兩次 Esc 鍵回到之前的狀態,或是直接要求 Claude 復原修改。

執行終端機指令(Running Commands)

Claude Code 不只能編輯程式碼,還能直接執行終端機指令。這包括建置專案、執行測試、管理套件、操作 Git 等任何你在命令列中能做的事情:

# 執行測試
執行所有測試,並修復失敗的部分

# 建置專案
幫我 build 這個專案

# 安裝套件
安裝 axios 這個套件

# Git 操作
建立一個叫 feature/user-profile 的新分支

當 Claude 需要執行可能影響外部系統的指令時(例如部署、推送到遠端等),它會特別謹慎地先徵求你的同意。

權限管理(Permission System)

Claude Code 內建了完整的權限管理機制,確保它不會在未經你同意的情況下執行危險操作。這是 Claude Code 與其他 AI 工具的重要差異之一:你始終掌握最終控制權。

權限模式切換

按下 Shift+Tab 可以在不同的權限模式之間切換:

模式說明適用場景
Default(預設)檔案編輯和終端機指令都需要核准一般使用,最安全
Auto-accept edits自動接受檔案編輯,終端機指令仍需核准信任 Claude 的程式碼修改
Plan modeClaude 只使用唯讀工具,建立計畫供你審核複雜任務的規劃階段
Auto modeClaude 自動評估並執行所有操作高度信任的環境(研究預覽中)

允許與拒絕操作

在預設模式下,每當 Claude 要修改檔案或執行指令時,都會先詢問你的同意。你有以下選擇:

  • 允許(Allow):核准這次操作
  • 拒絕(Deny):拒絕這次操作,Claude 會嘗試其他方式
  • 全部接受(Accept All):在目前的工作階段中自動接受後續所有操作

你也可以在設定檔 .claude/settings.json 中預先允許特定指令,這樣 Claude 在執行這些指令時就不需要每次都詢問。常見的設定如允許 npm testgit status 等安全指令:

// .claude/settings.json
{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(git status)",
      "Bash(git diff)",
      "Bash(npx tsc --noEmit)"
    ]
  }
}

提問技巧(Tips for Effective Prompting)

想要從 Claude Code 獲得最好的結果,掌握正確的提問技巧非常重要。以下是一些實用的建議:

1. 盡量具體明確

越精確的指令,Claude 就越能在第一次就給出正確的結果。指定具體的檔案路徑、提到限制條件、並指出可以參考的範例:

# 不夠具體
修復那個 Bug

# 具體明確
結帳流程在信用卡過期的使用者上壞掉了。
請檢查 src/payments/ 目錄,特別是 token refresh 的部分。
先寫一個失敗的測試,再修復它。

2. 複雜任務分步驟描述

遇到複雜任務時,把它拆解成多個步驟會讓 Claude 更容易理解你的意圖:

1. 建立一個新的資料庫表格用於使用者個人資料
2. 建立 API 端點來取得和更新使用者個人資料
3. 建立一個網頁讓使用者可以查看和編輯他們的資料

3. 先探索再實作

對於複雜的問題,建議先讓 Claude 了解程式碼再動手修改。你可以使用 Plan mode(按 Shift+Tab 兩次)來讓 Claude 先分析:

# 先分析
讀取 src/auth/ 並了解我們如何處理 session。
然後建立一個加入 OAuth 支援的計畫。

# 確認計畫沒問題後,再讓 Claude 實作
好的,請按照這個計畫來實作。

4. 提供可驗證的測試案例

當 Claude 可以自行驗證結果時,表現會更好。提供測試案例或預期的輸出結果:

實作 validateEmail 函式。
測試案例:
- 'user@example.com' → true
- 'invalid' → false  
- 'user@.com' → false
實作完成後請執行測試。

常用指令速查表

以下是 Claude Code 日常使用中最重要的指令整理:

指令功能說明使用範例
claude啟動互動模式claude
claude "任務"執行一次性任務claude "修復 build 錯誤"
claude -p "查詢"執行查詢後立即退出claude -p "解釋這個函式"
claude -c繼續目前目錄中最近的對話claude -c
claude -r恢復之前的對話claude -r
/clear清除對話記錄在對話中輸入 /clear
/help顯示所有可用指令在對話中輸入 /help
/model切換使用的模型在對話中輸入 /model
exitCtrl+D退出 Claude Code輸入 exit

實用快捷鍵

熟悉以下快捷鍵可以讓你的操作更加順暢:

快捷鍵功能
?顯示所有可用的快捷鍵
Tab指令自動補全
瀏覽指令歷史記錄
/顯示所有指令和 Skills
Esc(按兩次)回到上一個 Checkpoint(復原修改)
Shift+Tab切換權限模式
Ctrl+D退出 Claude Code

選擇適合的模型

Claude Code 支援多種模型,你可以根據任務的複雜度選擇最適合的模型。在對話中輸入 /model 即可切換,或在啟動時使用 claude --model <name> 指定:

模型適用場景特點
Sonnet 4.6日常開發任務速度快、效能好、成本較低
Opus 4.6複雜的多檔案重構、架構決策更強的推理能力,適合困難問題

大多數情況下使用預設的 Sonnet 就很足夠了。當你遇到特別複雜的問題、需要跨多個檔案的架構重構,或是需要深度推理的任務時,可以考慮切換到 Opus。

常見工作流程示範

以下是一些你在日常開發中會經常用到的工作流程:

Code Review

# 讓 Claude 審查你的修改
審查我的修改並提出改進建議

# 或是針對特定檔案
審查 src/api/users.js 的程式碼品質

Debug 除錯

# 貼上錯誤訊息讓 Claude 幫你除錯
TypeError: Cannot read property 'name' of undefined
在 src/components/UserProfile.jsx 第 42 行

# 或是描述問題的現象
使用者登入後會看到空白頁面,請幫我找出問題

Git 操作

# 查看變更
我修改了哪些檔案?

# 提交
用有描述性的訊息提交我的修改

# 建立分支
建立一個叫 feature/user-settings 的新分支

# 解決衝突
幫我解決 merge conflict

總結

經過這篇教學,你已經學會了 Claude Code 的核心操作方式。從啟動對話、讀取與編輯程式碼、執行終端機指令,到權限管理和提問技巧,這些都是你每天使用 Claude Code 時會頻繁用到的功能。

記住,Claude Code 就像一位經驗豐富的同事:你用自然語言描述你想要的結果,它會幫你規劃和執行。不需要死記硬背指令,有問題直接問 Claude 就好。隨著使用經驗的累積,你會越來越熟練地運用這些功能來加速你的開發效率。

下一篇文章我們將介紹 CLAUDE.md 專案記憶,教你如何讓 Claude 記住你的專案規範和編碼風格,進一步提升開發體驗。

延伸閱讀