---
title: "Claude Code CLI 從 0 開始使用教學 - 完整學習筆記"
type: note
specialty: Programming
tags: [claude-code-cli從0開始使用教學, 00-index, claude-code, agent]
created: 2026-08-04
updated: "2026"
modified: 2026-08-04
---

# Claude Code CLI 從 0 開始使用教學 - 完整學習筆記

> 給第一次在終端機用 Claude Code 的人：從安裝登入，到把它變成「懂你的 repo、有自己的 skill、會自動化、能平行工作」的日常主力工具。

---

## 一句話結論

**Claude Code 是一個 agentic coding tool：它讀你的 codebase、改檔案、跑指令、接你的開發工具。** CLI 只是它的其中一個介面（另有 VS Code、JetBrains、桌面 app、網頁、手機、Slack、GitHub Actions），但**終端機是功能最完整的那個**。

對本站作者來說，它已經是這個 vault 和刷題網站的「大腦」——12 個自訂 skill、兩份 `CLAUDE.md`、PubMed MCP 都掛在上面。這份筆記把那些零散用出來的經驗，補上官方文件的完整地圖。

---

## 目錄

| 檔案 | 主題 | 說明 |
|---|---|---|
| [[01-什麼是Claude-Code]] | 什麼是 Claude Code | 心智模型、能做什麼、各介面差異 |
| [[02-安裝與登入]] | 安裝與登入 | Windows / WSL / mac、訂閱 vs API key |
| [[03-第一次使用與基本操作]] | 第一次使用 | 第一個 session、常用指令、prompt 心法 |
| [[04-互動介面與快捷鍵]] | 互動介面 | 全部快捷鍵、`!` shell、`@` 檔案、transcript |
| [[05-權限模式與安全]] | ⚠️ 權限與安全 | 六種模式、protected paths、auto mode |
| [[06-CLAUDE-md與記憶系統]] | 記憶系統 | CLAUDE.md 階層、`.claude/rules/`、auto memory |
| [[07-Skills與斜線指令]] | Skills | SKILL.md 寫法、frontmatter、內建指令表 |
| [[08-Subagents與平行工作]] | 平行工作 | subagent / agent view / agent team / worktree |
| [[09-Hooks自動化]] | Hooks | 全部事件、設定格式、實用範例 |
| [[10-MCP與外部工具]] | MCP | 連 PubMed、GitHub 等外部工具 |
| [[11-非互動模式與腳本化]] | 腳本化 | `-p`、JSON 輸出、pipe、CI |
| [[12-設定檔與CLI旗標速查]] | 設定與旗標 | `settings.json`、重要 flag 一覽 |
| [[13-實戰-套用在兩個repo]] | 實戰 | 醫學筆記庫與刷題網站的實際用法 |
| [[14-疑難排解與速查表]] | 排錯與速查 | 症狀對照 + cheat sheet |

---

## 學習路線

**最短路徑（30 分鐘會用）**：
[[02-安裝與登入]] → [[03-第一次使用與基本操作]] → [[05-權限模式與安全]]

**變成日常主力（再 1 小時）**：
[[04-互動介面與快捷鍵]] → [[06-CLAUDE-md與記憶系統]] → [[07-Skills與斜線指令]]

**進階自動化**：
[[08-Subagents與平行工作]] → [[09-Hooks自動化]] → [[11-非互動模式與腳本化]]

---

## 快速結論（懶人包）

- **裝**：`curl -fsSL https://claude.ai/install.sh | bash`（mac / Linux / WSL）；Windows PowerShell 用 `irm https://claude.ai/install.ps1 | iex`。原生安裝會**自動背景更新**。
- **登入**：直接 `claude`，第一次會開瀏覽器。Claude Pro 訂閱就能用。
- **最重要的一個鍵**：`Shift+Tab` 切權限模式（Manual → acceptEdits → plan）。
- **最重要的一個檔案**：`CLAUDE.md`——每次 session 開頭都會讀，是你不用重複解釋的地方。
- **最重要的一個習慣**：大改動先進 **plan mode**（`Shift+Tab` 或 `/plan`），看過計畫再放行。
- **省 token 的三招**：`/compact`、把長流程搬進 skill（用到才載入）、把探索工作丟給 subagent。
- ⚠️ **CLAUDE.md 和 skill 是「上下文」不是「強制設定」**。真的要「一定發生」的事，寫成 **hook**。

---

## 🔗 相關筆記

- [[Programming/Codex/Codex-CLI從0開始使用教學/00-Index|Codex CLI 從 0 開始使用教學]] — 另一支 CLI agent，本站的「雙手」
- [[Programming/Herdr/Herdr從0開始使用教學/00-Index|Herdr 從 0 開始使用教學]] — 同時管理多個 agent 的終端環境
- [[Programming/Herdr/Herdr從0開始使用教學/08-Claude當大腦-Codex當雙手|Herdr 08 - Claude 大腦 + Codex 雙手]] — 兩支 CLI 怎麼分工
- [[Programming/Git-GitHub/00-Index|Git & GitHub 從零開始教學]] — Claude Code 大量操作 git，先懂基礎

---

## 參考資料

- Claude Code 官方文件：<https://code.claude.com/docs/>（本教學內容以此為準，讀取日期 2026-08-04）
- Overview：<https://code.claude.com/docs/en/overview>
- Quickstart：<https://code.claude.com/docs/en/quickstart>
- CLI reference：<https://code.claude.com/docs/en/cli-reference>
- 文件全索引（給 AI 讀的）：<https://code.claude.com/docs/llms.txt>

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