Claude Code 是什麼？Claude Code 中文教學：安裝、用法、價格與新手避坑

Claude Code 是 Anthropic 官方推出的 agentic coding tool，也就是「能使用工具完成開發任務的 AI 程式助理」。根據官方說明，Claude Code 可以讀取你的 codebase、編輯檔案、執行 command，並整合在 terminal、IDE、桌面 App、Web 與 Slack 等環境中使用。

官方文件：Claude Code Overview

簡單講，Claude Code 不只是回答「這段程式碼怎麼寫」，而是可以真的進到你的專案裡，理解檔案結構、找出相關程式碼、修改多個檔案，然後執行測試來確認結果。

舉例來說，你可以對 Claude Code 說：「請幫我找出登入流程在哪裡，並解釋這個專案怎麼處理 JWT 驗證。」它就能閱讀相關檔案，整理給你看。

你也可以說：「這個測試失敗了，請找出原因，先提出修正計畫，不要直接改檔。」這時 Claude Code 就能像工程夥伴一樣，先分析錯誤，再跟你確認下一步。

Claude Code 跟 Claude Chat 差在哪？

很多新手會把 Claude Code 跟 Claude Chat 混在一起，其實兩者差異很大。

Claude Chat 比較適合用來問問題、整理資料、寫文章、解釋概念、產生程式碼片段。你可以把程式碼貼給它，它會回答你。

Claude Code 則是直接跟你的專案一起工作。它可以讀取檔案、修改檔案、執行測試、使用 Git、跑 build command，甚至在 IDE 或桌面 App 裡管理多個開發任務。

比較項目	Claude Chat	Claude Code
主要用途	聊天、問答、產生內容	開發、修 Bug、讀專案、改程式
是否能操作檔案	通常不能直接操作你的專案	可以讀取與修改專案檔案
是否能執行指令	通常不能直接跑你本機指令	可以執行 shell command、測試、build
適合對象	一般使用者、學生、知識工作者	工程師、技術 PM、會用 Git 的開發者

所以如果你只是想問：「這段 JavaScript 是什麼意思？」用 Claude Chat 就可以。

但如果你想讓 AI 直接幫你在專案中找問題、改檔案、跑測試，那 Claude Code 才是更適合的工具。

Claude Code 可以用在哪些地方？

Claude Code 不是只能在終端機使用。根據官方產品頁，目前 Claude Code 可以在 terminal、IDE、Claude desktop app、Web、Slack 等地方使用。

官方產品頁：Claude Code by Anthropic

常見使用方式如下：

Terminal：最經典的使用方式，適合熟悉命令列的工程師。
IDE：可搭配 VS Code、Cursor、JetBrains 系列 IDE 使用。
Desktop App：可以管理多個 Claude Code 任務、看視覺化 diff、預覽結果。
Web：適合從瀏覽器或雲端環境處理 GitHub 專案任務。
Slack：適合團隊在協作情境中派任務或討論開發問題。

如果你是完全新手，我會建議先從 terminal 或 IDE 開始，因為最容易理解 Claude Code 實際改了哪些檔案，也最方便搭配 Git 檢查結果。

Claude Code 安裝方法

Claude Code 官方提供多種安裝方式，包含 Native Install、Homebrew、WinGet 等。最新安裝方式建議以官方 Quickstart 為準，因為安裝指令與支援平台可能會更新。

官方安裝教學：Claude Code Quickstart

macOS、Linux、WSL 安裝指令

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

Windows PowerShell 安裝指令

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

安裝後啟動 Claude Code

進入你的專案資料夾後，輸入：

claude

第一次使用時，系統會要求你登入 Claude 帳號。你可以使用 Claude Pro、Max、Team、Enterprise，或使用 Anthropic Console 帳號。

這裡有一個很重要的提醒：如果你的電腦環境變數中設定了 ANTHROPIC_API_KEY，Claude Code 可能會改用 API 計費，而不是使用你的 Claude 訂閱方案額度。這點非常容易讓新手誤會。

官方說明：Use Claude Code with your Pro or Max plan

Claude Code 價格方案怎麼看？

