Favicon02

Claude Code 是什麼?安裝、用法、價格與安全避坑完整教學

Claude Code 會進入專案、編輯檔案、執行命令並驗證結果。這篇完整整理安裝、計費、第一次使用流程、權限與安全避坑。

Claude Code 是 Anthropic 推出的代理式程式開發工具,能讀取專案、編輯檔案、執行命令,並把任務推進到可驗證的結果。

它和一般聊天型 AI 最大的差別,是不只告訴你程式碼怎麼寫,而是能實際進入工作流程。

這篇會用新手角度說明 Claude Code 的安裝、計費、第一次使用流程、權限、安全邊界與常見錯誤。


Claude Code 是什麼?

Claude Code 是一種 AI coding agent,也就是能理解目標、使用工具並分段完成開發任務的 AI 代理。

你可以請它搜尋整個 codebase、跨檔案修改、跑測試、操作 Git,或先解釋一個陌生專案的結構。

它的價值不在「一次產生很多程式碼」,而在於把理解、修改、執行與檢查串成同一段流程。

Claude Code 讀取專案、執行修改與驗證交付的三項核心能力
Claude Code 的核心能力,是理解專案、使用工具,最後交付可檢查的結果。

不過,能操作檔案與命令也代表它比一般聊天工具更有風險,所以權限、回復點與驗收不能省略。


Claude Code 與 Claude Chat 差在哪?

如果你還不熟悉 Anthropic 的聊天產品,可以先讀Claude 是什麼,再回來看兩者差異。

比較項目 Claude Chat Claude Code
主要入口 聊天視窗 終端機、IDE、桌面與網頁等開發入口
專案理解 依你貼上的內容與連接的資料 可在授權範圍內搜尋整個專案
實際操作 多半由你複製、貼上與執行 可編輯檔案、執行命令與跑測試
適合任務 解釋概念、討論方案、修改短片段 跨檔案修錯、重構、測試與完整任務

終端機版本會大量使用命令列;若你看不懂這個介面,可先補充閱讀CLI 是什麼


Claude Code 可以在哪裡用?

截至 2026 年 8 月,官方主要提供 terminal、VS Code、JetBrains、desktop 與 web 等入口。

入口 適合誰 使用感受
Terminal 熟悉命令列、希望直接在專案目錄工作的人 彈性高,也最需要理解目前路徑與權限
VS Code/JetBrains 習慣在 IDE 內看程式與 diff 的人 修改位置與檔案變化較直觀
Desktop 想用圖形介面管理開發任務的人 較像獨立工作台
Web 希望交辦雲端任務並稍後查看結果的人 適合非同步處理與隔離工作

官方另有 remote、mobile、Slack、Chrome、CI/CD 與 routines 等整合,但可用功能仍可能依方案與環境調整。

第一次使用不必追求入口最多,選你最容易看懂檔案變化與執行結果的介面即可。


Claude Code 安裝方法

如果你要在本機專案工作,官方目前推薦 native installer,而不是把舊版 npm 安裝法當成第一選擇。

Windows 安裝

在 PowerShell 執行官方安裝命令:

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

若你偏好 Windows 套件管理器,也可以使用:

winget install Anthropic.ClaudeCode

macOS、Linux 或 WSL 安裝

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

macOS 使用者也可以選擇 Homebrew:

brew install --cask claude-code

確認安裝並啟動

安裝後先確認版本,再切換到專案目錄啟動 Claude Code。

claude --version
cd 你的專案資料夾
claude

第一次啟動會引導登入,你可以使用支援 Claude Code 的 Claude 方案,或使用 Anthropic Console 帳號。

帳單提醒:若電腦環境中已設定 ANTHROPIC_API_KEY,Claude Code 可能改走 API key 與 Console 計費。


Claude Code 價格與計費方式

Claude Code 沒有只有一條計費路徑,新手最容易混淆的是「Claude 訂閱」與「Anthropic Console API」。

使用方式 怎麼計費 適合情境
Claude Pro/Max 等支援方案 使用方案內的 Claude Code 額度與限制 個人固定使用、希望帳單較容易理解
Anthropic Console API 依使用的模型與 API Token 計費 團隊控管、按量使用或自動化流程

截至 2026 年 8 月 30 日,Pro 月繳為 20 美元,年繳一次付 200 美元,折算每月 17 美元。

同日的 Max 5x 為每月 100 美元,Max 20x 為每月 200 美元,稅額、區域與使用限制仍以官方頁面為準。

