Claude Code 完整教學 2026:安裝、CLAUDE.md 與 AI 開發工作流

Claude Code 完整教學 2026:從安裝到 AI 開發工作流

0 瀏覽
2026-05-30 更新
Claude Code 完整教學 2026:從安裝到 AI 開發工作流封面

Claude Code 是 Anthropic 推出的 AI coding agent。它不只是聊天機器人,而是可以讀取專案、修改檔案、執行指令、跑測試、整理 Git 變更,甚至透過 MCP 串接外部工具的開發助手。這篇 Claude Code 完整教學會用 2026 年的使用情境,帶你看懂它適合誰、怎麼安裝、怎麼設定 CLAUDE.md,以及如何把它放進真正的 AI 開發工作流。

如果你已經用過 ChatGPT、Claude 網頁版、Cursor、GitHub Copilot CLI 或 OpenAI Codex,Claude Code 的差異在於:它更接近「可以進入專案做事的代理」,而不是只在旁邊給建議的問答工具。

Claude Code 是什麼?

Claude Code 是一個可以在終端機、IDE、桌面 App 和瀏覽器中使用的 agentic coding tool。根據 Anthropic 官方文件,它可以讀取你的 codebase、編輯檔案、執行命令,並和開發工具整合。簡單說,它不是只回答「這段程式碼怎麼寫」,而是可以直接參與「找問題、改檔案、跑驗證、整理提交」這整段流程。

  • 可以理解整個專案,而不是只看單一片段。
  • 可以跨多個檔案修改功能或修 bug。
  • 可以執行測試、lint、build 等終端機指令。
  • 可以協助整理 git diff、commit message、PR 說明。
  • 可以透過 MCP、hooks、skills、記憶檔案和團隊工作流整合。

這也是為什麼 Claude Code 很適合工程師、WordPress 外掛開發者、AI 自動化顧問、技術 SEO、內部工具開發者,以及需要長時間維護專案的人。

Claude Code 適合哪些人?

Claude Code 不是完全零基礎新手的第一個 AI 工具。它更適合已經知道專案、檔案、Git、終端機是什麼的人。如果你只是想寫文章、整理資料、做摘要,先用 Claude 網頁版就夠了;如果你想讓 AI 直接進入專案幫你改東西,Claude Code 才開始有價值。

使用者類型適合程度建議用途
完全不懂程式的新手先從 Claude 網頁版、ChatGPT 或教學文章開始
前端 / 後端工程師修 bug、寫測試、重構、整理 PR
WordPress 開發者外掛開發、REST API、WooCommerce 客製、主題除錯
技術 SEO / 自動化顧問建立 CLI 工具、資料處理、內容發布流程自動化
產品經理 / 企劃適合用 Web 或 Desktop 啟動任務,但仍需工程判斷

如果你想先建立 AI CLI 的整體觀念,可以先看我之前整理的 從 ChatGPT 到 Claude Code CLI:四階段進化路線圖。那篇比較像地圖,這篇則專注在 Claude Code 本身。

Claude Code 安裝方式

Claude Code 目前有多種安裝和使用方式,包含 native installer、Homebrew、WinGet、VS Code、JetBrains、Desktop App 和 Web。一般工程師最常見的入口還是終端機。

macOS、Linux、WSL 安裝

curl -fsSL https://claude.ai/install.sh | bash

Homebrew 安裝

brew install --cask claude-code

如果你使用 Homebrew,要注意它不會自動更新,需要自己執行升級指令。官方文件也提到 stable 版通常會比最新 release 慢一點,但相對比較保守。

Windows 安裝

Windows 使用者可以透過 PowerShell 或 CMD 安裝。官方也建議原生 Windows 環境安裝 Git for Windows,這樣 Claude Code 才能使用 Bash 工具;如果沒有 Git for Windows,Claude Code 會改用 PowerShell 當 shell tool。

irm https://claude.ai/install.ps1 | iex

安裝完成後,在你的專案資料夾執行:

cd your-project
claude

第一次啟動時會要求登入 Claude 帳號。完成後,你就可以在目前專案中和 Claude Code 對話。

第一次使用 Claude Code:先不要急著叫它改程式

很多人第一次打開 Claude Code,就直接輸入「幫我重構整個專案」。這通常不是好開始。比較穩的做法是先讓它讀懂專案,再從小任務開始。

第一步:請它探索專案

請先閱讀這個專案的目錄結構、README、package.json 或主要入口檔,
整理出這個專案的用途、技術棧、啟動方式和測試方式。
先不要修改任何檔案。

這個 prompt 的重點是「先不要修改任何檔案」。你要先看它是否真的理解專案,而不是一開始就放它動手。

第二步:請它找出可驗證的工作流

請找出這個專案如何執行 lint、test、build。
如果文件沒有寫,請從設定檔推測,並說明你的依據。
先不要安裝套件,也不要執行會改動外部服務的指令。

