Physical Address
304 North Cardinal St.
Dorchester Center, MA 02124
2026 Claude Code 完整教學：從安裝設定到進階工作流，掌握 AI 智能體編碼
Claude Code 是 Anthropic 推出的 AI 編碼工具。這篇教學整理 2026 年安裝方式、CLAUDE.md 設定、權限管理、工作流程、資料隱私與適合族群，幫助開發者判斷是否導入。
用 AI 摘要這篇文章：
Claude Code 是 Anthropic 推出的終端機 AI 編碼助手，能讀取整個程式碼庫、編輯檔案、執行 shell 指令、操作 git，甚至幫你建 Pull Request，是目前上下文理解範圍最廣的 AI 開發工具之一。
這篇教學從基本概念出發，帶你走過安裝設定、CLAUDE.md 調校、權限管理、五種實用工作流程，到進階的多實例協作與無頭模式自動化。不管你是剛接觸 Claude Code，還是已經用了一段時間想找出更有效的工作方式，都能在這裡找到對應的段落。
目錄
Claude Code 是什麼？跟其他 AI 編碼工具有什麼不同
依 Claude Code 官方說明，它是一款 agentic coding tool（智能體編碼工具），核心能力是讀取整個程式碼庫、編輯檔案、執行終端機指令，並串接各種開發工具。現在不只存在於終端機，也能在 VS Code、JetBrains、桌面 App 和瀏覽器中使用。
跟單純的聊天機器人不同，Claude Code 把 AI 放進你現有的開發流程：讀檔案、改程式碼、跑測試、看錯誤訊息、整理 commit，然後由你決定哪些變更要保留。它的可組合度很高，你可以用 CLAUDE.md 設定專案記憶，用權限規則控制它能做什麼，用 MCP、hooks 或 skills 把它接進團隊流程。如果你之前用過 AI 文字偵測工具 或 ChatGPT 等 AI 工具，可以把 Claude Code 想像成「AI 助手走進了你的終端機」，而且它能觸及的不只是目前開啟的檔案，而是整個程式碼庫加上終端機環境。
開發 Claude Code 的 Anthropic，正是打造 Claude 系列模型 的公司。這代表 Claude Code 背後的語言模型一直在更新，模型的推理能力和上下文理解會隨版本演進持續改善。
Claude Code、GitHub Copilot 與 Cursor 的定位差異
很多人會問：Claude Code 跟 GitHub Copilot、Cursor 到底差在哪裡？三者的定位其實不太一樣。Copilot 是隨插即用的 IDE 外掛，主打行內補全和簡單問答；Cursor 是基於 VS Code 改造的獨立 IDE，有自己的 Agent 模式；Claude Code 以終端機為核心，可觸及的上下文範圍最廣，能讀整個程式碼庫、跑 shell 指令，也能完整操作 git。
| 面向 | 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 |
| 費用 | 需付費方案（Pro 起跳） | 免費版 + 付費版 | 免費試用 + 付費版 |
| 適合族群 | 習慣終端機的開發者 | 所有人 | 喜歡圖形介面的開發者 |
截至 2026 年 5 月。Claude Code、Copilot 和 Cursor 都在快速更新，定價與功能請以各工具官網為準。
Claude Code 安裝與初始設定
安裝的第一步是選擇適合你環境的方式。依 Claude Code 官方安裝文件，2026 年官方推薦先用原生安裝器，它會自動處理二進位檔、背景更新和各平台差異，適合大多數使用者。
以下是各平台的安裝指令：
# 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 會以目前目錄作為工作範圍，後續的讀檔、改檔、跑測試都跟這個位置有關。
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。這是新專案最值得先做的一步，後續的指令、測試方式和程式碼風格都可以從這份檔案開始累積。
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）能快速理解專案的眉角。
權限管理：在效率與安全之間取得平衡
Claude Code 預設採取保守策略：任何可能修改系統的操作（寫檔案、執行 bash 指令、呼叫 MCP 工具等），都會先詢問你是否同意。這是刻意設計的安全機制，不是在故意拖慢你的速度。
你可以透過四種方式調整允許清單：
- 對話中被提示時選「永遠允許」，最直覺的方式。
- 使用
/permissions指令，在啟動後隨時新增或移除。例如允許檔案編輯：Edit；允許 git 提交：Bash(git commit *)。 - 手動編輯
.claude/settings.json，適合需要跟團隊共享權限設定的情境。建議將這個檔案納入版控。 - 使用
--allowedTools旗標，在啟動時就指定這次對話允許的工具。
如果專案裡有 .env、金鑰、客戶資料或建置產物，不要只在 CLAUDE.md 寫「請不要讀」。依 官方設定文件，比較可靠的做法是用 permissions.deny，讓這些路徑從搜尋與讀取操作中被排除。就像網站安全防護中用 Cloudflare Turnstile 防機器人 或用 HeaderScan 掃描 HTTP 標頭 一樣，「預設擋住、白名單放行」是更可靠的安全邏輯。
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 有清晰的目標可以迭代時（測試案例、視覺模型、預期輸出），它的表現會最好。
3. 視覺反覆迭代
不只是測試，你也可以給 Claude 一個視覺目標。先給 Claude 一個取得瀏覽器截圖的方法（例如 Puppeteer MCP 參考實作），然後提供一張設計稿或目標畫面的截圖，要求 Claude 在程式碼中實作，截圖比對結果，反覆迭代直到符合。
Claude 的輸出經過 2 到 3 次迭代後通常會顯著改善。給它查看自己成果的工具，就能得到最好的結果。就像用 AI Image Enhancer 增強照片 時多跑幾次品質會越來越好，Claude Code 的視覺迭代也是同樣的邏輯。
4. 程式碼庫問答
接手新的程式碼庫時，Claude Code 是極好的學習工具。你可以像問同事一樣問它：「這個專案的日誌系統是怎麼運作的？」「我該怎麼新增一個 API 端點？」Claude 會自動搜尋程式碼庫來回答。在 Anthropic 內部，這已經成為核心的上手流程。
這個功能對於維護大型專案特別有用。就像你接手一個陌生的 WordPress 網站時，會需要 ChatDOC 分析文件 來看需求規格，或是用 ChatPDF 快速理解技術文件一樣，Claude Code 能幫你快速掌握一個陌生程式碼庫的架構和運作邏輯。跟一般 AI 聊天工具比起來，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 重構認證系統，另一個建構資料視覺化元件，互不干擾。
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 聊天工具。就像 Bluehost 主機 提供了豐富的擴充功能一樣，Claude Code 的生態系也正在快速成長。
台灣開發者必看的在地化注意事項
台灣開發者在使用 Claude Code 時，有幾個特別值得注意的地方。
費用：依 Claude 方案價格頁，Pro 月繳價格為 20 美元，年繳折扣後約每月 17 美元。Max 方案從每月 100 美元起（5x 用量），20x 用量則為每月 200 美元。Claude Code 也可透過 Team（每月 100 至 150 美元/人）、Enterprise 或 Console 使用，購買前仍要以結帳頁顯示的稅金、幣別與方案限制為準。
中文互動：Claude Code 可以用中文溝通，也能要求輸出繁體中文註解或文件。不過函式名稱、錯誤訊息、套件名稱和終端機指令建議保留英文，模型比較不會誤解技術上下文。
網路連線：Claude Code 需要穩定網路連線，公司防火牆、代理伺服器或第三方雲端模型供應商可能需要額外設定，企業導入前要先確認網路政策。就像你在做 Cloudflare 速度測試 或檢查網路連線品質時一樣，穩定的網路環境是一切運作的基礎。
資料隱私：Claude Code 會把必要上下文送到模型服務處理。依 Claude Code 資料使用政策，消費者帳號和商業帳號的訓練與保留規則不同。如果專案含個資、商業機密或客戶程式碼，建議用商業帳號、明確關閉不必要資料分享，並在 .claude/settings.json 用 permissions.deny 排除敏感檔案。就像選擇主機服務時會在意資料中心位置和安全性一樣，使用 AI 工具時也要注意資料流向。如果你正在挑選主機，可以參考我們的 Bluehost WordPress 主機評價。
如果你是 WordPress 開發者，Claude Code 搭配 InstaWP 測試站 可以先在沙盒中測試 AI 產生的程式碼。如果需求文件是 PDF，也可以先用 LightPDF ChatDOC 整理規格，再交給 Claude Code 拆任務。想在本地架測試環境，可以參考 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、管理權限、善用子智能體。初期投資時間是必要的，但熟了之後效率提升是顯而易見的。
功能持續演進：Claude Code 還在快速開發中，安裝方式、支援平台、權限模式與資料政策都可能變動。教學文定期回查 官方文件 才能確保資訊是最新的。
下一步：三個你可以馬上做的動作
- 安裝並跑一次 /init：選一個你熟悉的專案，安裝 Claude Code 進去跑
/init，看看它產生的CLAUDE.md是否符合你對這個專案的理解。如果有缺漏就補上去，這是最快上手的方式。 - 用 TDD 流程修一個小 bug：找一個你已經知道怎麼修的小問題，改用 TDD 模式讓 Claude 寫測試再寫實作。體驗一下「給 Claude 一個明確目標讓它迭代」的效果。
- 設定 permissions.deny 保護敏感檔案：在
.claude/settings.json中加入permissions.deny，把.env、金鑰和客戶資料排除在 Claude 的讀取範圍之外。這一步只需要幾分鐘，但能避免後續很多不必要的風險。
Claude Code 常見問題 FAQ
Claude Code 可以在 Windows 上使用嗎？
可以。Claude Code 目前可在 native Windows 或 WSL 中使用。Windows 原生專案可以走 PowerShell、CMD 或 WinGet；如果你的專案本來就在 Linux 工具鏈、Docker 或 WSL 環境中，則在 WSL 裡安裝會更自然。
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 管理。
Claude Code 支援哪些程式語言？
Claude Code 本身不限特定語言。只要是文字格式的程式碼檔案，它都能讀取和編輯。不過在實際體驗上，Python、JavaScript/TypeScript、Go、Rust 這些主流語言的支援效果最好，因為 Claude 的訓練資料中這些語言的範例最豐富。對於冷門語言或極度特殊的框架，可能需要更詳細的 CLAUDE.md 來補充上下文。
Claude Code 可以離線使用嗎？
不行。Claude Code 需要連線到 Anthropic 的模型服務（或你設定的第三方雲端模型供應商），所有的推理都在雲端完成。你的程式碼會在本地被讀取，但處理過程需要網路。如果你在網路不穩定的環境下工作，可能需要先考慮 1.1.1.1 DNS 設定 來改善連線品質。
