Claude Code 完全指南：安裝、費用、任務流程與安全設定

想讓 Claude Code 幫你改 repo，先選一個低風險 issue、確認權限與測試證據，再決定用 Pro、Max、Team 或維持 Cursor/Copilot。

發佈於： 2026-04-11 | 更新於： 2026-07-05

內容查核： 2026-07-05 來源查核： 2026-07-05

如果今天要修的是一個真實 repo 裡的登入錯誤、測試壞掉或 release note 要改，Claude Code 的價值不在「幫你補下一行」。它可以讀專案、追錯誤、改多個檔案、跑命令，再把 diff 留給你檢查。麻煩也從這裡開始：它碰得到檔案與 shell，錯一次的代價可能落在測試、設定檔或部署指令，一起把工作弄壞。

比較安全的用法，是先把 Claude Code 當成受監督的 terminal coding agent。先選一個低風險 issue，讓它提出計畫，限制能碰的路徑，要求跑測試與回報證據；等你看過 diff 與成本，再決定要不要把它變成每天寫 code 的主力。只想做 inline 補全、偶爾改一段 UI，Cursor 或 Copilot 可能更省事。

60 秒判斷：你該不該先用 Claude Code？

情境	建議	為什麼
每天在同一個 repo 跑測試、看 diff、開 PR	先試 Claude Code	它的強項是讀專案、跨檔修改、跑命令與整理提交證據。
主要需求是 IDE 裡快速補全、改 CSS、補一小段函式	先維持 Cursor 或 Copilot	啟動 agent、讀上下文和等確認，可能比小修本身更慢。
團隊想讓 agent 碰資料庫、雲端或內部系統	先跑權限與審查試驗	費用還包含 secrets、命令白名單、review 時間與事故回滾。
Windows 專案在 PowerShell、.NET 或本機工具鏈裡	可用原生 Windows	Anthropic 已提供 PowerShell、CMD 與 WinGet 安裝方式。
專案依賴 Linux 工具、容器、sandbox 或 WSL 裡的 repo	用 WSL 2	WSL 2 比較接近 Linux/macOS 開發環境，也支援 sandboxing 路線。

先別把問題問成「Claude Code 比誰強」。更有用的是問：你要交給 AI 的任務，是否需要它理解整個 repo 並產出可驗收變更？答案是肯定，再往下看安裝、費用與安全設定；答案是否定，先把現有 IDE 工具用順，反而比較快。

Claude Code 從讀專案、計畫、改檔、測試到提交與 PR 的工程流程圖 — 這張圖對應的讀者任務，是把「讀 repo → 提計畫 → 改檔 → 跑測試 → 人工 review」變成可重跑流程。

官方定位：它能讀 repo、改檔、跑命令，也能接工具

Anthropic 官方文件把 Claude Code 定義為 agentic coding tool：它能讀 codebase、編輯檔案、執行命令，並接進開發工具。可用入口不只終端機，也包含 VS Code、JetBrains、Desktop app、Web 與部分雲端／聊天場景；同一套 CLAUDE.md、設定與 MCP server 會跟著工作環境走。

這代表使用前要先分清三件事。

一、Claude Code 比一般聊天工具更靠近 repo。它適合處理「找出哪裡壞、提出改法、真的改檔、跑測試」這類任務。只要答案停在解釋概念，Claude.ai、ChatGPT 或文件搜尋通常就夠。

二、Claude Code 不應該直接取代 code review。官方 permissions 文件寫明，讀檔、shell 命令、檔案修改有不同的核准層級；實務上也應該把 diff、測試紀錄與風險回報留給人看。

三、MCP、subagents、hooks 很有用，但不是第一天就該全開。先讓一個 repo 的基本修 bug 流程跑順，再把 Jira、Slack、資料庫、雲端工具一個一個接上去，才知道哪個權限真的必要。

安裝前先看作業系統、帳號與驗證方式

官方 setup 文件列出的基本條件是 macOS 13+、Windows 10 1809+ / Windows Server 2019+、Ubuntu 20.04+、Debian 10+ 或 Alpine Linux 3.19+，硬體至少 4GB RAM、x64 或 ARM64，並需要網路連線。Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 帳號；免費 Claude.ai 方案不含 Claude Code。

常見安裝路線如下。macOS、Linux、WSL 可用 native installer：

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

Windows 不再只能繞 WSL。PowerShell 可用：

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

CMD 可用：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

也可以用 Homebrew、WinGet 或 Linux 套件管理器安裝。安裝後先跑兩個檢查：

claude --version
claude doctor