Claude Code 的價格最容易讓新手混亂，因為它可以透過「Claude 訂閱方案」使用，也可以透過「Console API」按 token 計費。

依照官方目前產品頁，個人常見方案包含：

Pro：月繳約 US$20，年繳平均約 US$17/月，適合短時間 coding sprint、小型 codebase 與輕量使用。
Max 5x：約 US$100/月，適合每天都會使用 Claude Code、處理較大型專案的使用者。
Max 20x：約 US$200/月，適合高頻率、重度使用者。
Team / Enterprise：適合公司團隊使用，會有更多管理、權限與企業需求。
Console API：如果你用 API key，會依照 API token 用量計費，不等於 Claude Pro 訂閱。

價格、模型、用量限制都屬於高更新風險，實際費用一定要以官方頁面與你的帳號顯示為準。

官方價格與產品頁：Claude Code Pricing

Claude Code 入門使用流程

第一次使用 Claude Code，我不建議你馬上叫它做大功能或重構整個專案。

比較安全的入門方式，是先選一個不重要、可回復、已經放進 Git 的小專案，讓 Claude Code 從「閱讀與解釋」開始。

步驟一：確認 Git 狀態

在開始前，先確認目前工作區是乾淨的。

git status

如果有未提交的修改，先 commit 或 stash 起來。

步驟二：建立新分支

git checkout -b test-claude-code

這樣即使 Claude Code 改錯，你也可以很容易回復。

步驟三：先請它讀專案，不要改檔

你可以輸入：

請閱讀這個專案，整理主要資料夾用途、啟動方式、測試方式。先不要修改任何檔案。

這一步很重要，因為你要先確認 Claude Code 是否真的理解專案，而不是直接讓它動手。

步驟四：使用 /init 建立 CLAUDE.md

Claude Code 有一個很重要的檔案叫 CLAUDE.md，可以放專案規則、測試指令、開發慣例、注意事項。

你可以輸入：

/init

Claude Code 會分析專案，協助建立初始的 CLAUDE.md。官方文件也說明，CLAUDE.md 可用來記錄 build commands、test instructions 與 project conventions。

官方說明：How Claude remembers your project

步驟五：小任務開始

一開始可以用這類指令：

請找出這個錯誤可能發生在哪裡，先提出修正計畫，不要直接修改檔案。

或是：

請幫我為這個 function 補上單元測試。修改前先說明你會改哪些檔案。

我會建議新手記住一個原則：先要求 Claude Code 提計畫，再允許它改檔。

工商時間

如果你想要更系統化、更輕鬆的學好 SEO 與 AI SEO，歡迎參考我與知識衛星合作的 SEO 線上課程：《SEO 排名攻略學》、《AI SEO 流量變革》。

透過《SEO 排名攻略學》獲得穩定的 SEO 流量與實戰經驗。
再搭配《AI SEO 流量變革》看懂 AI 搜尋趨勢，搶佔 AI 搜尋紅利。

Claude Code 8 個實用情境

1. 快速理解陌生專案

如果你剛接手一個專案，最痛苦的地方通常不是寫程式，而是不知道程式碼在哪裡、資料流怎麼走、設定檔藏在哪。

Claude Code 很適合幫你整理專案架構。

指令參考：

請閱讀這個專案，整理主要資料夾用途、核心流程、啟動方式、測試方式，並列出重要檔案路徑。

2. 修 Bug

你可以把錯誤訊息、測試失敗結果、terminal log 給 Claude Code，請它找出可能原因。

指令參考：

這是目前的錯誤訊息，請找出最可能的原因。先不要修改檔案，請先提出 3 個可能方向。

這種用法特別適合新手，因為你可以學到「它是怎麼查錯的」。

3. 補單元測試

Claude Code 很適合幫既有程式補測試，但你要注意它可能只補 happy path，也就是只測正常情境。

指令參考：

請幫這個 module 補單元測試，包含正常情境、錯誤輸入、邊界條件。完成後請執行測試。

4. 小型重構

如果某段程式碼太長、重複邏輯太多，可以請 Claude Code 幫你整理。

