第 2 課:基本操作
學習目標
完成本課程後,您將能夠:
- 在聊天模式中與 Claude 有效溝通
- 要求 Claude 讀取和分析檔案
- 請求編輯現有檔案
- 理解權限的運作方式
- 使用基本指令旗標(
-p、-c、-r) - 正確地退出工作階段
先決條件
- 完成第 1 課 - 您應該已安裝並驗證 Claude Code
- 程式碼編輯器 - 與 Claude Code 並排查看檔案
- 終端機存取 - 用於執行 Claude Code 指令
預估時間: 25 分鐘
聊天模式基礎
聊天模式是您與 Claude Code 互動的主要方式。這是一個對話式介面,您描述您想要的內容,Claude 會協助您完成。
聊天模式的運作方式
-
您輸入訊息描述您的需求
-
Claude 回應包含:
- 澄清您請求的問題
- 程式碼或概念的說明
- 建議的變更(使用工具)
- 問題的直接答案
-
工具執行當 Claude 需要:
- 讀取檔案
- 編輯檔案
- 建立新檔案
- 執行指令
對話流程
您 → [請求]
↓
Claude ← [回應 + 工具使用]
↓
您 ← [確認權限]
↓
系統 → [執行工具]
↓
您 ← [查看結果]
↓
[繼續對話]
讀取檔案
Claude 最強大的功能之一是讀取和理解您的程式碼。
要求 Claude 讀取檔案
只需要求 Claude 讀取檔案:
您> 能否讀取 src/main.py 檔案並解釋它的功能?
Claude 將會:
- 請求權限以讀取檔案
- 顯示請求說明將存取哪個檔案
- 等待您的核准
- 在您核准後讀取和分析檔案
權限請求範例
當 Claude 要求讀取檔案時,您會看到:
📖 讀取 src/main.py
這將讀取檔案內容。是否繼續?[Y/n]
選項:
Y或Enter- 允許此操作n- 拒絕此操作Ctrl+C- 取消整個操作
讀取多個檔案
您可以要求 Claude 讀取多個檔案:
您> 讀取 src/ 目錄中的所有 Python 檔案
Claude 將會對每個檔案個別請求權限。
未明確請求時的讀取
Claude 也可能在以下情況下請求讀取檔案:
- 您提出的問題需要檔案脈絡
- 您參考了程式碼中的檔案
- 您正在處理需要理解現有程式碼的工作
範例:
您> 如何為系統新增使用者?
Claude: [將請求讀取相關檔案以了解現有實作]
進行編輯
Claude 可以為您編輯檔案,但總是會先請求權限。
請求編輯
描述您想要的變更:
您> 更新 src/main.py 中的 greet 函式以包含時間戳記
Claude 將會:
- 讀取檔案(如果需要)
- 提出變更使用 Edit 工具
- 顯示確切差異說明將變更的內容
- 請求您的核准
編輯權限範例
✏️ 編輯 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 將會:
- 顯示建議的檔案內容
- 請求權限以建立檔案
- 在指定位置建立檔案
理解權限
權限是 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!" 列印五次
預期流程:
- Claude 提議檔案內容
- 您核准 Write 操作
- 檔案已建立
步驟 4:讀取檔案
您> 讀取 hello.py 檔案並解釋每一行的功能
預期流程:
- Claude 請求權限以讀取
- 您核准
- Claude 解釋程式碼
步驟 5:進行編輯
您> 更新 hello.py,用數字(1、2、3、4、5)列印每一行
預期流程:
- Claude 提出編輯
- 您查看差異
- 您核准
- 檔案已更新
步驟 6:執行腳本
您> 使用 Bash 執行 hello.py 腳本
預期流程:
- Claude 請求執行
python hello.py - 您核准
- 您看到輸出
步驟 7:退出
您> /exit
✅ 檢查您的理解
-
當您要求 Claude 讀取檔案時會發生什麼?
- 它立即讀取
- 它先請求權限
- 它需要特殊旗標
- 它無法讀取檔案
-
哪個旗標執行單一提示並退出?
-
-c -
-p -
-r -
-s
-
-
如何正確退出 Claude Code 工作階段?
- 關閉終端機視窗
- 按 Ctrl+C
- 輸入
/exit或按 Ctrl+D - 直接關閉筆電
-
**True 或 False:**Claude 可以在未經許可的情況下編輯檔案。
- True
- False
-
-c旗標做什麼?- 建立新檔案
- 使用 Claude 的協助執行指令
- 讀取檔案
- 設定組態
答案: 1-b, 2-b, 3-c, 4-False, 5-b
總結
在本課程中,您學到了:
- 聊天模式 - 與 Claude 對話的介面
- 讀取檔案 - 要求 Claude 讀取,核准請求
- 進行編輯 - 請求變更,審查差異,核准
- 權限 - 每個工具使用都需要您的核准
- CLI 旗標 -
-p用於單一提示,-c用於指令,-r用於讀取 - 退出 - 使用
/exit或Ctrl+D進行乾淨的關閉
下一步
在**第 3 課:使用您的程式庫**中,您將學到:
- Claude 如何維護專案脈絡
- 使用 Grep 和 Glob 搜尋檔案
- 使用
@參照檔案路徑 - 詢問關於程式碼的問題
- 執行簡單的重構
進階閱讀
繼續至第 3 課:使用您的程式庫 →