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與斜線指令SkillsSKILL.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 modeShift+Tab/plan),看過計畫再放行。
  • 省 token 的三招/compact、把長流程搬進 skill(用到才載入)、把探索工作丟給 subagent。
  • ⚠️ CLAUDE.md 和 skill 是「上下文」不是「強制設定」。真的要「一定發生」的事,寫成 hook

🔗 相關筆記


參考資料

最後更新:2026-08-04