指令參考：

請重構這個檔案中的重複邏輯，但不要改變外部行為。請保持 diff 小，並說明每個修改原因。

新手不要一開始就叫它「重構整個專案」，這非常容易失控。

5. 更新 README 或文件

Claude Code 可以讀你的專案設定、package scripts、環境變數範例，然後幫你整理成文件。

指令參考：

請根據目前專案內容更新 README，包含安裝、啟動、測試、常見問題。不要編造不存在的指令。

6. 解釋一段看不懂的程式

這對新手非常有幫助。

指令參考：

請用新手能理解的方式解釋這個檔案的功能，並說明每個 function 在整個流程中的角色。

7. 修 CI 或測試錯誤

如果 GitHub Actions、測試或 build 失敗，你可以把 log 給 Claude Code 分析。

指令參考：

這是 CI 失敗訊息，請找出原因，並提出最小修改方案。修改前先列出會碰到的檔案。

8. 協助整理 PR

當你完成一段修改後，可以請 Claude Code 幫你整理 PR 描述。

指令參考：

請根據目前 git diff，整理一份 PR 描述，包含修改內容、測試方式、可能風險。

這個用法很實用，但注意：PR 描述可以讓 AI 幫你整理，PR 內容還是要自己看。

Claude Code 的權限與安全：新手一定要懂

Claude Code 能改檔案、跑指令，所以權限管理非常重要。

官方文件提到，Claude Code 會在修改檔案或執行指令前詢問權限；也有 permission rules、sandboxing、auto mode 等設定可以控制它能做什麼。

權限文件：Claude Code Settings

什麼是 Permission？

Permission 就是你允許 Claude Code 做哪些事情。

例如你可以允許它讀取專案檔案，但不要讓它讀取敏感資料夾；可以允許它執行測試，但不要讓它任意執行部署指令。

什麼是 Sandbox？

Sandbox 是沙盒環境，用來限制 Claude Code 執行 Bash command 時可以碰到哪些檔案與網路資源。

官方說明：Claude Code Sandboxing

不過要注意，sandbox 不是萬能保護罩。官方文件也提醒，Windows 原生環境不支援同樣的 sandbox，Windows 使用者通常要透過 WSL2 使用相關能力。

不要亂用 bypass permissions

有些教學會提到跳過權限確認，讓 Claude Code 更自動化。

但我不建議新手這麼做。除非你在乾淨的測試環境、容器或可丟棄的專案中實驗，否則不要為了省幾次確認，就讓 AI 直接擁有過大的操作權限。

Claude Code vs Cursor vs GitHub Copilot 怎麼選？

如果你剛開始接觸 AI 寫程式工具，可能會同時看到 Claude Code、Cursor、GitHub Copilot、OpenAI Codex 等名稱。

新手可以先這樣理解：

工具	比較適合誰	特色
Claude Code	熟悉 Git、terminal、想讓 AI 直接處理專案任務的人	偏 agentic coding，可讀 codebase、改檔、跑指令、管理任務
Cursor	想在編輯器裡自然使用 AI 的工程師	IDE 體驗好，適合邊寫邊問、邊改邊看
GitHub Copilot	重度使用 GitHub、VS Code、PR workflow 的團隊	跟 GitHub 生態整合深，適合補全、聊天與 GitHub 任務
OpenAI Codex	已經在 OpenAI 生態中，希望使用雲端 coding agent 的人	適合把任務交給雲端 agent 處理，再回來檢查結果

我的建議是：如果你喜歡 terminal、Git、PR、測試流程，Claude Code 很值得學。

如果你完全不熟命令列，可能會覺得 Cursor 類工具比較容易上手；但長期來看，理解 Git、測試、diff，仍然是安全使用 AI coding tool 的基本功。

Claude Code 新手最常踩的坑

1. 沒開 Git 分支就讓它改檔

這是最大地雷。請一定要先開 branch，確認可以 rollback。

2. 一開始就叫它做大型功能

Claude Code 很強，但任務越大，越容易改太多檔案、偏離需求、產生你看不懂的結果。