好的 Claude Code 工作流,一定要有驗證方式。沒有驗證,AI 改完程式看起來很漂亮,但你不知道它是不是真的能跑。

第三步:從小 bug 或小功能開始

這個按鈕點擊後沒有反應。
請追蹤可能的原因,提出修改計畫,等我確認後再改檔案。
修完後請執行相關測試,並整理修改了哪些檔案。

這種任務比「幫我優化整個專案」好很多,因為範圍清楚、結果可驗證,也比較容易累積信任。

CLAUDE.md 是什麼?為什麼一定要建立?

CLAUDE.md 是放在專案根目錄的指令檔。Claude Code 會在 session 開始時讀取它,用來理解專案規範、常用指令、架構決策、禁止事項和偏好。官方 Help Center 也把 /init 視為第一天使用 Claude Code 時很重要的設定步驟。

/init

執行後,Claude Code 會協助產生 CLAUDE.md。你也可以手動補上更明確的規則,例如:

# Project Instructions

- Always read existing patterns before editing.
- Use npm run lint and npm test before final response.
- Do not modify production database commands.
- Prefer small scoped changes over large refactors.
- For WordPress work, preserve Gutenberg block comments.
- When adding content, use Traditional Chinese for iambigd.tw.

這個檔案的價值很高。你不用每次都重新交代「這個專案怎麼跑」、「不要動哪些檔案」、「文章要用繁體中文」、「改完要跑什麼測試」。長期看,CLAUDE.md 會直接影響 Claude Code 的穩定度。

Claude Code 常見工作流

Claude Code 最好用的地方不是單次問答,而是把開發任務拆成可執行、可檢查、可回滾的工作流。

1. 修 bug

這是錯誤訊息:
<貼上錯誤訊息>

請找出根因,列出可能原因,優先檢查最小範圍。
修完後執行相關測試,並說明驗證結果。

這是最適合入門的工作流。因為錯誤訊息通常有線索,Claude Code 可以沿著 stack trace、測試、設定檔和實作一路追。

2. 寫測試

請找出目前 auth module 的測試缺口。
先列出你會補哪些測試案例,等我確認後再實作。
完成後請執行測試並修正失敗。

寫測試很適合交給 Claude Code,但要讓它先說明測試策略。不要直接叫它「補測試」,不然可能會補出很多看起來有覆蓋、實際上沒有防護力的測試。

3. 重構

請分析這個 module 是否有重複邏輯或責任混雜。
先提出最小重構方案,不要改變外部 API。
重構完成後請跑測試並比較 git diff。

重構是 Claude Code 的強項,也是風險比較高的工作。重點是限制範圍,並要求「不要改變外部 API」。

4. Git、commit、PR 整理

請檢查目前 git diff,整理這次修改的重點。
幫我產生一個符合專案風格的 commit message。
不要 stage 檔案,先讓我確認。

Claude Code 可以協助 git 操作,但我建議初期先讓它「整理與建議」,不要一開始就讓它自動 stage、commit、push。等你熟悉它的判斷後,再逐步放寬。

MCP、Hooks、Skills:Claude Code 進階能力怎麼理解?

Claude Code 的強大之處在於它可以被擴充,不只是單純讀本機檔案。

MCP:把外部資料接進來

MCP 是 Model Context Protocol,可以讓 AI 工具連接外部資料源或服務。舉例來說,Claude Code 可以透過 MCP 讀設計文件、查 GitHub issue、連資料庫、拿 Google Drive 文件,或接你自己的內部工具。

如果你想理解 MCP、Agent、Skills 的差異,可以延伸看 什麼是 AI Skills?MCP、Agent、Sub-agent 完整比較指南

Hooks:在動作前後自動跑規則

Hooks 可以在 Claude Code 做某些事情前後自動執行指令。常見用法包含改完檔案後自動 format、commit 前跑 lint、或在危險操作前要求額外檢查。

Skills:把可重複工作流程包起來

Skills 適合把某種固定工作流程封裝起來,例如「發布 WordPress SEO 文章」、「檢查 WooCommerce 商品欄位」、「處理 GitHub PR review」。對團隊來說,Skills 的價值在於把個人經驗變成可重複使用的工作方法。

Claude Code vs Codex、Cursor、GitHub Copilot CLI 怎麼選?

這幾個工具常被放在一起比較,但它們不是完全同一類產品。

工具主要場景特色
Claude Code專案級 agent 工作流適合跨檔案修改、長任務、MCP、CLAUDE.md、團隊流程
OpenAI CodexCLI / Desktop coding agent適合和 ChatGPT 生態系整合,也適合做 review、修 bug、平行工作
CursorIDE 內寫程式適合習慣在編輯器裡用 AI 補完、修改、解釋程式碼的人
GitHub Copilot CLIGitHub 與 shell 指令輔助適合問指令、解釋 git、快速處理開發者日常命令

我的建議是:如果你重度使用終端機、常常需要 AI 幫你改整個專案,Claude Code 很值得學;如果你偏向 IDE 內即時補完,Cursor 會更直覺;如果你已經在研究 Codex,可以接著看 OpenAI Codex 桌機版是什麼?