若專案本來就在 WSL、Docker、Linux toolchain 或需要 sandboxing，Windows 使用者仍適合在 WSL 2 內安裝並啟動 claude。若專案是 Windows-native、PowerShell/.NET 工具鏈為主，原生 Windows 會比較少跨檔案系統問題。這個選擇應該跟 repo 放在哪裡一致，不要只因為某篇舊教學說「一定要 WSL」就搬家。

第一次試跑：只交一個低風險 issue

第一次用 Claude Code，別從「重構整個 auth 模組」開始。挑一個回滾容易、測試清楚、不碰 production 設定的 issue，比較能看出它是否真的省時間。

一個安全的第一輪可以這樣下指令：

先讀這個 repo，找出登入頁卡住的可能原因。請先提出計畫，不要改檔。計畫要列出會讀哪些檔案、你認為的風險、需要跑哪些測試；等我確認後再開始改。

看到計畫後，再要求它分段執行：先讀檔與說明假設，再改最小 diff，再跑測試，最後交出「改了哪些檔案、測試結果、還有哪些風險」。如果測試失敗，不要讓它一路自行擴大範圍；先要求它解釋失敗原因，必要時退回上一個小步驟。

這個流程看起來比一句「幫我修好」慢，但它會讓你看到三個關鍵證據：Claude Code 是否找對檔案、diff 是否可審查、測試是否真的驗證了問題。這三件事比 demo 裡的炫技功能更能決定它能不能進日常工作。

費用怎麼估：月費、token、review 時間要分開

Anthropic pricing 頁面在 2026-07-05 顯示，Pro 年繳折扣約每月 17 美元、月繳 20 美元，並包含 Claude Code；Max 從每月 100 美元起，提供比 Pro 更多用量；Team 依座席計價，標準座席年繳每人每月 20 美元、月繳 25 美元，進階座席有更高用量。價格與方案可能調整，採購前仍要看官方頁面。

總成本要把訂閱費以外的項目一起算。官方成本文件提醒，API token、codebase 大小、模型選擇、多個 agent 同時跑、MCP 工具與自動化用量都會影響支出。對團隊來說，還要加上人工 review、CI 分鐘、返工與資安審查。

比較實用的估法是先跑兩週小型驗收：

用 3 到 5 個真實但低風險 issue 測試，不要只看範例專案。
每次記錄任務大小、Claude Code 花費時間、人工 review 時間、測試是否通過、是否需要返工。
用 /usage 看近 24 小時與 7 天的用量拆解；API 使用者再回 Claude Console 看正式帳務。
subagents 或 agent teams 只在需要分工時開，因為每個 active teammate 都有自己的 context window，用量會跟著放大。

如果只是個人每週修幾個小問題，Pro 可能已足夠。若 Claude Code 變成主要開發入口、常跑長任務或多代理任務，Max 或 Team 才值得評估。若公司要集中管理權限、用量、SSO、connectors 或資料政策，Team / Enterprise 會比個人方案更容易控管。

安全設定：先管權限，再談自動化

Claude Code 會碰到本機 repo，所以安全規則要比一般聊天工具早一點寫清楚。官方 permissions 文件把工具分成讀取、shell 命令與檔案修改；讀取通常不需要核准，shell 與檔案修改會依模式與規則要求確認。可以用 /permissions 管理 allow、ask、deny 規則，也可以在設定檔中保存團隊規則。

第一週建議保留人工確認，不要急著把所有命令放行。尤其是以下幾類操作：

會刪檔、改大量檔案、移動目錄的 shell 命令。
會碰 .env、憑證、production config、雲端帳號或資料庫的任務。
會建立 release、deploy、migration、付款、寄信或通知客戶的任務。
會把外部文件、客戶資料或內部原始碼送進不明 MCP server 的任務。

hooks 適合放在「人容易忘記、但機器可以先擋」的位置，例如編輯後自動跑 formatter、commit 前跑 test、shell 前阻擋危險命令。它們不能取代審查，但能讓 Claude Code 在犯錯前先撞到護欄。團隊如果要讓 agent 接 Jira、Slack、雲端或資料庫，先做 read-only，再逐步開可寫工具。

subagents、MCP、hooks：進階功能要有明確任務

Claude Code 的進階功能最容易讓文章變成功能清單。實務上可以用三個問題決定要不要開。

subagents 適合把「會淹沒主對話」的工作拆出去，例如大量搜尋、讀長 log、找測試覆蓋缺口。官方文件說每個 subagent 有自己的 context window、工具權限和提示；這能省主對話脈絡，也能限制它能做什麼。若只是改一個小檔案，不需要先做 subagent 架構。