3. 不看 diff 就接受結果

Claude Code 說完成，不代表真的完成。你一定要看它改了哪些檔案。

git diff

4. 沒有跑測試

AI 寫的程式看起來合理，不代表能跑。

至少要跑：

npm test
npm run build
npm run lint

實際指令依你的專案而定。

5. 把機密資料貼給 AI

不要把 API key、資料庫密碼、客戶個資、公司機密直接貼進 prompt，也不要讓 Claude Code 任意讀取敏感資料夾。

6. 以為 CLAUDE.md 是安全規則

CLAUDE.md 比較像專案說明與協作規範，不是硬性的安全門禁。真正要限制檔案與工具，還是要靠 permission、settings、sandbox 或公司管理設定。

7. 沒搞清楚計費方式

如果你使用 Claude Pro 或 Max，Claude Code 可以走訂閱方案額度。

但如果系統設定了 API key，就可能變成 Console API 計費。這點請務必確認。

Claude Code 新手避坑檢查清單

使用前先確認 git status 是乾淨的。
每個任務都開新的 Git branch。
第一輪先讓 Claude Code 讀專案，不要馬上改檔。
要求它先提出計畫，再允許修改。
一次只做一個小任務，不要一次丟整個產品需求。
重要修改一定要看 git diff。
能跑測試就跑測試，能跑 build 就跑 build。
不要貼 API key、密碼、客戶資料、公司機密。
不要在正式專案隨便使用 bypass permissions。
確認目前是訂閱方案額度，還是 API token 計費。
AI 產生的 PR 仍然需要人類 code review。

工商時間

Claude Code 適合誰？

Claude Code 最適合以下幾種人：

已經會一點 Git 與 terminal 的工程師。
想提升修 Bug、補測試、讀 codebase 效率的人。
需要維護舊專案、整理文件、處理重構的人。
技術 PM、創業者，想更快理解工程專案的人。
已經使用 Claude、但想把 AI 帶進開發流程的人。

如果你還在猶豫該從哪個工具入手，也可以先看看 Claude、Claude Code 與 Claude Cowork 的差異比較，再決定哪一個最符合你的工作方式。

比較不適合的人：

完全不懂 Git，也不知道如何回復檔案的人。
想把整個產品一次丟給 AI 自動完成的人。
正在處理高度敏感、不能外流的公司程式碼，且尚未通過公司資安審核的人。
沒有測試、沒有 review、也不打算檢查 AI 修改結果的人。

如果你是新手，可以用 Claude Code，但請先把它當成「會寫程式的助教」，不是「不會犯錯的資深工程師」。

Claude Code 常用指令範例

理解專案

請閱讀這個專案，整理主要架構、資料流、啟動方式、測試方式，並列出重要檔案。

修 Bug

這是錯誤訊息，請找出可能原因。先不要修改檔案，請先提出修正計畫。

補測試

請幫這個 function 補單元測試，包含正常情境、錯誤情境與邊界條件。

檢查 diff

請根據目前 git diff，說明你改了哪些地方、為什麼這樣改、有哪些風險。

整理 PR

請根據目前修改內容，幫我整理 PR 描述，包含修改摘要、測試方式與注意事項。

總結：Claude Code 很強，但要用工程方法駕馭它

Claude Code 是目前非常值得工程師學習的 AI coding tool。它不只是幫你產生程式碼，而是能進到專案中讀檔、改檔、跑指令、整理任務，讓 AI 更接近真正的開發工作流程。

但越是強大的工具，越需要使用邊界。新手使用 Claude Code 時，不要追求一次完成巨大任務，而是要學會切小任務、先看計畫、檢查 diff、跑測試、保護機密資料。

如果你剛開始學，我會建議從三件事開始：請它解釋專案、幫你修一個小 Bug、幫你補一個測試。

等你熟悉 Claude Code 的工作方式後，再慢慢嘗試重構、PR、CI 修復、文件整理、團隊流程與更進階的自動化。

最後記得：Claude Code 可以讓你寫程式更快，但真正讓你變強的，是你能不能判斷它寫得對不對。