03 - 第一次使用與基本操作
← 02-安裝與登入 | 00-Index | 下一篇 → 04-互動介面與快捷鍵
開一個 session
cd /path/to/your/project
claude你會看到提示字元，上方顯示版本、目前模型、工作目錄。打 /help 看指令，/resume 接續之前的對話。
💡 一定要
cd到專案目錄再開。 Claude Code 讀CLAUDE.md是從目前工作目錄往上走，起始目錄錯了就讀不到專案規矩。
五個最常用的 shell 指令
| 指令 | 作用 |
|---|---|
claude | 開互動 session |
claude "任務" | 開 session 並帶一個起始 prompt |
claude -p "問題" | 跑一次就結束（不進互動介面） |
claude -c | 接續目前目錄最近一次對話 |
claude -r | 挑一個之前的 session 接續（也可 claude -r "名字"） |
三個最常用的 session 指令
| 指令 | 作用 |
|---|---|
/clear | 清空對話開新的（別名 /reset、/new） |
/help | 看有哪些指令 |
/exit | 離開（或連按兩次 Ctrl+D） |
第一次該問什麼
先讓它認識專案，再叫它動手。
what does this project do?
explain the folder structure
where is the main entry point?
它會自己讀檔案，你不用手動貼 context。
然後才試小改動：
add a hello world function to the main file
它會：找到適當的檔案 → 顯示提議的變更 → 依你的權限模式決定要不要問你 → 動手改。
Git 操作對話化
what files have I changed?
commit my changes with a descriptive message
create a new branch called feature/quickstart
help me resolve merge conflicts
⚠️ 在你的 vault 上要小心。
Obsidian-med-note有 obsidian-git 每 10 分鐘自動 commit/pull/push，而且CLAUDE.md§5 規定 push 前一定要git pull --rebase。別讓它自己隨便 commit——在CLAUDE.md裡把流程寫死，或用 plan mode 先看它要做什麼。
Prompt 心法（官方版 + 實務補充）
1. 要具體
❌「修一下 bug」 ✅「修登入的 bug：輸入錯誤密碼後畫面變空白」
2. 拆成步驟
1. 建一個新的 database table 存 user profile
2. 建一個 API endpoint 讀寫 user profile
3. 做一個頁面讓使用者看和編輯自己的資料
3. 先讓它探索再動手
analyze the database schema
然後才
build a dashboard showing ...
4. 明確定義「做完長什麼樣」
這是 Codex 那份筆記 也強調的：你沒定義 done，agent 就自己定義。
實務範本：
任務：<一句話>
完成條件：
- <可驗證的事實 1>
- <可驗證的事實 2>
限制：
- 不要動 <某某>
- 做完不要 commit
5. 醫學內容的額外一條 ⚠️
在這個 vault 裡工作時，prompt 要明確：
所有 PMID 都要用 PubMed MCP 查證。查不到就改成原則性描述並標「需查證」，不要猜。
AI 自己推論的內容要標 (inferred)。
這條在 CLAUDE.md §0 和 §4 已經寫死，但重要的規則值得在 prompt 裡再講一次——CLAUDE.md 是 context 不是強制設定，重複強調會提高遵守率。
幾個一開始就該養成的習慣
大改動先進 plan mode
按 Shift+Tab 切到 plan，或單次 prompt 前面加 /plan：
/plan 把 NEP 科所有筆記的 frontmatter 補上 modified 欄位
它會研究、提計畫、但不動你的檔案，等你核准。詳見 05-權限模式與安全。
Context 快滿了就 /compact
/compact
/compact 只保留跟 frontmatter 修補有關的內容
可以帶指示告訴它保留什麼。
💡 專案根目錄的
CLAUDE.md會在 compact 之後自動重新讀回來；子目錄的 nested CLAUDE.md 不會自動重注入，要等它下次讀那個子目錄的檔案。
用 /context 檢查它到底載入了什麼
/context
會用彩色格子視覺化目前 context 的用量，並列出 Memory files（實際載入的 CLAUDE.md）。「Claude 沒照我的規矩做」的第一步排查就是這個。
做錯了用 Esc Esc 倒帶
輸入框空的時候連按兩次 Esc 會開 rewind 選單，可以把程式碼和對話還原到之前某個點。
常用指令速查（依情境）
| 想做什麼 | 指令 |
|---|---|
| 看目前 context 用量 | /context |
| 壓縮對話省 token | /compact [指示] |
| 清空重來 | /clear |
| 換模型 | /model opus |
| 調思考力度 | /effort high |
| 進入規劃模式 | /plan [描述] |
| 看 / 改權限規則 | /permissions |
| 編輯記憶檔 | /memory |
| 看未 commit 的 diff | /diff |
| 看花了多少 | /usage（/cost 是別名） |
| 設定介面 | /config |
| 診斷設定問題 | /doctor |
| 換工作目錄 | /cd <path> |
| 加一個可存取的目錄 | /add-dir <path> |
| 匯出對話 | /export [檔名] |
| 複製上一則回覆 | /copy |
| 分支出一條新對話 | /branch [名字] |
| 問個離題小問題（不進對話） | /btw <問題> |
🔗 相關筆記
- 02-安裝與登入 — 上一步
- 04-互動介面與快捷鍵 — 下一步：把操作變快
- 05-權限模式與安全 — plan mode 的完整說明
- 06-CLAUDE-md與記憶系統 — 讓它記住你的規矩
- Codex 05 - 實戰提示詞 — prompt 寫法可互相參考
最後更新：2026-08-04