Claude Code 實戰:WordPress 開發可以怎麼用?

以我自己的工作情境來看,Claude Code 很適合用在 WordPress 開發與營運自動化。因為 WordPress 專案通常同時包含 PHP、JavaScript、REST API、ACF、WooCommerce、SEO metadata、主題模板和外掛邏輯,很容易需要跨檔案理解。

  • 檢查外掛 PHP class 的責任分工。
  • 追蹤 WooCommerce 商品欄位沒有同步的原因。
  • 替 WordPress REST API 工具補 CLI 指令。
  • 把文章發布流程整理成可重複的 skill。
  • 檢查 Gutenberg HTML 是否被轉成 Classic Block。
  • 處理 Rank Math、FAQ Schema、內部連結、分類標籤更新。

如果你對這類工作流有興趣,也可以看我之前的 如何用 AI 助手管理 WordPress 網站?,那篇更偏實際營運面。

使用 Claude Code 的安全原則

Claude Code 很強,但越強的工具越需要邊界。尤其它可以執行指令、改檔案、串外部工具,如果沒有規則,反而容易讓專案變亂。

  • 先讀再改:要求 Claude Code 先理解專案,不要一開始就修改。
  • 小步提交:一次只處理一個明確任務,不要把重構、功能、格式化混在一起。
  • 每次都驗證:能跑 test 就跑 test,不能跑也要說明原因。
  • 保護外部系統:資料庫、部署、金流、API 寫入都要額外確認。
  • 保留人工 review:AI 可以加速,但最後判斷仍然是人負責。

我的習慣是:只要任務會影響正式資料、客戶網站或不可逆操作,就一定要求它先列計畫,再確認執行。這不是不信任 AI,而是讓 AI 的能力進入工程流程。

Claude Code 學習路線建議

如果你要真的把 Claude Code 用起來,我會建議照這個順序,不要一口氣追所有進階功能。

  1. 先安裝並登入 Claude Code。
  2. 在一個小型 side project 裡執行 /init
  3. 請它閱讀專案並整理技術棧,不修改檔案。
  4. 交給它一個小 bug 或小功能。
  5. 要求它修改後執行測試,並整理 git diff。
  6. 把常用規則寫進 CLAUDE.md。
  7. 再開始研究 MCP、hooks、skills 和多 agent 工作流。

這樣學會比單純背指令更有效,因為 Claude Code 的核心不是指令清單,而是「如何把 AI 放進可驗證的開發流程」。

結論:Claude Code 的價值在於工作流,不只是模型能力

Claude Code 真正值得學的地方,不只是它背後模型有多強,而是它把 AI 從聊天框帶進專案現場。它可以讀 codebase、改檔案、跑指令、整理 git、連接外部工具,讓 AI 從「給建議」變成「一起完成任務」。

但也因為它能做的事更多,你更需要建立規則:先讀再改、先計畫再執行、小步驗證、保護正式環境。只要工作流設計得好,Claude Code 會是工程師、WordPress 開發者和 AI 自動化工作者很值得投資的工具。

常見問題 FAQ

Claude Code 是免費的嗎?

Claude Code 通常需要 Claude 帳號或 Anthropic Console 帳號,實際可用方案、額度和價格會依官方最新規則調整。建議使用前先到 Claude 官方頁面確認目前方案,並設定用量控制,避免長任務造成超出預期的成本。

Claude Code 和 Claude 網頁版有什麼不同?

Claude 網頁版比較像聊天與文件工作區,適合寫作、摘要、分析資料。Claude Code 則是 coding agent,可以進入專案、讀檔案、改程式、跑命令、整理 Git 變更,更適合開發工作流。

不會寫程式可以用 Claude Code 嗎?

可以嘗試,但不建議把它當第一個 AI 工具。Claude Code 需要你理解專案、檔案、終端機和 Git 的基本概念。完全新手可以先用 Claude 網頁版、ChatGPT 或 Cursor,再慢慢進到 Claude Code。

Claude Code 會不會直接弄壞我的專案?

如果沒有規則和驗證,任何 coding agent 都可能改錯。因此建議一定要使用 Git、要求它先提出計畫、限制任務範圍,並在修改後執行 test、lint 或 build。正式資料庫、部署、金流和外部 API 寫入都要額外確認。

Claude Code 適合 WordPress 開發嗎?

很適合。WordPress 專案常涉及 PHP、JavaScript、REST API、ACF、WooCommerce、SEO metadata 和主題模板,Claude Code 可以協助跨檔案理解與修改。不過更新正式網站前仍要有備份、測試和人工 review。

參考資料

▧ 文章分類

▧ Google熱蒐文章

▧ 最新文章

✦ 虎鯨 OrcaBiz SEO 優化專業團隊 ✦

專業 SEO 公司幫助你將流量累積成看得見的業績,成為長期有效的最強業務!

[orca_infinite_scroll]