如果你不熟悉 API 為何按 Token 計量,可以先看AI Token 是什麼

開始前請先確認右上角帳號、登入方式與環境變數,不要只憑「我有訂閱」就認定不會產生 API 帳單。



第一次使用 Claude Code 的安全流程

初學者不要從「幫我把整個專案改好」開始,而要把第一次合作變成五個可回復、可檢查的小步驟。

第一次使用 Claude Code 的五步安全流程:Git、只讀探索、計畫、小步修改與驗收
先建立回復點,再讓 AI 小步修改,能大幅降低誤改範圍。

1. 先確認 Git 與回復點

先把目前能正常運作的狀態提交到 Git,再建立新的工作分支。

如果專案不能用 Git,也要先做可驗證的備份,否則出錯時很難分辨哪些檔案被改過。

2. 第一次只讀探索

先請 Claude 說明專案結構、啟動方式、測試位置與可能風險,明確要求暫時不要修改檔案。

3. 先提出計畫

要求它列出要改的檔案、每一步目的、風險與驗收方式,再由你縮小或修正範圍。

4. 一次只做一個小任務

先修一個錯誤、補一組測試或重構一個模組,完成後再決定是否擴張。

5. 驗收結果

看 Git diff、跑自動測試、實際操作關鍵流程,並確認沒有改到不在計畫中的檔案。

Claude 的完成摘要只能當線索,不能取代你對差異與結果的檢查。


Claude Code 可以拿來做什麼?

快速理解陌生專案

請它找出啟動點、資料流、重要模組、設定檔與測試方式,再追問不確定的地方。

修錯與補測試

提供錯誤訊息、重現步驟與預期結果,讓它定位原因、提出最小修改並補上邊界測試。

重構與更新文件

要求維持既有行為,先建立測試基線,再分段調整結構並同步更新 README 或註解。

處理 Git 與重複工作

它能協助整理變更、解釋 diff、準備 commit 訊息,或把重複命令整理成可審查的腳本。

依任務風險選擇 Claude Code 協作深度的四種適用任務
任務風險越高,越要增加隔離、人工核准與實際驗收。

涉及正式部署、資料庫遷移、付款、個資或憑證時,應把 Claude 放在受控環境,並保留人工決策點。


權限、Auto mode、Sandbox 與 CLAUDE.md

Claude Code 的安全不是一個開關,而是由權限模式、工具規則、執行隔離、版本控制與人工驗收共同組成。

先看懂目前的權限模式

第一次 session 通常會要求你確認操作,但之後的起始模式可能依方案、介面、組織政策與設定而不同。

截至 2026 年 8 月,官方文件已納入 Auto mode,因此舊有「所有修改永遠逐項詢問」的說法已不準確。

Auto mode 會用分類器評估操作風險,但它不是零風險保證;新手可先用 Plan 模式或保留逐項確認。

bypassPermissions 會略過權限提示,官方只建議在隔離容器或 VM 等受控環境使用。

Sandbox 能降低爆炸半徑

Sandboxed Bash 可限制檔案系統與網路存取,讓許多已知安全操作不必每次跳出確認。

但 Sandbox 仍不能取代 Git、測試與審查,因為「允許執行」不代表「修改內容一定正確」。

截至查核日,原生 Windows 不支援相同的 sandbox;需要這層隔離時,可考慮 WSL2 或容器。

CLAUDE.md 是工作說明,不是安全鎖

CLAUDE.md 可以記錄專案命令、程式風格、目錄規則與完成條件,讓每次 session 都有一致背景。

你可以用 /init 產生初稿,再刪掉空泛內容,保留這個專案真正特殊、不能靠讀程式推斷的資訊。

它仍屬於提供給模型的上下文;真正的硬性限制要用 permissions、hooks、sandbox 或外部執行環境。


Claude Code、Cursor、Codex 怎麼選?

這三者都能做代理式開發,但入口、使用習慣與團隊生態不同,沒有一個工具在所有情境都最好。

工具 主要工作入口 比較適合
Claude Code Terminal、IDE、desktop、web 重視 codebase 理解、工具使用與跨入口工作
Cursor AI-first 程式編輯器 希望一直留在 IDE 內查看與修改程式
Codex ChatGPT、雲端任務與本地開發工具 已使用 OpenAI 生態系,或需要平行交辦任務

如果你是在 Claude 產品內選入口,可看Claude Code 與 Cowork 的差別

如果你想進一步理解 OpenAI 的代理式開發產品,可讀Codex 是什麼

