Physical Address
304 North Cardinal St.
Dorchester Center, MA 02124
2026 Claude Code 完整教學：從安裝設定到進階工作流，掌握 AI 智能體編碼
Claude Code 是 Anthropic 推出的 AI 編碼工具。這篇教學整理 2026 年安裝方式、CLAUDE.md 設定、權限管理、工作流程、資料隱私與適合族群，幫助開發者判斷是否導入。
Claude Code 是 Anthropic 推出的 AI 編碼助手，能夠讀取整個程式碼庫、編輯檔案、執行終端機指令、操作 git，甚至幫你建立 Pull Request。它最適合已經習慣在終端機工作的開發者；如果你只需要簡單的程式碼補全，GitHub Copilot 或 Cursor 可能更輕量好上手。
這篇教學會從 Claude Code 的基本概念開始，一路帶你走過安裝設定、CLAUDE.md 調校、權限管理、五種實用工作流程，到進階的多實例協作與無頭模式自動化。不管你是剛聽說這個工具，還是已經用了一段時間想學更多技巧，都可以在這裡找到你需要的内容。
目錄
Claude Code 是什麼？為什麼開發者都在討論它
Claude Code 是一款能夠讀寫程式碼庫、執行 shell 指令並串接開發工具的 AI 編碼助手。依 Claude Code 官方說明，它現在不只存在於終端機，也能在 VS Code、JetBrains、桌面 App 和網頁環境中使用。跟單純的聊天機器人不同，Claude Code 的核心價值在於把 AI 放進你現有的開發流程：讀檔案、改程式碼、跑測試、看錯誤訊息、整理 commit，然後由你來決定哪些變更要保留。
它的可組合度很高。你可以用 CLAUDE.md 設定專案記憶，用權限規則控制它能做什麼，用 MCP、hooks、skills 或 CLI 指令把它接進團隊流程。這些彈性讓它不只是另一個程式碼補全工具，而是一個可以深度融入日常工作流的 AI 夥伴。如果你之前用過 AI Text Classifier 這類工具來偵測 AI 產出的文字，或是用 ChatYouTube 跟 YouTube 影片互動，那你對「AI 工具融入日常工作」這件事應該不陌生，Claude Code 把同樣的概念帶進了程式開發領域。
開發 Claude Code 的 Anthropic，正是打造 Claude 系列模型 的同一間公司。如果你之前用過 ChatGPT 或其他 AI 聊天工具，可以把 Claude Code 想像成「AI 助手走進了你的終端機」。它能觸及的不只是目前開啟的檔案，而是整個程式碼庫加上終端機環境，再加上你接進來的各種外部工具。
跟其他 AI 編碼工具的比較
很多人會問：Claude Code 跟 GitHub Copilot、Cursor 到底差在哪裡？其實三者的定位不太一樣。Copilot 比較像一個隨插即用的 IDE 外掛，主打行內補全和簡單問答；Cursor 是基於 VS Code 改造的獨立 IDE，有自己的 Agent 模式。Claude Code 則以終端機為核心，可觸及的上下文範圍最廣，能讀整個程式碼庫、跑 shell 指令，也能完整操作 git。想知道更多 AI 工具的差異，可以參考我們之前整理的 AI 檢測工具比較。
| 面向 | Claude Code | GitHub Copilot | Cursor |
|---|---|---|---|
| 運作環境 | 終端機為核心，也支援 IDE、桌面與 Web | IDE 內嵌 | 獨立 IDE（VS Code 改版） |
| 互動方式 | 自然語言指令 + 工具呼叫 | 行內補全 + Chat | 行內補全 + Chat + Agent |
| 上下文範圍 | 程式碼庫、終端機環境與外部工具 | 目前檔案 + 開啟的分頁 | 整個專案 |
| 能否執行指令 | 可以（bash） | 有限 | 可以（Agent 模式） |
| git 整合 | 完整（commit, PR, issue） | 基本 | 基本 |
| 自訂空間 | CLAUDE.md + settings + MCP + hooks + skills | 有限 | .cursorrules |
| 費用 | 需支援 Claude Code 的付費方案或 Console | 免費版 + 付費版 | 免費試用 + 付費版 |
| 適合族群 | 習慣終端機的開發者 | 所有人 | 喜歡圖形介面的開發者 |
截至 2026 年 5 月。Claude Code、Copilot 和 Cursor 都在快速更新，定價與功能請以各工具官網為準。
Claude Code 安裝與初始設定完整教學
安裝 Claude Code 的第一步，是選擇適合你環境的安裝方式。2026 年官方推薦先用 Claude Code 官方安裝文件 列出的原生安裝器，它會自動處理二進位檔、背景更新和各平台之間的差異，適合大多數使用者。
以下是各平台的安裝指令：
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
# macOS 也可以用 Homebrew
brew install --cask claude-code
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Windows WinGet
winget install Anthropic.ClaudeCode如果你偏好用 npm 全域安裝，仍然可行，但這比較像進階或特定環境的需求。npm 版需要 Node.js 18 以上，而且不建議用 sudo npm install -g，避免權限和安全問題。
npm install -g @anthropic-ai/claude-code安裝完成後，進入你要處理的專案目錄再啟動 Claude Code。這一步很重要，因為 Claude 會以目前目錄作為工作範圍，後續的讀檔、改檔、跑測試都跟這個位置有關。如果你還沒有適合的測試專案，不妨用 Blogger 或 Blogspot 先建一個簡單的部落格專案來練習，熟悉操作流程後再搬到正式專案。
cd your-project
claude首次啟動會引導你完成登入授權。Claude Code 需要 Pro、Max、Team、Enterprise 或 Claude Console 帳號，免費的 Claude.ai 方案不包含 Claude Code 存取權。如果你的團隊使用 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry，也可以走第三方供應商驗證。企業環境有時會遇到防火牆或代理伺服器問題，這時可以參考我們之前討論過的 Cloudflare 相關設定，或看看 VPN 在開發場景中的重要性。
如果你的專案在 GitHub 上，強烈建議安裝 gh CLI。Claude Code 能直接用它建立 issue、PR 和讀取評論，省去不少手動操作的麻煩：
# macOS
brew install gh
gh auth login啟動後輸入 /init 可以讓 Claude 掃描專案並產生初始的 CLAUDE.md。這是新專案最值得先做的一步，後續的指令、測試方式和程式碼風格都可以從這份檔案開始累積。就像架設 WordPress 網站時我們會建議先用 DemosWP 示範站做沙盒測試一樣，先用 /init 建立基礎再往下走，會順利很多。
CLAUDE.md 實戰指南：讓 AI 真正理解你的專案
CLAUDE.md 是 Claude Code 最核心的專案記憶檔。每次對話開始時，Claude 會讀取這個檔案，理解你的建置指令、測試方式、程式碼風格和團隊習慣。依 官方最佳實踐 的建議，它應該短、清楚、可維護，而不是把整份文件庫塞進去。
說白一點，CLAUDE.md 的本質就是一段長期生效的 prompt。不是寫越多越好，而是保留「Claude 讀程式碼也猜不到」的資訊，例如測試入口、部署限制、非典型架構和團隊慣例。偶爾才會用到的流程，改用 skills 或文件連結處理，避免每次對話都塞進上下文佔空間。
可以放什麼進去
- 常用的建置、測試、部署指令
- 程式碼風格規範（例如用 ES Module 而非 CommonJS）
- 核心檔案和工具函式的位置
- 分支命名規則、merge 或 rebase 偏好
- 開發環境注意事項（例如 pyenv 版本、編譯器路徑）
- 任何「非預期行為」的提醒
放在哪裡
| 位置 | 作用範圍 | 建議 |
|---|---|---|
./CLAUDE.md（專案根目錄） | 這個專案的所有工作階段 | 存入 git，跟團隊共享（推薦） |
./CLAUDE.local.md | 同上，但不進版控 | 放個人偏好，加入 .gitignore |
~/.claude/CLAUDE.md | 所有專案的所有工作階段 | 放全域偏好（例如預設語言、常用工具） |
子目錄的 CLAUDE.md | 處理該子目錄時自動載入 | 適合 monorepo，各套件獨立說明 |
實際範例
# 建置指令
- npm run build：建置專案
- npm run typecheck：執行型別檢查
- npm run test：執行單元測試
# 程式碼風格
- 使用 ES Module（import/export），不用 CommonJS（require）
- 盡可能解構匯入（例如：import { foo } from 'bar'）
# 工作流程
- 完成程式碼變更後務必跑型別檢查
- 優先跑單一測試，而非整個測試套件
- commit 前先確認 lint 通過調校 CLAUDE.md 的過程有點像在寫一份給新同事看的 onboarding 文件。你不需要把所有東西都塞進去，只要涵蓋「不寫下來就沒人知道」的那些慣例就好。這跟我們在做 結構化資料測試 時會把測試案例寫清楚是同樣的道理，讓後續接手的人（或 AI）能快速理解專案的眉角。如果你平常會用 Free Download Manager 之類的工具管理檔案傳輸，那種「先把規則設好，後面就省事」的邏輯完全一樣。
權限管理：在效率與安全之間取得平衡
Claude Code 預設採取保守策略：任何可能修改系統的操作（寫檔案、執行 bash 指令、呼叫 MCP 工具等），都會先詢問你是否同意。這是刻意設計的安全機制，不是在故意拖慢你的速度。
你可以透過四種方式調整允許清單：
- 對話中被提示時選「永遠允許」，最直覺的方式。
- 使用
/permissions指令，在啟動後隨時新增或移除。例如允許檔案編輯：Edit；允許 git 提交：Bash(git commit *)。 - 手動編輯
.claude/settings.json，適合需要跟團隊共享權限設定的情境。建議將這個檔案納入版控。 - 使用
--allowedTools旗標，在啟動時就指定這次對話允許的工具。
如果專案裡有 .env、金鑰、客戶資料或建置產物，不要只在 CLAUDE.md 寫「請不要讀」。比較可靠的做法，是依 官方設定文件 使用 permissions.deny，讓這些路徑從搜尋與讀取操作中被排除。這跟網站安全防護的概念一樣，用 HeaderScan 掃描 HTTP 標頭或用 Cloudflare Turnstile 防機器人，都是「預設擋住、白名單放行」的邏輯。
claude --dangerously-skip-permissions 可以關閉所有權限檢查，讓 Claude 全自動執行。這對修 lint 錯誤或產生樣板程式碼很方便，但也伴隨實際風險：資料遺失、系統損壞、甚至透過提示注入攻擊導致資料外洩。如果真的要用，請在沒有網路存取的容器環境中執行。
五個最實用的 Claude Code 工作流程
Claude Code 不強迫你用特定方式工作，但從 官方工作流程範例 和實務經驗來看，以下五種模式最容易讓它穩定產出有用結果。你可以根據任務類型選擇適合的流程。
1. 探索、規劃、編碼、提交
這是最通用的流程，適合大多數開發任務。先讓 Claude 閱讀相關檔案，明確告訴它「先不要寫程式碼」。對於複雜問題，善用子智能體（subagent）來調查細節，可以在不損失效率的情況下保留上下文空間。接著要求 Claude 制定計畫，使用「think」這個詞可以觸發擴展思考模式，思考深度可以遞增：「think」小於「think hard」小於「think harder」小於「ultrathink」。
確認計畫合理後，再要求 Claude 實作。可以在實作過程中要求它驗證各部分的合理性。完成後提交並建立 PR，這也是讓 Claude 更新 README 或變更日誌的好時機。
為什麼前期的探索和規劃很重要？因為沒有準備就讓 Claude 直接寫程式碼，它會傾向跳到結論。有時候這正是你要的，但對於需要深入思考的問題，先研究再動手能明顯提高成功率。這跟我們在處理 500 Internal Server Error 或 502 Bad Gateway 這類伺服器問題時一樣，先看日誌、理解錯誤原因，再動手修，比盲目改設定有效得多。
2. 測試驅動開發（TDD）
這是 Anthropic 內部偏好的工作流，特別適合可以用測試驗證的變更。先告訴 Claude 根據預期的輸入輸出對編寫測試，明確表示你在做 TDD，避免它建立模擬實作。讓 Claude 執行測試，確認它們如預期失敗。對測試滿意後先提交測試，再要求 Claude 編寫能通過測試的程式碼，指示它不要修改測試。通常需要幾次迭代，但當 Claude 有清晰的目標可以迭代時（測試案例、視覺模型、預期輸出），它的表現會最好。如果你對 TDD 還不熟悉，可以先看看 WordPress SEO 外掛 的測試案例，了解自動化測試的基本概念。
3. 視覺反覆迭代
不只是測試，你也可以給 Claude 一個視覺目標。先給 Claude 一個取得瀏覽器截圖的方法（例如 Puppeteer MCP 參考實作），然後提供一張設計稿或目標畫面的截圖，要求 Claude 在程式碼中實作，截圖比對結果，反覆迭代直到符合。
Claude 的輸出經過 2 到 3 次迭代後通常會顯著改善。給它查看自己成果的工具，就能得到最好的結果。這跟用 ClipDrop 放大圖片 或 AI Image Enhancer 增強照片時的邏輯類似，多跑幾次迭代，品質會越來越好。
4. 程式碼庫問答
接手新的程式碼庫時，Claude Code 是極好的學習工具。你可以像問同事一樣問它：「這個專案的日誌系統是怎麼運作的？」「我該怎麼新增一個 API 端點？」「foo.rs 第 134 行的 async move 是在做什麼？」Claude 會自動搜尋程式碼庫來回答。在 Anthropic 內部，這已經成為核心的上手流程。
這個功能對於維護大型專案特別有用。就像你接手一個陌生的 WordPress 網站時，會需要 ChatDOC 分析 PDF 文件來看需求規格，或是用 ChatPDF 快速理解技術文件一樣，Claude Code 能幫你快速掌握一個陌生程式碼庫的架構和運作邏輯。跟 ChatGPT 線上聊天工具 比起來，Claude Code 的差別在於它能直接存取你的檔案系統，問答的精準度高出許多。
5. Git 與 GitHub 操作
許多 Anthropic 工程師超過 90% 的 git 互動都透過 Claude Code 完成。你可以讓它搜尋 git 歷史、撰寫提交訊息、處理複雜操作（還原檔案、解決 rebase 衝突、比較和移植補丁），以及建立 PR、回應程式碼審查意見、修復失敗的建置、分類開放的 issue。
Claude 會自動查看你的變更和近期歷史，產生考慮周全的 commit message。這在處理像 503 Service Unavailable 或 504 Gateway Timeout 這類修復問題的 PR 時特別好用，因為它能清楚說明修了什麼、為什麼這樣修。
進階技巧：多實例協作、無頭模式與 MCP 整合
多個 Claude 同時工作
一些最強大的應用場景，來自同時執行多個 Claude Code 實例。核心概念很簡單：讓一個 Claude 寫程式碼，用另一個 Claude 審查或測試。基本做法是用 Claude #1 寫完程式碼，執行 /clear 或在另一個終端機分頁啟動 Claude #2 來審查，再用 Claude #3 讀取程式碼和審查意見進行修改。
更有效的做法是搭配 git worktree。Git worktree 讓你把同一個儲存庫的不同分支 checkout 到不同目錄，每個 worktree 都有獨立的工作目錄但共享 Git 歷史。你可以讓一個 Claude 重構認證系統，另一個建構資料視覺化元件，互不干擾。這在處理像 WordPress 佈景主題推薦 這類多工並行的場景時特別好用，一個實例負責前端版型調整，另一個處理後端功能開發。
git worktree add ../project-feature-a feature-a
cd ../project-feature-a && claude無頭模式與自動化
claude -p（無頭模式）可以將 Claude Code 整合到 CI/CD 流程、pre-commit hook 或建置腳本中。兩種常見模式：扇出（Fan-out）是讓 Claude 產生任務清單，然後逐一以程式化方式呼叫 Claude 執行每個任務，適合大型遷移或批次分析；管線化（Pipelining）是把 Claude 的輸出串接到其他工具，例如 claude -p "分析這段日誌" --json | your_command。
MCP、Hooks 與 Skills
Claude Code 支援 MCP（Model Context Protocol）、hooks、skills 和自訂斜線指令。你可以把常用的除錯流程、日誌分析模板或部署檢查變成可重複使用的工具，讓 Claude 不只回答問題，也能照團隊流程做事。
MCP 讓 Claude Code 能連接外部工具和資料來源，例如資料庫、瀏覽器自動化、API 服務等。Hooks 則是在特定事件觸發時自動執行的腳本，例如在每次 commit 前自動跑 lint 檢查。這些功能讓 Claude Code 的可擴展性遠超過單純的 AI 聊天工具。就像 A2 Hosting 或 Bluehost 這類主機服務提供了豐富的擴充功能一樣，Claude Code 的生態系也正在快速成長。你也可以把 Claude Code 和 DesignEvo 線上 Logo 設計 這類設計工具搭配使用，讓 AI 幫你處理前端的視覺實作。
台灣開發者必看的在地化注意事項
台灣開發者在使用 Claude Code 時，有幾個特別值得注意的地方。費用方面，依 Claude 方案價格頁，Pro 月繳價格為 20 美元，年繳折扣後約每月 17 美元，Max 方案從每月 100 美元起。Claude Code 也可透過 Team、Enterprise 或 Console 使用，購買前仍要以結帳頁顯示的稅金、幣別與方案限制為準。
中文互動方面，Claude Code 可以用中文溝通，也能要求輸出繁體中文註解或文件。不過函式名稱、錯誤訊息、套件名稱和終端機指令建議保留英文，模型比較不會誤解技術上下文。網路連線上，Claude Code 需要穩定網路連線，公司防火牆、代理伺服器或第三方雲端模型供應商可能需要額外設定，企業導入前要先確認網路政策。就像你在設定 Cloudflare 速度測試 或檢查 FastSend 檔案傳輸 連線品質時一樣，穩定的網路環境是一切運作的基礎。
資料隱私方面，Claude Code 會把必要上下文送到模型服務處理。依 Claude Code 資料使用政策，消費者帳號和商業帳號的訓練與保留規則不同。如果專案含個資、商業機密或客戶程式碼，建議用商業帳號、明確關閉不必要資料分享，並在 .claude/settings.json 用 permissions.deny 排除敏感檔案。就像選擇 Bluehost WordPress 主機時會在意資料中心位置和安全性一樣，使用 AI 工具時也要注意資料流向。
如果你是 WordPress 開發者，Claude Code 搭配 InstaWP 可以先在沙盒中測試 AI 產生的程式碼。如果需求文件是 PDF，也可以先用 LightPDF ChatDOC 整理規格，再交給 Claude Code 拆任務。挑選網域名稱時可以善用 網域購買指南 和 TLD 清單，把前置作業先做好再交給 AI 處理。想在本地架測試環境，可以參考 5GBFree 免費空間 或 69Run 這類免費託管方案，先把基礎環境準備好。
Claude Code 的限制與常見問題排解
任何工具都有它的限制，Claude Code 也不例外。了解這些限制不是要嚇跑你，而是幫你設定正確的期待，遇到問題時能更快找到解法。
上下文視窗有限：長時間對話後，Claude 的上下文會被填滿不相關的內容。善用 /clear 在任務之間重置，就像你處理 WordPress 速度優化 時會定期清除快取一樣，保持上下文乾淨才能維持效能。
不是每次都一次成功：Claude 的第一次嘗試不一定完美。及早且頻繁地修正方向，比放任它跑到底更能得到好結果。你可以隨時按 Escape 中斷、連按兩下 Escape 跳回歷史修改指令、或要求它復原變更。這跟處理 ERR_NAME_NOT_RESOLVED DNS 錯誤時的思路一樣，先確認方向對了再往下走。
提示注入風險：如果你讓 Claude 讀取不受信任的檔案或網頁，理論上可能被注入惡意指令。在處理外部來源時保持警覺，特別是在處理使用者貢獻的程式碼或文件時。
用量可能很快累積：大型程式碼庫、多實例協作和自動化任務會消耗更多 token。Pro 和 Max 使用者主要看方案用量；Console 或企業導入則要追蹤 API 成本與速率限制。建議先從單一專案和單一任務開始，觀察 /usage 或方案用量，再決定是否升級。就像 WordPress 快取外掛能幫你節省伺服器資源一樣，合理管理 Claude Code 的用量也能讓你的訂閱更划算。
需要學習曲線：雖然 CLI 介面簡單，但要發揮最大價值，你需要學會寫好 CLAUDE.md、管理權限、善用子智能體。初期投資時間是必要的。就像學會用 SaveFrom 下載影片 或 Free YouTube Download 管理檔案一樣，一開始可能要摸索一下，但熟了之後效率提升是顯而易見的。
功能持續演進：Claude Code 還在快速開發中，安裝方式、支援平台、權限模式與資料政策都可能變動。教學文定期回查 官方文件 才能確保資訊是最新的。
Claude Code 常見問題 FAQ
Claude Code 可以在 Windows 上使用嗎？
可以。Claude Code 目前可在 native Windows 或 WSL 中使用。Windows 原生專案可以走 PowerShell、CMD、Git Bash 或 WinGet；如果你的專案本來就在 Linux 工具鏈、Docker 或 WSL 環境中，則在 WSL 裡安裝會更自然。就像你可以用 AnyConv 線上轉檔 在不同格式之間轉換一樣，Claude Code 也支援跨平台運作，只是體驗會因為環境不同而有差異。
CLAUDE.md 和 .cursorrules 有什麼不同？
功能定位類似，都是讓 AI 理解專案背景的設定檔。但 CLAUDE.md 是 Claude Code 專屬的，支援多層級放置（全域、專案根目錄、子目錄），而且可以存入 git 跟團隊共享。如果你同時使用 Cursor 和 Claude Code，兩邊的設定檔需要分別維護。
Claude Code 會把我的程式碼拿去訓練模型嗎？
不能一概而論。消費者帳號（Free、Pro、Max）要看資料改善設定是否開啟；Team、Enterprise、API、第三方平台和 Claude Gov 等商業情境，Anthropic 文件說明預設不會用商業條款下送出的程式碼或提示訓練生成模型，除非客戶另行選擇提供資料。處理客戶程式碼前，建議確認帳號類型、資料設定和 permissions.deny。
使用 Claude Code 會不會很快碰到用量上限？
取決於你的使用頻率、程式碼庫大小和任務型態。小型修 bug、寫測試通常還好；大型重構、多個 Claude 同時跑、或長時間無頭模式自動化，會消耗得快很多。建議先從單一專案和單一任務開始，觀察 /usage 或方案用量，再決定是否升級 Max 或改走 Team/Console 管理。
跟 GitHub Copilot 比起來，我該選哪個？
兩者不是互斥的。Copilot 適合日常的程式碼補全和簡單問答，直接在 IDE 裡運作。Claude Code 則擅長需要跨多個檔案、需要執行終端機指令、或需要操作 git 的複雜任務。如果你的工作以終端機為主，Claude Code 的價值更大；如果你主要在 IDE 裡工作，Copilot 的門檻更低。很多開發者會同時使用兩者。這跟我們在選擇 Namecheap 網域 或其他網域註冊商時的邏輯一樣，不同的工具有不同的強項，看你的需求來搭配就好。
Claude Code 支援哪些程式語言？
Claude Code 本身不限特定語言。只要是文字格式的程式碼檔案，它都能讀取和編輯。不過在實際體驗上，Python、JavaScript/TypeScript、Go、Rust 這些主流語言的支援效果最好，因為 Claude 的訓練資料中這些語言的範例最豐富。對於冷門語言或極度特殊的框架，可能需要更詳細的 CLAUDE.md 來補充上下文。就像 主機評測時不同主機適合不同場景一樣，Claude Code 在不同語言下的表現也會有差異。
Claude Code 可以離線使用嗎？
不行。Claude Code 需要連線到 Anthropic 的模型服務（或你設定的第三方雲端模型供應商），所有的推理都在雲端完成。你的程式碼會在本地被讀取，但處理過程需要網路。如果你在網路不穩定的環境下工作，可能需要先考慮 1.1.1.1 DNS 設定 來改善連線品質，或者了解 ExpressVPN 這類工具，確保連線不被干擾。
團隊協作時怎麼共享 Claude Code 設定？
把 CLAUDE.md 和 .claude/settings.json 存入 git 就能跟團隊共享。每個成員也可以有自己的 CLAUDE.local.md 放個人偏好（記得加入 .gitignore）。團隊使用 Team 或 Enterprise 方案可以統一管理帳號和用量。這跟團隊一起管理 DreamHost 或 000webhost 主機時共用設定檔的做法很類似。
