---
title: "03 - 第一次使用與基本操作"
type: note
specialty: Programming
tags: [claude-code-cli從0開始使用教學, 03-基本操作, quickstart]
created: 2026-08-04
updated: "2026"
modified: 2026-08-04
---

# 03 - 第一次使用與基本操作

← [[02-安裝與登入]] | [[00-Index]] | 下一篇 → [[04-互動介面與快捷鍵]]

---

## 開一個 session

```bash
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. 明確定義「做完長什麼樣」

這是 [[Programming/Codex/Codex從0開始使用教學/05-實戰提示詞與上手流程|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與記憶系統]] — 讓它記住你的規矩
- [[Programming/Codex/Codex從0開始使用教學/05-實戰提示詞與上手流程|Codex 05 - 實戰提示詞]] — prompt 寫法可互相參考

---

*最後更新：2026-08-04*