Claude Code Cli 教學手冊
Claude Code CLI 教學手冊 版本:v1.3(2026-08-14) 適用對象:系統分析師、軟體架構師、後端工程師、前端工程師、DevOps工程師、SRE工程師、AI工程師、企業資訊部門、Framework維護團隊、Legacy System維護團隊 內容定位:本手冊聚焦於 Claude Code CLI 層級的安裝、設定、指令、Agent 架構、MCP 整合與企業導入實務,可與專案內其他 Claude Code 相關手冊(生態圈版、資深同仁版等)並行參考 對齊基準:本版內容已對照官方文件(code.claude.com/docs)於 Claude Code v2.1.224 以上(2026-08-14) 時的狀態逐章核對更新,細節請見附錄C版本紀錄 授權:內部教育訓練使用 如何使用本手冊 Claude Code CLI 是一套以終端機(Terminal)為主要操作介面的 AI 編碼代理人(Coding Agent)。它不像傳統 IDE 外掛只做行內自動完成,而是能夠自主規劃、呼叫工具、跨檔案修改、執行測試、操作 Git,甚至協調多個子 Agent 完成大型任務。本手冊依角色整理出建議閱讀路徑: 角色 建議優先閱讀章節 新進工程師 第1、3、4、6、7章 後端/前端工程師 第8、9、14、17、18章 架構師/系統分析師 第2、13、15、16章 DevOps/SRE 第5、12、19、20、28章 企業資訊部門主管 第21、25、28章 Legacy System維護團隊 第15、16章 平台/AI賦能團隊 第9、10、26、27章 目錄 下列目錄為兩層結構:章節層可直接跳轉至對應章節開頭,子章節層可直接跳轉至章節內的特定小節。 第 1 章 Claude Code CLI 介紹 1.1 Claude Code 是什麼 1.2 Claude Code 與 Claude Web 差異 1.3 與其他工具的定位比較 1.4 適用情境 1.5 限制 1.6 與 Claude Code 周邊介面/產品的關係 第 2 章 Claude Code 架構原理 2.1 Agent Loop(代理人迴圈) 2.2 Context 管理與 Token 管理 2.3 Tool Calling 與 MCP 整合 2.4 子 Agent 與 Agent 協作 2.5 Codebase 理解機制 第 3 章 安裝教學 3.1 系統需求 3.2 Windows 安裝 3.3 macOS 安裝 3.4 Linux 安裝 3.5 Windows CMD 安裝(備選) 3.6 WSL2 安裝注意事項 3.7 npm 安裝路徑(備選) 3.8 更新與驗證 第 4 章 Authentication 4.1 帳號類型 4.2 登入方式 4.3 API Key 與環境變數(適合 CI / Headless) 4.4 安全建議 4.5 企業雲端供應商登入 4.5.1 Claude apps gateway:讓第三方雲端也能拿到集中治理 第 5 章 Claude Code 設定管理 5.1 settings.json 三層架構 5.2 優先順序 5.3 設定範例 5.4 常見設定鍵分類 5.5 Managed Settings 交付機制 第 6 章 CLI 指令大全 6.1 指令依生命週期分類 6.2 Session 操作 6.3 Agent 管理 6.4 MCP / Plugin / 專案維護 6.5 常用旗標(Flags) 6.6 權限模式與 Auto Mode(自動權限分類器) 6.6.1 Auto Mode 分類器運作方式 6.6.2 啟用條件與企業治理 第 7 章 Hotkey 大全 7.1 終端機層級快捷鍵 7.2 Claude Code Session 內快捷鍵 7.3 Agent 操作快捷鍵 第 8 章 Context Engineering 8.1 Context Window 組成 8.2 壓縮(Compaction)與重用 8.3 快取(Caching) 8.4 Token 優化技巧 8.5 Checkpoints 與 Rewind(對話回溯) 第 9 章 Agent 系統 9.1 概念釐清:Agent / Sub Agent / Multi Agent 9.2 何時該建立 Sub Agent 9.3 生命週期管理 9.4 設計考量 9.5 Agent View(背景多 Session 監看) 9.6 Agent Teams(多 Session 協作,實驗性) 9.7 Dynamic Workflows(腳本化大規模編排) 9.8 Worktrees(Git Worktree 隔離機制) 9.9 Fork 機制:/subtask(分支 Subagent)與 /fork(複製整個 Session) 9.10 跨 Session 訊息傳遞(Cross-session Messaging) 第 10 章 Agents 目錄 10.1 子 Agent 定義檔格式 10.2 載入順序 10.3 呼叫方式 10.4 內建子 Agent 10.5 Persistent Memory(子 Agent 持久記憶) 10.6 實務範例:團隊共用子 Agent 第 11 章 CLAUDE.md 11.1 用途 11.2 四層檔案 11.3 企業標準範本 11.4 維護方式 11.5 Auto Memory(自動記憶):Claude 自己寫的筆記 11.6 .claude/rules/:路徑範圍化的模組化規則 第 12 章 Hooks 12.1 生命週期事件 12.2 Handler 類型 12.3 PreToolUse/PostToolUse 機制 12.4 設定範例 12.5 安全考量 第 13 章 MCP 整合 13.1 MCP 概念 13.2 設定與管理 13.3 整合案例 13.4 工具延遲載入 13.5 MCP 治理鍵補充 第 14 章 使用 Claude Code 開發 Web Application 14.1 通用工作流程 14.2 Spring Boot(Java/Kotlin) 14.3 FastAPI(Python) 14.4 Vue3 / Angular 第 15 章 Legacy System 逆向工程 15.1 分析方法 15.2 適用範圍與限制 15.3 範例 Prompt 15.4 產出範例 第 16 章 Framework 升級 16.1 通用升級方法論 16.2 各升級情境要點 16.3 範例 Prompt 第 17 章 Git 整合 17.1 AI 協作流程 17.2 常用指令 17.3 守則 17.4 Worktree 分支隔離與 /code-review 第 18 章 測試工程 18.1 測試生成工作流程 18.2 各類型測試 18.3 範例 18.4 TDD 風格使用 第 19 章 SSDLC 整合 19.1 定位 19.2 各類掃描的協作方式 19.3 兩層防護案例 19.4 Sandboxing:第三層防護 第 20 章 Token 與成本管理 20.1 成本驅動因子 20.2 查看用量 20.3 降低成本技巧 20.4 用量可視化:/usage、Analytics、OpenTelemetry 第 21 章 團隊導入指南 21.1 分階段導入流程 21.2 治理模式 21.3 權限管理 21.4 標準規範 21.5 新機制的治理檢查項 第 22 章 Claude Code 最佳實務 22.1 20 個最佳實務 22.2 20 個常見錯誤 22.3 20 個效能優化技巧 第 23 章 Claude Code Prompt Library 23.1 分類架構 23.2 範本(可直接複製套用) 第 24 章 Claude Code + GitHub Copilot 協同開發 24.1 分工模式 24.2 實際工作流程 24.3 避免衝突 第 25 章 Claude Code 企業級導入藍圖 25.1 完整藍圖 25.2 組織架構 25.3 治理模式總結(彙整前述章節) 25.4 KPI 與稽核 第 26 章 Agent 進階協作模式 26.1 四種平行化機制總覽 26.2 Agent Teams 實務 26.3 Dynamic Workflows 實務 26.4 /batch:大規模 Worktree 隔離批次處理 第 27 章 Agent Skills 與 Plugin 生態 27.1 Skills 與 CLAUDE.md/Subagent 的定位差異 27.2 SKILL.md 格式與存放層級 27.3 隨附 Skills(Bundled Skills) 27.4 Plugins 生態與 Marketplace 治理 27.5 團隊標準化建議 第 28 章 企業治理進階 28.1 Managed Settings 完整交付架構 28.2 Sandboxing 深度 28.3 Network Config 與 LLM Gateway 28.3.1 組織層級模型治理(Enterprise) 28.4 Zero Data Retention、稽核與合規 28.5 Cost/Usage/Analytics 企業可視化(平台團隊視角) 附錄 A:常見問題 FAQ 附錄 B:詞彙表 Glossary 附錄 C:版本紀錄 Version History 附錄 D:學習路線圖 附錄 E:與其他 AI 編碼工具比較表 附錄 F:Checklist(新人加入檢查清單) 第 1 章 Claude Code CLI 介紹 1.1 Claude Code 是什麼 Claude Code 是 Anthropic 推出的終端機原生 AI 編碼代理人(Agentic Coding Tool)。與一般「聊天視窗貼程式碼」的使用方式不同,Claude Code 直接在你的專案目錄裡執行,能夠讀取檔案、搜尋程式碼、編輯多個檔案、執行 Bash 指令、操作 Git、呼叫外部系統(透過 MCP),並以「自主代理人迴圈」(Agent Loop)的方式持續規劃與執行,直到任務完成或需要你確認為止。 ...