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。
🔗 相關筆記
- Codex CLI 從 0 開始使用教學 — 另一支 CLI agent,本站的「雙手」
- Herdr 從 0 開始使用教學 — 同時管理多個 agent 的終端環境
- Herdr 08 - Claude 大腦 + Codex 雙手 — 兩支 CLI 怎麼分工
- 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
