Skip to main content

第 2 課:基本操作

學習目標

完成本課程後,您將能夠:

  • 在聊天模式中與 Claude 有效溝通
  • 要求 Claude 讀取和分析檔案
  • 請求編輯現有檔案
  • 理解權限的運作方式
  • 使用基本指令旗標(-p-c-r
  • 正確地退出工作階段

先決條件

  • 完成第 1 課 - 您應該已安裝並驗證 Claude Code
  • 程式碼編輯器 - 與 Claude Code 並排查看檔案
  • 終端機存取 - 用於執行 Claude Code 指令

預估時間: 25 分鐘


聊天模式基礎

聊天模式是您與 Claude Code 互動的主要方式。這是一個對話式介面,您描述您想要的內容,Claude 會協助您完成。

聊天模式的運作方式

  1. 您輸入訊息描述您的需求

  2. Claude 回應包含:

    • 澄清您請求的問題
    • 程式碼或概念的說明
    • 建議的變更(使用工具)
    • 問題的直接答案
  3. 工具執行當 Claude 需要:

    • 讀取檔案
    • 編輯檔案
    • 建立新檔案
    • 執行指令

對話流程

您 → [請求]

Claude ← [回應 + 工具使用]

您 ← [確認權限]

系統 → [執行工具]

您 ← [查看結果]

[繼續對話]

讀取檔案

Claude 最強大的功能之一是讀取和理解您的程式碼。

要求 Claude 讀取檔案

只需要求 Claude 讀取檔案:

您> 能否讀取 src/main.py 檔案並解釋它的功能?

Claude 將會:

  1. 請求權限以讀取檔案
  2. 顯示請求說明將存取哪個檔案
  3. 等待您的核准
  4. 在您核准後讀取和分析檔案

權限請求範例

當 Claude 要求讀取檔案時,您會看到:

📖 讀取 src/main.py

這將讀取檔案內容。是否繼續?[Y/n]

選項:

  • YEnter - 允許此操作
  • n - 拒絕此操作
  • Ctrl+C - 取消整個操作

讀取多個檔案

您可以要求 Claude 讀取多個檔案:

您> 讀取 src/ 目錄中的所有 Python 檔案

Claude 將會對每個檔案個別請求權限。

未明確請求時的讀取

Claude 也可能在以下情況下請求讀取檔案:

  • 您提出的問題需要檔案脈絡
  • 您參考了程式碼中的檔案
  • 您正在處理需要理解現有程式碼的工作

範例:

您> 如何為系統新增使用者?

Claude: [將請求讀取相關檔案以了解現有實作]

進行編輯

Claude 可以為您編輯檔案,但總是會先請求權限。

請求編輯

描述您想要的變更:

您> 更新 src/main.py 中的 greet 函式以包含時間戳記

Claude 將會:

  1. 讀取檔案(如果需要)
  2. 提出變更使用 Edit 工具
  3. 顯示確切差異說明將變更的內容
  4. 請求您的核准

編輯權限範例

✏️ 編輯 src/main.py

--- a/src/main.py
+++ b/src/main.py
@@ -1,3 +1,4 @@
def greet(name):
- return f"Hello, {name}!"
+ from datetime import datetime
+ return f"Hello, {name}! Time: {datetime.now()}"

套用此編輯?[Y/n]

建立新檔案

Claude 也可以建立新檔案:

您> 建立一個名為 utils.py 的新檔案,包含格式化日期的函式

Claude 將會:

  1. 顯示建議的檔案內容
  2. 請求權限以建立檔案
  3. 在指定位置建立檔案

理解權限

權限是 Claude Code 運作的核心。它們確保您保持對程式碼操作的控制。

為什麼需要權限

安全:

  • 防止意外變更
  • 在動作執行前掌握狀況
  • 管理測試

覺察:

  • 掌握正在發生的事情
  • 理解 Claude 正在做什麼
  • 學習工具操作

控制:

  • 您決定執行什麼
  • 您可以拒絕任何操作
  • 始終保持掌控

權限流程

每個工具使用都需要權限:

Claude 想要使用工具

系統顯示請求

您決定 │

執行工具(如果核准)

顯示結果

工具權限類型

工具權限提示功能
Read📖 讀取檔案查看檔案內容
Edit✏️ 編輯檔案修改現有檔案
Write📝 寫入檔案建立新檔案
Bash⚡ 執行指令執行終端機指令

回應權限請求

總是允許: Y 或按 Enter 從不: n 取消: Ctrl+C

專業提示: 您可以設定不同的權限模式(在第 4 課中說明)以自動核准某些類型的操作。


基本 CLI 旗標

Claude Code 支援多個命令列旗標用於不同用途。

單一提示模式(-p

執行單一提示並退出:

claude -p "列出目前目錄中的所有 Python 檔案"

使用案例:

  • 快速問題
  • 一次性工作
  • 腳本/自動化

範例:

claude -p "建立一個簡單的 HTTP 伺服器使用 Python"

指令模式(-c

使用 Claude 的協助執行 shell 指令:

claude -c "npm install"

Claude 將會:

  • 執行指令
  • 顯示輸出
  • 協助解讀任何錯誤
  • 如果出問題建議修正

使用案例:

  • 執行建置指令
  • 安裝相依性
  • 執行測試

讀取模式(-r

讓 Claude 讀取並處理檔案:

claude -r src/main.py -p "解釋這段程式碼"

這結合了檔案讀取與關於檔案的提示。

使用案例:

  • 程式碼審查
  • 文件產生
  • 快速分析

結合旗標

您可以結合旗標:

claude -r app.js -p "找出潛在的 bug 並建議修正"

正確地退出工作階段

正確退出工作階段可確保:

  • 工作階段歷史已儲存
  • 資源已釋放
  • 任何未完成的任務都已處理

方法:

  • 輸入 /exit
  • Ctrl+D
  • 輸入 exit

退出時儲存的內容

當您退出時:

  • 對話歷史會被儲存以供恢復
  • 未完成的任務會被記錄
  • 工作階段脈絡會被保留

您可以恢復之前的工作階段(在第 8 課中說明)。


實務範例:Hello World 專案

讓我們用一個簡單的專案來練習您學到的內容。

步驟 1:建立專案目錄

cd ~/claude-test
mkdir hello-world
cd hello-world

步驟 2:啟動 Claude Code

claude

步驟 3:建立 Python 腳本

您> 建立一個名為 hello.py 的 Python 腳本,將 "Hello, World!" 列印五次

預期流程:

  1. Claude 提議檔案內容
  2. 您核准 Write 操作
  3. 檔案已建立

步驟 4:讀取檔案

您> 讀取 hello.py 檔案並解釋每一行的功能

預期流程:

  1. Claude 請求權限以讀取
  2. 您核准
  3. Claude 解釋程式碼

步驟 5:進行編輯

您> 更新 hello.py,用數字(1、2、3、4、5)列印每一行

預期流程:

  1. Claude 提出編輯
  2. 您查看差異
  3. 您核准
  4. 檔案已更新

步驟 6:執行腳本

您> 使用 Bash 執行 hello.py 腳本

預期流程:

  1. Claude 請求執行 python hello.py
  2. 您核准
  3. 您看到輸出

步驟 7:退出

您> /exit

✅ 檢查您的理解

  1. 當您要求 Claude 讀取檔案時會發生什麼?

    • 它立即讀取
    • 它先請求權限
    • 它需要特殊旗標
    • 它無法讀取檔案
  2. 哪個旗標執行單一提示並退出?

    • -c
    • -p
    • -r
    • -s
  3. 如何正確退出 Claude Code 工作階段?

    • 關閉終端機視窗
    • 按 Ctrl+C
    • 輸入 /exit 或按 Ctrl+D
    • 直接關閉筆電
  4. **True 或 False:**Claude 可以在未經許可的情況下編輯檔案。

    • True
    • False
  5. -c 旗標做什麼?

    • 建立新檔案
    • 使用 Claude 的協助執行指令
    • 讀取檔案
    • 設定組態

答案: 1-b, 2-b, 3-c, 4-False, 5-b


總結

在本課程中,您學到了:

  • 聊天模式 - 與 Claude 對話的介面
  • 讀取檔案 - 要求 Claude 讀取,核准請求
  • 進行編輯 - 請求變更,審查差異,核准
  • 權限 - 每個工具使用都需要您的核准
  • CLI 旗標 - -p 用於單一提示,-c 用於指令,-r 用於讀取
  • 退出 - 使用 /exitCtrl+D 進行乾淨的關閉

下一步

在**第 3 課:使用您的程式庫**中,您將學到:

  • Claude 如何維護專案脈絡
  • 使用 Grep 和 Glob 搜尋檔案
  • 使用 @ 參照檔案路徑
  • 詢問關於程式碼的問題
  • 執行簡單的重構

進階閱讀


繼續至第 3 課:使用您的程式庫