文章目錄
Claude Code 是什麼？完整教學：安裝、指令、CLAUDE.md、權限與 Codex 比較
Claude Code 是 Anthropic 推出的 AI coding agent，能直接讀取你的專案目錄、修改檔案、執行終端機指令、跑測試，而且不需要離開開發環境。它跟 ChatGPT 最根本的差異在於：ChatGPT 在瀏覽器裡跟你「聊」程式，Claude Code 走進你的本機 repo 動手做事。跟 OpenAI Codex 的核心差異則是定位：Claude Code 貼近本機開發流程，Codex 以 App 和雲端任務分派為主。值不值得用？如果你日常需要在本機處理程式碼、檔案或自動化流程，值得試。如果只是偶爾問幾個問題，ChatGPT 就夠了。
TL;DR： Claude Code 的強項是貼近本機開發流程。Codex 的強項是程式介面與任務分派。只想在本機深度處理一個 repo，先試 Claude Code；想在程式介面管理多個任務，優先看 Codex。
10 分鐘開始用 Claude Code
最快的方式是打開終端機，六步走完。前提是你已經有 Claude Pro 以上的帳號。
步驟 1：安裝（1 分鐘）
在終端機輸入：
npm install -g @anthropic-ai/claude-code
需要 Node.js 18 以上。裝好就會有 claude 這個指令可以用。
步驟 2：登入（1 分鐘）
終端機輸入 claude，第一次執行會引導你用瀏覽器完成 Anthropic 帳號授權。授權完終端機會自動接上，不需要額外設定 API key。
步驟 3：進入專案（30 秒）
用 cd 切到你想讓 Claude Code 工作的專案目錄，然後輸入 claude 啟動。它會自動偵測這個目錄下的檔案結構、Git 狀態和相關設定。
步驟 4：下第一個指令（2 分鐘）
老實說，第一次用 Claude Code 最好的入門指令不是叫它改東西，而是叫它讀專案。試試這句：
「請先讀這個專案，不要修改檔案，幫我摘要架構。」
這句話讓它只做理解、不動手。你會看到它自己讀目錄、開檔案、抓重點，然後給你一份結構摘要。這就是 agentic coding 的核心：它自己決定要讀哪些檔案、怎麼理解你的專案。更多 Claude 的基本操作，可以參考我們的 Claude 教學。
步驟 5：試一個小任務（3 分鐘）
接著給它一個具體但小的任務，例如：「幫我在 README.md 加入一個安裝說明段落」。它會讀現有的 README、判斷格式、產生新內容，然後詢問你是否同意修改。確認後它才會寫入檔案。
步驟 6：查用量（30 秒）
在對話中輸入 /usage，可以看到目前的 token 用量和剩餘額度。養成習慣，每隔一段時間確認一下。
走完六步你就用過了。接下來的內容都是在這個基礎上往上加。
Claude Code 是什麼？不是「更會寫程式的 ChatGPT」
最常見的誤解：Claude Code 就是一個比較會寫程式的 ChatGPT。不是。兩者的根本差異在於能不能動手。ChatGPT 是聊天室裡的程式設計顧問，你問它答，答案貼出去之後要自己動手改檔案、跑指令、看結果。Claude Code 是走進你開發環境裡的 agent，它可以直接存取檔案系統、執行終端機指令、讀取 Git 狀態，然後自己做修改、自己跑測試、自己看結果決定下一步。
用一個比喻：聊天式 AI 像你拿食譜打電話問朋友怎麼煮，對方口頭告訴你步驟，你自己在廚房操作。Claude Code 像有人直接走進你的廚房，幫你找鍋子、切菜、開火，每做一步會先問你「這樣可以嗎」，你點頭它才繼續。
根據 Anthropic 官方文件，Claude Code 支援 5 種作業系統（macOS、Ubuntu / Debian / Fedora、Windows WSL、ChromeOS Linux、Oracle Linux），7 種以上的介面（CLI、VS Code 擴充功能、JetBrains 外掛、Web、Desktop App、GitHub Actions、API）。它不是一個單一產品，而是一整組跟開發環境綁定的 agent 介面。
定義講清楚：Claude Code 是一個 agentic coding tool。「Agentic」的意思是它不是一問一答就結束，而是會根據任務自己決定要做哪些事、讀哪些檔案、跑哪些指令，然後觀察結果再決定下一步。這個循環會一直重複，直到任務完成或它需要你介入判斷。
第一次使用，我建議先讓它讀專案，不要一開始就叫它改檔案。理解它的判斷邏輯之後，再慢慢加大任務範圍。這不是因為它不安全，是因為你要先建立對它的判斷可信度。想知道更多 Claude 的基本概念，可以看 Claude 教學。
Claude Chat、Cowork、Code 差在哪？三種型態一次搞懂
Claude 目前有三種產品型態，很多人分不清。直接講：Chat 是瀏覽器裡的問答工具，Cowork 是桌面 App 裡的協作空間，Code 是終端機裡的 coding agent。三個都用同一個 Claude 模型，但定位和操作方式完全不同。
Claude Chat（對話型）
就是你在 claude.ai 網站或手機 App 上用的那個 Claude。問問題、寫文案、分析資料、整理筆記，都是在聊天介面裡完成。特點是操作簡單、跨平台，但所有動作都限於對話框裡。它不能幫你改本機檔案、不能跑終端機指令，產出只能複製貼上。
Claude Cowork（協作型）
Cowork 是 Claude Desktop 裡的協作介面。它提供一個虛擬沙盒環境，Claude 可以在裡面建立文件、畫面和應用原型。適合需要反覆修改同一份文件、或想讓 Claude 產出具體可交付成果的使用者。關鍵限制：它在沙盒裡操作，不碰你的本機檔案系統。
Claude Code（終端機 agent）
前面已經提過，它直接在你的電腦上操作。讀檔案、改程式碼、跑測試、操作 Git，全部在本機環境裡完成。它不是在沙盒裡幫你做東西，是走進你實際的工作目錄動手做事。這也代表你給它的權限越大，它能做的事越多，但你需要看著它。
三種型態比較
| 功能特性 | Claude Chat | Claude Cowork | Claude Code |
|---|---|---|---|
| 主要入口 | 瀏覽器、手機 App | Desktop App | CLI、VS Code、IDE |
| 操作環境 | 對話框 | 虛擬沙盒 | 本機檔案系統 |
| 能改本機檔案 | 否 | 否 | 是 |
| 能跑終端機指令 | 否 | 否 | 是 |
| 適合場景 | 問答、寫作、分析 | 文件協作、原型產出 | 程式開發、自動化、Git 操作 |
| 目標使用者 | 所有人 | 知識工作者 | 開發者、技術使用者 |
誰該用哪個？問問題和寫東西用 Chat，想讓 Claude 在專屬空間幫你產出文件或原型用 Cowork，想讓它直接改你的程式碼和跑指令用 Code。最常被搞混的是 Cowork 和 Code：Cowork 是 Claude Desktop 裡的協作介面，Code 是獨立的 coding agent，兩個完全不一樣。更多細節可以看 Claude 教學和 Claude Desktop 介紹。
Claude Code 怎麼運作的？理解 Agent Loop 才能用得好
Claude Code 的核心運作機制是一個叫做 Agent Loop 的循環。理解這個循環，你才知道為什麼有些任務它做得好、有些不行，以及怎麼給它更好的指令。
Agent Loop 分六步。
- 理解任務 — 解析你給的指令，確認目標是什麼
- 探索上下文 — 自己決定要讀哪些檔案、看哪些目錄、查哪些設定
- 制定計畫 — 根據探索結果，列出要執行的步驟
- 執行動作 — 修改檔案、跑指令、安裝套件、執行測試
- 觀察結果 — 讀錯誤訊息、檢查測試輸出、確認修改是否生效
- 調整或回報 — 如果結果不對，回到步驟 2 重新探索；如果完成，回報給你
這不是一次給答案就結束的過程。它可能會迴圈跑很多次，每次根據上一步的結果調整方向。這就是為什麼 Claude Code 處理一個任務可能要幾十秒到幾分鐘，而不是像聊天機器人那樣秒回。
但這裡有一個關鍵問題：Agent Loop 的第 5 步「觀察結果」需要回饋訊號。如果你的專案沒有測試、沒有 linter、沒有型別檢查，也沒有明確的錯誤訊息，Agent Loop 就像在陌生城市裡靠感覺開車。它會試著判斷自己做對了沒有，但缺乏客觀的驗證機制。這不是 Claude Code 的 bug，是所有 agentic tool 共同的結構性限制。
所以如果你的專案還沒有測試和 lint，建議先花時間把這些基礎設施建起來。不是為了「正規開發流程」，是為了讓 Agent Loop 有回饋可以吃，它才能做得更好。
Claude Code 能幫你做什麼？工程師與非工程師的實用場景
直接回答：Claude Code 能做的事比你想像的多，但不是每件事都適合全交給它。以下分工程師和非工程師兩個群體來看。
工程師的 7 個場景
| 場景 | 可以幫忙的 | 仍要把關的 |
|---|---|---|
| 修 bug | 讀錯誤訊息、定位根因、提出修復方案 | 邊界條件、效能影響、向後相容 |
| 寫測試 | 根據現有程式碼產生測試案例 | 測試覆蓋率是否足夠、案例是否有意義 |
| 重構 | 統一命名、拆分大函式、搬移檔案 | 重構後的行為是否完全不變 |
| 整理文件 | 更新 README、補 API 文件、整理 CHANGELOG | 技術細節的準確性 |
| Git 操作 | 產生 commit message、建立分支、解 merge conflict | 分支策略、release 流程的判斷 |
| 學新專案 | 快速摘要架構、畫出依賴關係、解釋核心邏輯 | 深層設計決策的脈絡 |
| 自動化流程 | 寫 CI/CD 腳本、建置工具鏈、設定 lint/format | 安全性設定、環境變數管理 |
非工程師也能用的場景
不用會寫程式，Claude Code 一樣幫得上忙。以下是幾個實際的例子。
整理資料夾、批次改檔名。假設你有一個資料夾裡 200 張照片，檔名是 IMG_20260101_001.jpg 這種相機預設格式，你想改成「日期＋地點」的命名方式。跟 Claude Code 說「把這個資料夾裡所有照片按照 EXIF 日期重新命名，格式是 YYYY-MM-DD-序號」，它會幫你寫腳本、執行、完成。你只要確認前幾個檔名對不對就好。
把 Excel 資料彙整成報表。月底了，行銷部門這個月跑了 8 個活動，每個活動有一份 Excel 成果表。你可以叫 Claude Code 把這 8 份 Excel 讀進來，按照欄位彙整成一份總表，甚至產生基本的統計摘要。比起手動開 8 個檔案複製貼上，這大概省你半小時。
建一個簡單的網頁或工具。需要一個內部用的表單頁面、一個簡單的計算機工具、或一個靜態登陸頁，跟 Claude Code 說清楚需求，它可以直接幫你產生 HTML/CSS/JS 檔案。如果你在做 WordPress 相關開發，也可以請它產生佈景主題或外掛的基礎程式碼。
自動化重複的電腦作業。每週都要把某個資料夾的最新檔案寄給同事？每天都要把某個網站的資料複製到試算表？這類規律的重複工作，Claude Code 可以幫你寫成腳本，之後執行腳本就好。如果你有固定報表要整理，也可以請 Claude Code 幫你寫成可重複執行的腳本。
一個星期五下午的故事
想像一個情境：星期五下午四點半，你接到一個兩年前別人寫的專案的 bug 回報。程式碼你沒看過，技術棧也不完全熟悉，文件幾乎是空的。手動讀完可能要花兩小時，加上 debug 可能到下班還做不完。這種時候你打開 Claude Code，請它先讀專案架構、找出跟錯誤訊息相關的模組、定位可能的根因。十分鐘後你有了方向，三十分鐘後修復完成，測試也跑過了。五點半準時下班。
但這裡有一個我自己的判斷要說清楚：可以讓 Claude Code 做，但不要一開始就全自動做。先讓它做一步，你確認一步。建立信任之後再慢慢放大。把它當成一個能力很強但偶爾會犯錯的同事，而不是一個全知全能的自動化機器。
搞懂 Claude Code 能做什麼之後，你可能會想知道它跟另一個熱門的 coding agent — OpenAI Codex — 到底有什麼不一樣。兩者的定位差異比多數人想像的大，選錯工具會浪費不少時間。
Claude Code vs Codex：真正的差異在哪？
Claude Code 和 OpenAI Codex 都已經不是單純的「程式碼自動補全工具」。兩者都是能讀專案、跑指令、改檔案的 AI coding agent。但產品重心完全不同，搞混了會選錯工具。
用一句話區分：Claude Code 是貼著你本機專案工作的 agent，它讀你的程式碼、理解你的目錄結構、在你允許的前提下直接改檔。Codex 是 OpenAI 生態裡的 coding agent 平台，它的核心體驗從多個入口理解：Codex App（ChatGPT 裡的獨立分頁）、Web 介面、IDE 擴充功能、Cloud 沙箱任務、GitHub PR 整合、Slack 頻道觸發。CLI 也能用，但那不是 Codex 的主戰場。
講白一點，Claude Code 像一個坐在你旁邊、直接操作你電腦的資深工程師。Codex 像一個你把需求丟過去、它在雲端獨立完成、再把結果送回來的遠端接案夥伴。兩種模式各有擅長，但本質不一樣。
| 比較面向 | Claude Code | OpenAI Codex |
|---|---|---|
| 核心定位 | 本機深度工作的 AI agent | 雲端任務為中心的 agent 平台 |
| 主要入口 | CLI 終端機、VS Code、Desktop App、Web | ChatGPT App、Web、IDE、Cloud、GitHub、Slack |
| 本機工作 | 直接讀寫本機檔案，即時互動 | 支援，但非主要體驗 |
| 雲端背景任務 | 支援背景 agent 與排程任務 | 原生支援，沙箱隔離執行 |
| 模型與生態 | Claude Opus / Sonnet 系列 | GPT-5.5 / o 系列模型 |
| 專案規範 | CLAUDE.md（Markdown，彈性高） | codex.md / TOML 設定檔 |
| 安全控管 | 多層權限模式，本地執行可即時攔截 | OS 層級沙箱隔離，雲端執行 |
| 最適合 | 需要深度理解專案結構的複雜開發任務 | 批量背景任務、PR review、團隊協作流程 |
資料來源：Claude Code 官方文件、Codex App 文件、Codex IDE extension 文件。
該選 Claude Code 還是 Codex？
這不是誰比誰強的問題，是使用場景的問題。底下五個情境直接對照你現在的需求：
- 本機終端機深度工作 → 選 Claude Code。你需要 AI 理解整個專案結構、讀完幾十個檔案再動手改，Claude Code 在這種場景下的上下文理解力是目前最強的。
- 雲端背景跑任務、GitHub issue 進入 → 選 Codex。你可以把任務丟到雲端沙箱讓它自己跑，同時繼續做其他事，完成後直接開 PR。
- 已在 ChatGPT 生態 → Codex 導入成本更低。團隊已經習慣用 ChatGPT 討論、用 OpenAI API，加一個 Codex 幾乎零摩擦。
- 已在 Claude 生態 → Claude Code 更自然。你用 Claude 寫文案、做研究、跑分析，現在要加一個 coding agent，同一個帳號、同一個計費邏輯。
- 不是二選一 → 很多人兩個都用。Claude Code 做本機深度開發和重構，Codex 做雲端批次任務和 PR review。它們在生態上是互補的，不是互斥的。
我自己的結論：Claude Code 是「貼著工作目錄工作的 agent」，Codex 是「以 App 和 Cloud 任務為中心的 agent 平台」。選哪個取決於你把大部分時間花在哪裡。如果你還不確定 Claude 生態的全貌，可以先看我們之前寫的 Claude AI 完整教學，對整個產品線有基本認識再回來選工具。
別搞混：Claude Code 和 Claude Cowork 不一樣
很多人在 Desktop App 裡看到「Code」和「Cowork」兩個分頁就混了。它們是完全不同的產品定位：
- Cowork 是 Desktop 裡的視覺化協作介面，適合處理文件、企劃書、研究報告這類非程式碼任務。它有 GUI、有即時預覽，操作邏輯像跟一個同事一起改 Google Doc。
- Code 是程式碼和開發任務的 agent。它讀你的程式碼、跑終端機指令、改檔案、跑測試。操作邏輯像跟一個工程師 pair programming。
判斷標準很簡單：你今天要讓 AI 讀程式碼並修改，用 Code。只是想寫一份企劃書或整理資料，用 Cowork 或 Chat 就夠了。拿 Cowork 去改程式碼，就像拿 PowerPoint 去修照片，不是不行，但工具選錯了。如果你在猶豫該用哪種介面做內容整理，Cowork 會比 Code 更直覺。
如何安裝 Claude Code？CLI、VS Code、Desktop、Web 四種方式
安裝前先確認一件事：Claude Code 需要 Pro 以上帳號。免費方案不包含 Claude Code 使用權限，你連登入都過不去。如果你還在免費方案，先確認帳號方案再往下看。
CLI（命令列）安裝
這是進階開發者最常用的方式。官方目前推薦用 native install，一行指令搞定，不需要 Node.js。舊的 npm install 方式從 2026 年 1 月起已被官方標為不建議（deprecated）。
macOS / Linux / WSL：
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell：
irm https://claude.ai/install.ps1 | iex裝完後跑 claude --version 確認版本，或跑 claude doctor 做一次完整健檢。第一次登入直接輸入 claude，它會引導你完成瀏覽器授權。
建議第一次使用先下低風險指令試水溫，例如 claude "列出這個目錄下的所有 TypeScript 檔案"。確認它理解你的環境、回應正常，再開始給它更複雜的任務。
VS Code 擴充功能
在 VS Code 市集搜尋「Claude Code」直接安裝。裝好後用 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows）開命令面板，搜尋 Claude Code 就能啟動。
這個擴充功能在 Cursor 裡也能用。如果你已經是 Cursor 用戶，不用額外裝東西，在同一個編輯器裡就能呼叫 Claude Code。最大好處是不用離開編輯器，改完直接看 inline diff，改了什麼一目了然。前後端修改都在同一個視窗裡完成，對需要頻繁看 diff 的開發者很方便。
Desktop App
到 claude.ai/download 下載 Desktop App。安裝完打開 Claude，登入後選「Code」分頁（不是「Chat」分頁）。目前支援 macOS 和 Windows，Linux 用戶請用 CLI。
Desktop App 適合不喜歡終端機的人。它背後跑的是同一個引擎，只是用圖形介面包了一層。Desktop App 把 AI 的操作門檻降到最低，適合先用圖形介面熟悉流程。
Web 版
連到 claude.ai/code，免安裝，開瀏覽器就能用。Web 版可以處理遠端 repo，同時開多個 session，適合臨時要在別台電腦上工作的情境。
不過 Web 版的功能完整度略低於 CLI 和 Desktop。重度使用者最終還是會回到 CLI 或 VS Code 整合。但作為「先試試看」的入口，Web 版零門檻。
| 方式 | 適合誰 | 優點 | 限制 |
|---|---|---|---|
| CLI | 習慣終端機的開發者 | 功能最完整、自動更新、效能最好 | 需要熟悉命令列操作 |
| VS Code 擴充功能 | 日常用 VS Code / Cursor 的人 | 不離開編輯器、inline diff 直覺 | 依賴編輯器環境 |
| Desktop App | 不喜歡終端機的用戶 | 圖形介面、操作門檻低 | 不支援 Linux、功能更新略慢 |
| Web 版 | 臨時使用、跨裝置工作 | 零安裝、開瀏覽器就用 | 功能完整度較低、依賴網路 |
一個重要提醒：這四種介面背後都是同一個引擎。你的 CLAUDE.md 設定、MCP 設定、記憶檔案在所有介面之間是通用的。換句話說，你在 CLI 裡設好的東西，到 VS Code 或 Web 版都會生效。不用重複設定。
裝好只是第一步。知道有哪些常用指令和快捷鍵，才能把 Claude Code 用得順手。下面整理了一張速查表，建議直接加書籤。
Claude Code 常用指令與快捷鍵
這段是速查區，建議直接加書籤。完整指令列表可以看 Claude Code Commands 官方文件，費用計算看 Costs 文件。
先看啟動類的指令，這些是你在終端機裡直接輸入的：
| 指令 | 用途 | 什麼時候用 |
|---|---|---|
claude | 啟動互動式對話 | 每天開工的第一步 |
claude "任務描述" | 帶著任務直接啟動 | 明確知道要做什么時，省去互動 |
claude -p | 非互動模式（pipe 模式） | 要串接腳本或 CI/CD 時 |
claude -c | 繼續上次對話 | 中斷後回來繼續工作 |
claude commit | 自動生成 commit message 並提交 | 改完 code 準備 commit 時 |
再看對話中的指令，這些是進入 Claude Code 之後、在提示符號下輸入的斜線指令：
| 指令 | 用途 | 什麼時候用 |
|---|---|---|
/clear | 清空對話、重開新 session | 話題切換時。最重要的新手指令，避免舊上下文污染新任務 |
/compact | 壓縮對話歷史、釋放 context 空間 | 對話太長開始變慢或變貴時 |
/model | 切換模型（Sonnet / Opus） | 簡單任務用 Sonnet 省錢，複雜推理切 Opus |
/plan | 進入 Plan Mode，只規劃不執行 | 想先看 AI 的判斷再決定要不要動手 |
/usage | 查看本次 session 的花費和用量 | 不確定已經燒了多少 token 時 |
/context | 視覺化目前的 context 使用狀況 | 需要了解 token 用到哪裡去了 |
/memory | 編輯 CLAUDE.md 記憶檔案 | 要調整專案設定或加入新規範 |
Shift+Tab | 切換權限模式 | 在 Default / Auto-Accept / Plan 之間切換 |
Esc | 取消目前動作 | AI 開始跑偏了，先停下來 |
Esc+Esc | 強制中斷 | 真的卡住了，連按兩下 Esc 緊急停止 |
特別講一下 /clear。為什麼我說它是最重要的新手指令？因為 Claude Code 的對話有上下文長度限制。如果你在一個 session 裡已經改了十幾個檔案，context 裡塞滿了舊的程式碼片段和修改紀錄，AI 的判斷力會下降。這時候不切新 session，就像跟一個記憶力已經過載的同事講話，他開始搞混你講過的東西。所以每次換任務，養成習慣先跑一次 /clear。
指令熟了之後，另一個能大幅提升使用體驗的設定是 CLAUDE.md。這個檔案就像幫 AI 寫一份專案說明書，讓它每次啟動都帶著正確的背景知識。
CLAUDE.md 是什麼？怎麼設定？
CLAUDE.md 就是你的專案說明書。它告訴 Claude Code 這個專案是什麼、用什麼技術棧、有什麼規範、哪些地雷不能踩。沒有這個檔案，Claude Code 就像一個新來的同事對專案一無所知，只能靠你自己口頭解釋。有了它，AI 每次啟動就自帶完整背景知識。
CLAUDE.md 有三個層級，影響範圍從大到小：
| 層級 | 位置 | 影響範圍 | 適合放什麼 |
|---|---|---|---|
| 全域 | ~/.claude/CLAUDE.md | 所有專案 | 你的個人偏好、通用編碼風格 |
| 專案 | 專案根目錄 CLAUDE.md | 這個專案的所有協作者 | 技術棧、架構、規範、常用指令 |
| 本地 | CLAUDE.local.md | 只有你自己 | 本機路徑、個人除錯習慣（不會進 git） |
那到底什麼內容該寫進去？判斷標準很簡單：拿掉這條規則，AI 會不會犯錯？ 會就寫，不會就不需要。不需要把整個 README 複製貼上，只寫 AI 不知道就會搞砸的那幾條。精準比冗長有用。
下面是一個完整可複製的範本，你可以根據自己的專案修改：
# 專案名稱：My Project
## 專案概覽
這是一個 Node.js + Express 後端 API 服務，搭配 React 前端。
主要功能：用戶註冊、登入、資料 CRUD、定時排程。
## 技術棧
- 後端：Node.js 20、Express、PostgreSQL
- 前端：React 19、Vite、Tailwind CSS
- 測試：Vitest + Playwright
- 部署：Docker + AWS ECS
## 專案結構
- `src/routes/` API 路由定義
- `src/models/` 資料庫模型（Sequelize）
- `src/services/` 商業邏輯層
- `src/middleware/` 認證與錯誤處理中介層
- `frontend/src/` React 前端原始碼
## 編碼規範
- 後端使用 ESM（import/export），不使用 CommonJS
- API 回應統一格式：`{ success, data, error }`
- 資料庫操作只在 service 層，route 層不直接操作 DB
- 錯誤處理統一 throw CustomError，由全域 middleware 攔截
## 重要限制
- 環境變數在 `.env`，不要寫死在程式碼裡
- `src/migrations/` 裡的檔案只能加、不能改
- 所有對外 API 必須通過認證 middleware
## 常用指令
- `npm run dev` 啟動開發伺服器
- `npm test` 跑測試
- `npm run db:migrate` 跑資料庫遷移
- `npm run lint` 檢查程式碼風格這個範本覆蓋了六個關鍵面向：專案概覽、技術棧、目錄結構、編碼規範、重要限制、常用指令。你不需要照抄，但這六個分類是好的起點。關鍵不是寫多少，而是每個規則都有明確目的。
還有一個實用建議：CLAUDE.md 不要寫太長。超過 150 行的設定檔，AI 讀起來跟人一樣會開始遺漏重點。保持精簡、只寫必要的規則，效果反而更好。如果你的專案有特殊的效能、安全、部署或檔案產生規則，那些是最該放進去的內容，因為 AI 不知道就真的會出事。
Plan Mode、權限模式與模型選擇
Claude Code 有三個你一定要搞懂的控制機制：權限模式決定 AI 能做什麼、Plan Mode 決定它先想還是先做、模型選擇決定它有多聰明（和多貴）。三個湊在一起，就是你在成本和效率之間拿捏的施力點。
先看權限模式。Claude Code 提供四種，用 Shift+Tab 循環切換：
| 權限模式 | 讀取檔案 | 編輯與執行 | 適合場景 |
|---|---|---|---|
| Default（預設） | 自動 | 每次都需批准 | 初次使用、不想讓 AI 亂動 |
| Accept Edits | 自動 | 編輯自動、執行指令需批准 | 信任 AI 改碼但控制系統指令 |
| Plan Mode | 自動（唯讀） | 所有動作都需批准 | 想先看 AI 的判斷再決定要不要動手 |
| Bypass | 自動 | 全部自動 | CI/CD 環境，完全信任 |
新手強烈建議先用 Plan Mode。在這個模式下，Claude Code 只能讀檔案和提出計畫，不能改任何東西。你先看它的判斷對不對，對了再切回 Default 或 Accept Edits 讓它動手。這個習慣可以幫你省下很多「AI 改錯了要 undo」的麻煩。特別是當你的專案牽涉到部署、效能或資料處理這類對細節敏感的設定時，先規劃再動手就更重要。
接著是模型選擇。Claude Code 預設用 Sonnet 系列，你也可以手動切到 Opus。差別在哪？
| Sonnet | Opus | |
|---|---|---|
| 速度 | 快，回應幾乎即時 | 慢，需要等待思考 |
| 成本 | 便宜，適合大量使用 | 貴，約 Sonnet 的 5 倍 |
| 適合場景 | 日常寫碼、重構、除錯、文件撰寫 | 架構決策、複雜推理、跨模組重構 |
| 建議使用比例 | 80% 的工作量 | 20% 的關鍵決策 |
省錢技巧很簡單：先用 Sonnet，不行再切 Opus。大部分日常任務 Sonnet 都夠用。遇到那種需要理解十幾個檔案之間的關聯、做架構層級判斷的任務，再切 Opus。你也可以用 /model opus-plan，讓 AI 用 Opus 規劃、用 Sonnet 執行，兼顧品質和成本。
Claude Code 的進階功能：Hooks、Skills、Subagents 與 MCP
你不需要一開始就把這些全部搞懂。但知道天花板在哪很重要，不然你會以為 Claude Code 只是一個比較聰明的終端機助手。事實上，它可以擴充到相當複雜的自動化流程。底下是八個你遲早會遇到的功能，一次整理給你：
| 功能 | 做什麼 | 什麼時候用到 |
|---|---|---|
| Hooks | 在特定事件（如檔案修改、指令執行）前後自動觸發腳本 | 想在 AI 每次 commit 前自動跑 lint、或修改後自動格式化 |
| Skills | 可重複使用的提示套件，把常用流程封裝成一個指令 | 有固定流程（code review、PR 建立）想一鍵觸發 |
| Subagents | 獨立的 AI 程序，平行處理子任務 | 需要同時處理多個檔案或多個模組的重構 |
| GitHub Actions | 在 PR 裡標記 @claude 觸發自動 review | 團隊協作時，每個 PR 都有 AI 先看一遍 |
| JetBrains | 官方外掛支援 IntelliJ / WebStorm 等 IDE | 你是 JetBrains 生態的用戶 |
| Slack | 在 Slack 頻道裡標記 @Claude 觸發任務 | 團隊溝通和任務指派在同一個地方完成 |
| Chrome 擴充功能 | 在瀏覽器裡呼叫 Claude Code | 看網頁文件時想直接讓 AI 根據內容寫碼 |
| MCP | 連接外部工具和資料來源的協定（Model Context Protocol） | 要讓 AI 連資料庫、打 API、操作第三方服務 |
這八個功能裡面，Hooks 和 MCP 是最值得先投資理解的。Hooks 讓你把 AI 的行為加上「安全護欄」，例如每次修改檔案前自動備份。MCP 則把 Claude Code 從「只能讀寫本機檔案」擴充到「能連接任何你設定的外部工具」。你可以透過 MCP 讓 Claude Code 連接 issue tracker、文件系統、資料庫、內部 API 或其他團隊工具。
一個誠實的提醒：這些功能都在快速演進中。官方文件每幾週就會更新，社群也一直在貢獻新的 Skills 和 MCP 伺服器。建議先熟悉基本操作（CLI、CLAUDE.md、權限模式），等日常使用順了再逐步加入進階功能。先把核心流程跑順，再加外部工具。基礎不穩就直接堆功能，到頭來只會更混亂。
功能講了這麼多，你可能更想知道實際用起來到底怎樣。下面是我用 Claude Code 跑了三個真實任務的操作記錄，連同結果和需要修正的部分一起攤開給你看。
我用 Claude Code 實測 3 個任務：修 bug、補測試、改 README
前面談了很多功能，但實際用會發生什麼？以下是我用 Claude Code 處理三個真實任務的過程記錄。
測試環境：中型 Node.js 專案（約 8,000 行、45 個檔案），Pro 方案 + Sonnet 模型。我刻意挑了三種不同性質的工作，看它在不同情境下的表現。
| 任務 | 下達的指令 | 耗時 | 結果 | 我需要額外修正的部分 |
|---|---|---|---|---|
| 修 login 回傳 500 的 bug | 「login API 回傳 500，找出原因並提出修法，先不要改檔」 | 約 2 分鐘 | 正確定位到 middleware 裡一個未處理的 null check | 它提議的錯誤訊息格式跟專案慣例不同 |
| 替 password validation 補單元測試 | 「幫 src/lib/password.ts 補單元測試，覆蓋正常輸入、空值、特殊字元」 | 約 3 分鐘 | 產生 12 個測試，11 個直接通過 | 1 個 unicode 邊界條件誤判 |
| 更新過時 README | 「讀取目前的程式碼，把 README 更新成符合現況的版本」 | 約 4 分鐘 | 結構清楚、技術棧準確 | 加了一段不存在的「貢獻指南」 |
測試後的感想
- 三個任務加起來約 9 分鐘，同樣的工作手動處理大概要 40-50 分鐘。速度差距最明顯的是定位 bug 那段，它讀完相關檔案就直接指向問題所在的 middleware，省去了我手動 grep 的時間。
- 最讓我意外的是修 bug 那個任務。我下的是「先不要改檔」，它真的只給建議不動手，這種指令遵循度比我預期好。
- 最需要留意的反而是補測試。12 個測試通過 11 個聽起來不錯，但那 1 個失敗的測試如果沒跑過就送出去，會讓人誤以為是程式碼有問題而不是測試寫錯。這種「看起來合理但其實不對」的輸出，是最需要人工覆核的情境。
- 免責聲明：這不是嚴謹的基準測試，只是我在一個專案上的操作記錄。不同專案規模、不同模型、不同指令寫法，結果都會不一樣。
上面的測試結果也突顯了一件事：就算 AI 表現不錯，人類的覆核仍然不可少。很多新手在使用過程中踩的坑，其實都是可以避免的。
新手常犯的 5 個錯誤
用 Claude Code 一段時間後，我整理出五個最常見的踩坑模式。這些錯誤我都犯過。
- 一開始就下大任務。「重構整個專案」這種指令幾乎一定會出問題。AI 在缺乏上下文的情況下做大規模改動，出錯率非常高。從小任務開始，例如「這個 function 加個錯誤處理」，讓 AI 先熟悉你的 codebase 再逐步放大範圍。一次改一個變因，才看得出問題到底出在哪裡。
- 不同任務之間不清除對話。上一個任務的上下文會干擾下一個任務的判斷。切換工作時用
/clear清掉對話歷史，讓 AI 從乾淨的狀態重新理解你的需求。這不是浪費 token，是避免錯誤累積。 - 不設 CLAUDE.md。沒有專案規範檔，AI 每次都要猜你的慣例和限制。前面有提供範本，照著填就好，五分鐘的投資可以省下後面無數次的修正。
- 不看 diff 就接受修改。AI 改完能跑不代表改對了。它可能改了不該改的檔案、引入了不一致的命名、或者在邊界條件上偷懶。每次接受修改前，花 30 秒看 diff，養成習慣比事後補救便宜太多。
- 期待完全不用審查。把 Claude Code 當成一個能力很強但偶爾會犯低級錯誤的同事。你會讓一個新來的資深工程師不經 review 就直接 push 嗎？對待 AI 也一樣。
犯錯的成本可以透過習慣降低，但另一個很多人在用之前就開始擔心的問題是：我的程式碼交給 AI，安全嗎？
資料安全與隱私：你的程式碼安全嗎？
這是很多人在使用 AI 程式工具前最猶豫的問題：我的程式碼會不會被拿去訓練模型？答案取決於你用的帳號類型。
| 帳號類型 | 程式碼是否用於模型改善 | 說明 |
|---|---|---|
| Free / Pro / Max（消費者方案） | 由使用者設定決定 | 預設情況下可能用於模型訓練，但可以在帳號設定裡關閉。如果你用 Pro 方案處理公司程式碼，建議立刻去確認這個選項。 |
| Team / Enterprise / API（商業方案） | 不會 | 商業方案有明確的資料使用政策，程式碼不會被用於模型訓練。這也是為什麼公司導入時建議用 Team 或 Enterprise。 |
具體建議
- 公司專案用 Team 或 Enterprise 方案，不要用個人 Pro 帳號混著跑。
- 如果你用 Pro 方案，登入帳號後去 Settings 確認資料改善選項是否已關閉。
- 在專案根目錄的
.claude/settings.json設定權限，明確拒絕讀取.env、憑證檔案等敏感檔案。如果任務會碰到部署或伺服器設定，更要明確限制它能讀寫的範圍。 - 使用 Codex 時也要先處理好權限邊界，參考官方的 Codex Permissions 文件。
- 資料政策可能隨時間調整，實際使用前建議直接查閱 Anthropic 和 OpenAI 的官方隱私頁面，確保你看到的是最新版本。把定期檢查養成習慣。
安全問題搞清楚了，費用是另一個實際的考量。畢竟月費和使用量直接影響你會不會繼續用下去。
Claude Code vs Codex 費用怎麼看？
費用是選工具時的關鍵考量，但這兩個產品的計費邏輯不太一樣，直接比月費意義不大。
| 工具 | 入門方案 | 重度使用方案 | 費用判斷重點 |
|---|---|---|---|
| Claude Code | Pro $17-20/月 | Max 5x $100/月 Max 20x $200/月 | 先用 Pro 方案在小範圍試跑，觀察自己的實際用量再決定是否升級。用量取決於 session 上下文長度和對話輪數。 |
| Codex | Plus $20/月（也含在 Free/Go/Plus/Pro/Business/Enterprise 中） | Pro $100+/月 | 看你的方案是否包含 Cloud integration，以及 local/cloud/review 額度是否共用。免費方案的額度有限，重度使用幾乎一定要升級。 |
幾個提醒：
- 實際價格以官方定價頁為準，這裡的數字可能已經過時。
- 不要只看月費。Claude Code 的實際消耗取決於每次 session 的上下文長度，一個複雜重構任務可能吃掉大量額度；Codex 則要看 local task、cloud task、review 之間的額度分配。
- 養成用
/usage查看消耗、/compact壓縮上下文、/clear重置對話、/model切換模型的習慣，這四個指令是控制用量的基本功。知道用量花在哪裡，才有辦法控制成本。
個人使用門檻不高，但如果你的團隊也打算導入 AI coding agent，評估的面向會多好幾層。
團隊導入 Claude Code 或 Codex 前要評估什麼？
個人用和團隊用是兩回事。一個人踩坑自己扛，團隊踩坑是集體買單。導入前建議先過一次下面的評估表。底層邏輯很簡單：專案基礎越穩固，AI 能發揮的空間越大。
| 檢查項 | 可以導入的訊號 | 需要暫緩的訊號 |
|---|---|---|
| 專案狀態 | 有測試覆蓋、lint 規則、CI pipeline | 沒有測試、沒有文件、没人知道哪些功能還活著 |
| 權限治理 | 有 branch 保護、PR review 機制、部署審核 | 所有人直接 push main，沒有任何防線 |
| 任務類型 | bug fix、寫測試、更新文件、小功能 | 高風險架構改造、涉及付款或權限的重構 |
| 團隊習慣 | 成員願意逐行看 diff、理解改動原因 | 只想讓 AI 直接交付，不看過程 |
如果你的團隊在右欄的項目比較多，不是不能用 AI，而是要先補好基本設施再說。沒有測試的專案加上 AI 的速度，出錯也會變快。
導入初期做好三件事
- 用乾淨的 branch 跑，不要在 main 上直接讓 AI 動手。
- 限制 AI 的指令範圍，明確指定它可以動哪些檔案、不能動哪些。
- 所有 diff 經過人工 review 才合併，沒有例外。
還有一件事要定義好專案規範檔：用 Claude Code 就寫 CLAUDE.md，用 Codex 就寫 AGENTS.md。這個檔案是 AI 理解你們團隊慣例的入口，沒有它，AI 只能猜。如果你們團隊有特殊的程式碼、內容或部署規範，也要寫進去，AI 才不會在修改時破壞既有結構。
有一個限制要誠實說：在大型 legacy codebase 或缺少測試的專案裡，AI 的「自信」常常比正確率來得早。它會很篤定地給你一個看起來合理的改動，但如果你沒有測試可以驗證，那個「合理」可能只是表面上的。導入 AI 工具也需要同等程度的評估。沒有測試覆蓋就讓 AI 動手，風險特別高。
開始用 Claude Code 與 Codex 的建議流程
如果你讀到這裡，決定要開始試試看了，以下是建議的七步流程。
- 選一個低風險 repo。不要拿 production 的核心專案當實驗品。找一個即使改壞了也無所謂的 side project 或工具庫。
- 先選主要工具。本機開發用 Claude Code，雲端协作用 Codex。初期專注一個就好，同時學兩個會分散注意力。
- 寫清楚專案規範。建立
CLAUDE.md（Claude Code）或AGENTS.md（Codex），把專案架構、技術棧、命名慣例、不能碰的檔案都寫進去。 - 先做只讀任務。例如「幫我摘要這個專案的架構」或「這個 function 的用途是什麼」。讓你熟悉 AI 的理解能力，也讓 AI 建立對你專案的基本認知。
- 派一個小任務。例如「幫這個 function 加錯誤處理」或「補一個單元測試」。明確、小範圍、可驗證。
- 看 diff 與驗證結果。跑測試、看改動、確認沒有副作用。這一步不是可選的，是必要的。
- 用一週記錄成效。每天記錄用了什麼指令、花了多久、結果如何、修正了哪些錯誤。一週後你會有具體資料來判斷這個工具對你的價值。有記錄，才知道它到底有沒有幫你省時間。
立即可做的三件事
- 選一個低風險專案，只做架構摘要，先感受 AI 對你程式碼的理解程度。
- 建立專案規範檔（
CLAUDE.md或AGENTS.md），五分鐘就能完成。 - 用一週記錄成效，用資料說話而不是用感覺。
Claude Code 和 Codex 最有價值的地方，不是讓工程師放棄理解程式碼，而是讓工程師把時間花回判斷、設計和驗收。工具負責加速執行，人負責判斷方向、確認風險和決定是否接受改動。核心原則很簡單：工具是手段，不是目的。
常見問題（FAQ）
Claude Code 免費能用嗎？
不行。Claude Code 需要 Pro、Max、Team 或 Enterprise 方案。Pro 月費約 $17-20 USD，是目前最低門檻。Free 方案無法使用 Claude Code。
不會用終端機，能用 Claude Code 嗎？
可以。除了 CLI 之外，Claude Code 有 VS Code 擴充功能、Desktop App 和 Web 版。不熟悉終端機的操作者可以從 VS Code 擴充功能開始，介面比較友善。
公司專案的程式碼會被拿去訓練 AI 嗎？
商業方案（Team、Enterprise、API）不會。消費者方案（Free、Pro、Max）取決於你的帳號設定。用公司程式碼的話，建議直接用 Team 或 Enterprise，省得擔心。
CLAUDE.md 要寫什麼？
寫專案架構、技術棧、程式碼規範、不能碰的檔案。判斷標準很簡單：如果拿掉這個資訊，一個新來的工程師會不會犯錯？會的話就寫進去。
Claude Code 和 Codex 的費用差在哪？
Claude Code 跟 Claude 方案綁定（Pro/Max/Team/Enterprise），Codex 跟 ChatGPT 方案綁定（Plus/Pro/Business/Enterprise）。月費數字接近，但實際用量消耗邏輯不同，看你的使用模式和額度分配。
Claude Code 可以完全取代工程師嗎？
不建議這樣理解。需求判斷、架構取捨、安全審查、使用者體驗的權衡，這些都需要人類工程師。AI 擅長的是執行明確的技術任務，不是替代決策過程。
MCP 是什麼？
Model Context Protocol，一個讓 Claude Code 連接外部工具和資料來源的標準協定。透過 MCP，Claude Code 可以存取資料庫、API、檔案系統等外部資源，擴充它的能力範圍。
Claude Code 支援哪些 IDE？
VS Code（含 Cursor 等 VS Code 系編輯器）、JetBrains 全系列（IntelliJ、WebStorm、PyCharm 等）、以及獨立 CLI。幾乎涵蓋主流開發環境。
Claude Code 和 Codex 有什麼差別？
Claude Code 貼近本機 repo，在本地終端機裡運作；Codex 以 App/Cloud/GitHub 為中心，是平台化的 coding agent。一個偏本機深度操作，一個偏雲端協作，定位不同。
Claude Code 和 Codex 可以一起用嗎？
可以，但分工要清楚。例如用 Claude Code 處理本機的快速修改，用 Codex 跑雲端的批次任務。切記不要同時讓兩個工具改同一批檔案，衝突處理會比手動改還麻煩。
Claude Code 適合非工程師嗎？
可以試試看，從低風險任務開始，例如讀程式碼、寫文件。但涉及登入流程、付款邏輯、權限設定的修改，仍然需要工程師介入。AI 工具目前還無法替代對系統架構的完整理解。
Claude Cowork 和 Claude Code 差在哪？
Cowork 是 Claude Desktop 裡的視覺化協作介面，適合寫企劃、做研究、整理文件；Code 是專門的 coding agent，適合改程式碼、跑測試、操作檔案。寫企劃用 Cowork，改程式碼用 Code。