MCP 適合接明確資料源，例如文件、ticket、設計稿或內部工具。先接 read-only source，確認 Claude Code 真的用得到，再開寫入權限。每多一個工具，都要問：它是否能讓這個 repo 任務更快驗收？還是只是讓 agent 看起來更厲害？

hooks 適合把團隊規則變成可執行檢查。例子包括 pre-commit 跑測試、post-edit 跑 formatter、pre-bash 擋危險命令。好的 hook 會讓錯誤更早被發現；太吵的 hook 會讓人關掉確認，反而更危險。

和 Cursor、Copilot、Codex、Devin 怎麼分工？

Claude Code 最適合的是 terminal 深度 repo 任務。Cursor 適合在 IDE 裡快速改 UI、看 diff、用 inline edit 修小段。GitHub Copilot 適合補全、熟悉既有 IDE 和企業 GitHub 生態。Codex 類工具適合已經在 OpenAI / ChatGPT 生態裡管理雲端任務的人。Devin 或其他全自主 agent 適合把 issue 交給遠端環境長時間處理，但成本、速度與審查方式要另外評估。

如果預算只夠一套，先看任務形狀：每天跨檔修 bug、跑測試、整理 PR，就先試 Claude Code；每天在 editor 內寫新元件、微調前端，就先用 Cursor；公司主要用 GitHub Enterprise、重視管理員政策與既有流程，就把 Copilot 放進比較名單。選工具時，把任務放到最少摩擦的位置。

30 天檢查：決定要不要變主力工具

把 Claude Code 放進日常前，給自己或團隊 30 天觀察期。不要只問「產出是否變多」，要記四個數字：成功完成的 issue 數、人工 review 花多久、測試或 CI 通過率、返工比例。

如果 30 天後常見結果是「Claude Code 找得到檔案、diff 小、測試會跑、review 變快」，就把 CLAUDE.md、permissions、hooks 和任務範本整理成團隊共用規則。若結果是「它常改太多、測試不穩、review 更累」，先縮小任務範圍，暫停增加自動化。

最低風險的下一步，是把一週內最常見的三種任務寫成固定 prompt：修 bug、補測試、讀陌生模組。每個 prompt 都要求先提計畫、列風險、跑驗收、不要碰指定路徑。等這三種任務穩定，再把 subagents、MCP 或 hooks 放大。

FAQ

Claude Code 跟 Claude.ai 有什麼不同？

Claude.ai 是通用對話與文件工作介面；Claude Code 是專門靠近 repo 的 coding agent，可以讀檔、改檔、跑命令、整理 commit 或 PR。若任務只需要解釋程式碼，Claude.ai 可能夠用；若任務需要改 repo 並跑驗收，Claude Code 才值得開。

Claude Code 支援繁體中文指令嗎？

可以用繁體中文交代目標、限制與回報格式。程式碼、變數、commit style 是否用英文，仍應跟 repo 規範一致。比較穩的做法是任務用繁中說清楚，驗收條件、檔案路徑、命令和錯誤訊息照原文保留。

Windows 現在還一定要 WSL2 嗎？

不一定。官方 setup 文件已列出 Windows PowerShell、CMD 與 WinGet 安裝方式；Windows-native 專案可以直接用原生 Windows。若 repo 在 WSL、依賴 Linux 工具鏈、容器或 sandboxing，才建議在 WSL 2 裡安裝和執行。

Claude Code 會不會自動把我的 production 改掉？

是否能碰到 production，取決於你給了哪些工具、環境變數、帳號、shell 權限與核准規則。不要把 production 憑證放進一般開發 shell，也不要把 deploy、migration、付款或寄信命令列成自動放行。先讓 Claude Code 在本機或 staging 產生可審查 diff，再由人決定是否進下一步。

參考來源與延伸閱讀

Anthropic Claude Code Overview：官方定位、可用入口、MCP、hooks、subagents 與跨環境使用。
Anthropic Claude Code Advanced setup：系統需求、macOS/Linux/Windows/WSL 安裝、驗證與登入。
Anthropic Configure permissions：工具權限、allow/ask/deny、permission modes 與安全邊界。
Anthropic Manage costs effectively：/usage、team spend、agent team token 成本與降成本做法。
Claude Plans & Pricing：Pro、Max、Team、Enterprise 與方案包含項目，價格需以官方頁面為準。
Mason 延伸閱讀：Claude Code 新手入門、Claude Code vs Cursor、Claude Code Hooks 指南、AI Coding Agent Prompt 範本。

№ · further reading