這篇 Claude Code 教學將帶你全面認識 Anthropic 推出的 AI 編程工具 Claude Code。Claude Code 是一款基於終端機(Terminal)的 AI 編程助手,能夠理解你的整個程式碼庫、編輯檔案、執行指令,並與你的開發工具無縫整合。無論你是想快速建立功能、修復 Bug,還是自動化開發流程,Claude Code 都能透過自然語言對話幫你完成。
Claude Code 是什麼(What is Claude Code)
Claude Code 是 Anthropic 開發的代理式編程工具(Agentic Coding Tool),它不只是一個簡單的程式碼補全工具,而是一個能夠自主理解專案、規劃任務、跨多個檔案撰寫與修改程式碼的 AI 助手。它能直接在你的終端機中運作,也支援 VS Code、JetBrains IDE、桌面應用程式和瀏覽器等多種環境。
簡單來說,Claude Code 可以幫你做到以下這些事情:
- 閱讀與理解整個程式碼庫:自動分析專案結構、檔案之間的依賴關係
- 跨多檔案撰寫與修改程式碼:根據你的描述,同時修改多個相關檔案
- 執行終端機指令:直接在終端機中執行測試、建置、部署等操作
- 管理 Git 工作流:建立分支、提交變更、開啟 Pull Request
- 連接外部工具:透過 MCP 協議與資料庫、Jira、Slack 等工具互動
- 自動化重複任務:撰寫測試、修復 Lint 錯誤、解決合併衝突、更新依賴套件
Claude Code 與其他 AI 編程工具的差異
目前市面上有多種 AI 編程工具,以下是 Claude Code 與主流工具的比較:
| 比較項目 | Claude Code | GitHub Copilot | ChatGPT |
|---|---|---|---|
| 運作方式 | 終端機 / IDE / 桌面應用 / 瀏覽器 | IDE 內嵌 | 網頁對話介面 |
| 核心能力 | 代理式:理解專案、規劃任務、自主執行 | 即時程式碼補全與建議 | 對話式程式碼生成與解釋 |
| 專案理解 | 能讀取整個程式碼庫 | 主要理解當前檔案上下文 | 僅限貼上的程式碼片段 |
| 檔案操作 | 可同時修改多個檔案 | 主要操作單一檔案 | 不能直接操作檔案 |
| 指令執行 | 可直接執行終端機指令 | 不能執行指令 | 不能執行指令 |
| Git 整合 | 完整 Git 操作 | 支援 PR 摘要等部分支援 | 無 |
| 適合場景 | 功能開發、重構、除錯、自動化 | 日常編碼、程式碼補全 | 學習、概念探索、除錯建議 |
最有效率的開發團隊往往會同時使用多種工具:在 IDE 中用 Copilot 處理即時編碼,用 Claude Code 處理需要深入思考的功能開發、重構和除錯任務。
系統需求(System Requirements)
在安裝 Claude Code 之前,請確認你的環境符合以下需求:
| 需求項目 | 說明 |
|---|---|
| 作業系統 | macOS、Linux、Windows(原生或 WSL) |
| 帳號需求 | Claude Pro / Max 訂閱 或 Anthropic Console API 帳號 |
| Windows 額外需求 | 需安裝 Git for Windows |
| 網路 | 需要穩定的網路連線 |
Claude Code 安裝教學(Installation)
Claude Code 提供多種安裝方式,以下分別介紹每種方法的安裝步驟。
方法一:原生安裝(推薦)
原生安裝是官方最推薦的方式,安裝後會自動在背景更新,確保你隨時使用最新版本。
macOS / Linux / WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
如果你在 Windows PowerShell 中看到「The token ‘&&’ is not a valid statement separator」的錯誤,代表你正在 PowerShell 而非 CMD 中執行。請確認你的命令提示字元顯示的是 C:\> 而不是 PS C:\>。
方法二:Homebrew 安裝(macOS / Linux)
如果你習慣使用 Homebrew 管理套件,也可以透過以下指令安裝:
brew install --cask claude-code
注意:Homebrew 安裝不會自動更新,你需要定期執行以下指令來取得最新版本:
brew upgrade claude-code
方法三:WinGet 安裝(Windows)
Windows 使用者也可以透過 WinGet 套件管理員安裝:
winget install Anthropic.ClaudeCode
同樣地,WinGet 安裝不會自動更新,需要定期手動更新:
winget upgrade Anthropic.ClaudeCode
方法四:npm 安裝
如果你的環境已經有 Node.js,也可以透過 npm 全域安裝:
npm install -g @anthropic-ai/claude-code
不過官方目前更推薦使用原生安裝方式,因為它能自動處理更新。
安裝方式比較
| 安裝方式 | 適用平台 | 自動更新 | 推薦程度 |
|---|---|---|---|
| 原生安裝 | macOS / Linux / Windows | ✔ 是 | ★★★ 最推薦 |
| Homebrew | macOS / Linux | ✘ 否 | ★★ 適合 Homebrew 使用者 |
| WinGet | Windows | ✘ 否 | ★★ 適合 Windows 使用者 |
| npm | 所有平台 | ✘ 否 | ★ 備用方案 |
第一次啟動 Claude Code
安裝完成後,開啟終端機,進入你的專案目錄,然後執行以下指令:
cd your-project
claude
第一次啟動時,Claude Code 會引導你進行身份驗證。你可以選擇以下其中一種方式登入:
- Claude 訂閱帳號:如果你有 Claude Pro 或 Max 訂閱,直接使用你的 Claude 帳號登入即可
- Anthropic Console API Key:如果你使用 API 存取,需要在 Anthropic Console 中取得 API Key
登入完成後,你就可以開始與 Claude Code 對話了。試試輸入以下指令:
# 讓 Claude 分析你的專案結構
請幫我分析這個專案的架構
# 讓 Claude 撰寫測試
幫 auth 模組寫測試,執行測試,並修復任何失敗
# 讓 Claude 提交變更
用有意義的訊息提交我的變更
VS Code 與 IDE 整合
除了終端機之外,Claude Code 也提供 VS Code 和 JetBrains IDE 的擴充套件,讓你可以在編輯器中直接使用。
VS Code 安裝方式
- 開啟 VS Code
- 按下
Cmd+Shift+X(Mac)或Ctrl+Shift+X(Windows/Linux)開啟擴充功能面板 - 搜尋「Claude Code」
- 點擊安裝
- 安裝後按
Cmd+Shift+P/Ctrl+Shift+P,輸入「Claude Code」,選擇「Open in New Tab」
VS Code 擴充套件提供了行內差異比較(Inline Diffs)、@-mentions 檔案引用、計畫審查(Plan Review)等功能,讓開發體驗更加順暢。
JetBrains IDE 安裝方式
支援 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains 系列 IDE。從 JetBrains Marketplace 搜尋並安裝「Claude Code」外掛,重新啟動 IDE 即可使用。
桌面應用程式(Desktop App)
Claude Code 也提供獨立的桌面應用程式,適合不想在 IDE 或終端機中操作的使用者。桌面應用支援視覺化差異比較、多工作階段同時運作、排程任務等功能。
下載連結:
- macOS:支援 Intel 和 Apple Silicon
- Windows:支援 x64 和 ARM64
安裝後啟動 Claude,登入帳號,點擊「Code」分頁即可開始使用。需要 Claude Pro 或 Max 訂閱。
網頁版(Web)
如果你不想安裝任何東西,也可以直接在瀏覽器中使用 Claude Code。前往 claude.ai/code 即可開始。網頁版適合執行長時間任務、處理不在本機的程式碼庫,或是同時平行處理多個任務。
API Key 設定(適用 API 使用者)
如果你使用 Anthropic Console API 而非 Claude 訂閱方案,需要設定 API Key:
- 前往
console.anthropic.com並登入 - 在 API Keys 頁面建立一組新的金鑰
- 複製金鑰並設定環境變數:
# macOS / Linux
export ANTHROPIC_API_KEY=your-api-key-here
# 加入 shell 設定檔讓每次開啟終端機都生效
echo 'export ANTHROPIC_API_KEY=your-api-key-here' >> ~/.zshrc
設定完成後,執行 claude 指令時就會自動使用這組 API Key 進行驗證。
Claude Code 方案與費用
使用 Claude Code 需要以下其中一種方案:
| 方案 | 費用 | 說明 |
|---|---|---|
| Claude Pro | USD $20/月 | 包含 Claude Code 基本使用額度 |
| Claude Max | USD $100/月起 | 更高的使用額度,適合重度使用者 |
| API(按量計費) | 依使用量 | 透過 Anthropic Console,按 Token 用量計費 |
總結
Claude Code 是目前最強大的代理式 AI 編程工具之一。它不只是補全程式碼,而是能夠理解你的整個專案、自主規劃和執行複雜的開發任務。無論你偏好終端機、IDE 還是瀏覽器,都能找到適合的使用方式。
建議從原生安裝開始,在你的專案中試試看 Claude Code 的威力。下一篇文章我們將深入介紹 Claude Code 的基本操作和實際使用技巧,幫助你更快上手。
延伸閱讀
- Claude Code 新手上路:第一次使用就上手
- CLAUDE.md 專案記憶:讓 Claude 記住你的專案規範
- Claude Code CLI 指令完整參考
- Context 管理與 Token 優化技巧
- Slash Commands 與快捷鍵完整指南