真正的選擇標準,是你能否清楚看見修改、限制權限、驗證結果,並把工具放進既有工作流程。


初學者常踩的 7 個坑

  1. 沒有 Git 就直接改:一旦跨檔案修改,很難可靠回到原本狀態。
  2. 任務範圍太大:「重做整個專案」缺少邊界,也沒有可判斷的完成條件。
  3. 沒看目前模式:以為每個動作都會詢問,實際上可能已在不同權限模式。
  4. 只相信完成摘要:摘要說測試通過,不代表測到正確行為,也不代表沒有多改。
  5. 混淆兩種帳單:Claude 訂閱額度與 Anthropic Console API 費用不是同一個池。
  6. 把 CLAUDE.md 當安全策略:工作說明能影響行為,但不能取代硬性權限。
  7. 在高風險主機全自動:正式資料、憑證與部署權限會把一次誤判放大成真實損失。

最簡單的防錯原則是:先縮小範圍,再增加能力;每次擴張前都要有新的驗收點。



哪些人適合,哪些人先不要用?

適合使用 Claude Code

  • 已經有 Git 流程,能看懂檔案差異與測試結果。
  • 需要跨多個檔案理解、修錯、重構或補測試。
  • 願意把任務拆小,並提供明確限制與驗收條件。
  • 團隊有權限、秘密管理、CI 與 code review 規範。

建議先補基本功

  • 完全不知道目前在哪個資料夾,也不會判斷哪些檔案被改。
  • 專案沒有版本控制、備份或可重現的測試方式。
  • 希望一次交辦模糊大任務,完成後也沒有人能驗收。
  • 只能在含正式資料、付款權限或大量憑證的主機操作。

非工程師也能用 Claude Code,但至少要學會路徑、Git、diff、測試與帳號權限這五個基本概念。


可直接複製的 Claude Code 提示詞

先理解專案,不要修改

先不要修改任何檔案。
請說明這個專案的用途、啟動點、主要目錄、測試方式與三個最高風險。
每個判斷都要附上你看到的檔案路徑。

先提出可審查的計畫

目標是修正登入後偶發跳回首頁的問題。
請先重現並找出根因,再列出預計修改的檔案、最小修法、測試與回復方式。
在我確認計畫前,不要修改檔案。

修改後自我驗收

完成後請列出實際修改、未修改的範圍、執行過的測試與仍未排除的風險。
請再檢查 Git diff,確認沒有無關格式化、秘密資訊或未預期的檔案。

好的提示詞不需要很長,但必須交代目標、邊界、證據、核准點與完成條件。


結論:把 Claude Code 當成會使用工具的協作者

Claude Code 的核心不是「比聊天更會寫程式」,而是能理解專案、操作工具,並把工作推進到可檢查的結果。

它最適合有版本控制、可測試流程與明確驗收條件的工作,而不是把整台電腦交給 AI 自由發揮。

第一次使用時,先從只讀探索開始,再依序加入計畫、最小修改與驗收,你會更快建立真正可長期使用的工作方式。


Claude Code 常見問題

Claude Code 是免費的嗎?

Claude Code 不是單純的免費工具,通常要使用支援的 Claude 方案,或連接 Anthropic Console API 並按量計費。

不會寫程式也能使用 Claude Code 嗎?

可以用它理解專案與完成小任務,但你仍要能判斷檔案差異、測試結果、帳單與權限,不能盲目接受修改。

Claude Code 支援 Windows 嗎?

支援原生 Windows 安裝,但截至 2026 年 8 月,原生 Windows 沒有與 macOS/Linux 相同的 sandbox 支援。

Claude Code 會不會自己修改檔案?

能否直接修改取決於目前權限模式、規則與環境,所以每次開始都應確認模式,不能假設永遠會逐項詢問。

設定 ANTHROPIC_API_KEY 會另外收費嗎?

可能會,因為 Claude Code 可能改用 Console API 路徑,並依模型與 Token 用量產生獨立帳單。

CLAUDE.md 一定要有嗎?

不是必要條件,但它能保存專案命令、慣例與完成標準;內容應精簡,且不能把它當成硬性安全權限。


官方資料與延伸閱讀

本文的功能、方案、價格與權限資訊查核於 2026 年 8 月 30 日,產品更新後請以官方文件為準。

Frank Chiu
Frank Chiu

SEO/GEO 顧問、行銷顧問。協助本地企業與跨國企業導入 SEO、GEO 跟行銷方案,包括:雀巢、凱基銀行、大人學、居家先生、IKEA、vocus 等。

訂閱電子報