Claude Code 5 分鐘入門指南

不管你是程式老手還是完全新手，這篇指南會讓你在 5 分鐘內開始使用 Claude Code。

---

什麼是 Claude Code？

Claude Code 是 Anthropic 官方推出的 AI 編程助手，有幾個特點：

• CLI 介面：在終端機（命令列）中使用，不綁定特定編輯器
• 理解整個專案：不只看單一檔案，能理解你的整個程式碼庫
• 自然語言操作：用中文或英文描述你想做的事，它就會幫你做

跟其他工具比較

工具	類型	特點
Claude Code	CLI	終端機操作、專案級理解、高度可自訂
Cursor	IDE	圖形介面、整合編輯器、即開即用
GitHub Copilot	插件	行級補全、IDE 整合、輕量

選擇建議：

• 喜歡終端機、想要更多控制 → Claude Code
• 喜歡圖形介面、想要即開即用 → Cursor
• 只需要程式碼補全 → Copilot

---

安裝 Claude Code

系統需求

• macOS 10.15+、Ubuntu 20.04+/Debian 10+、或 Windows 10+
• Windows 需要 WSL、WSL 2 或 Git for Windows

安裝方式（選一種）

方式一：官方安裝腳本（推薦）

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

方式二：Homebrew（macOS）

brew install --cask claude-code

方式三：npm（需要 Node.js 18+）

npm install -g @anthropic-ai/claude-code

⚠️ 注意：不要用 sudo npm install -g，會有權限問題。

確認安裝成功

claude --version

看到版本號就表示安裝成功！如果遇到問題，可以執行 claude doctor 檢查。

---

第一次使用

步驟 1：啟動 Claude Code

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

cd /你的專案路徑
claude

步驟 2：登入

第一次使用會要求登入，有兩種方式：

1. Anthropic 帳號（推薦）：直接用網頁登入
2. API Key：如果你有 API Key，可以直接輸入

步驟 3：開始對話

登入後就可以直接跟 Claude 對話了！

試試看輸入：

幫我看一下這個專案的結構

或

這個專案是做什麼的？

Claude 會分析你的專案並回答。

---

基本操作範例

讀取和理解程式碼

解釋一下 src/index.js 在做什麼

這個專案的主要功能有哪些？

寫程式碼

幫我寫一個函數，可以驗證 email 格式

在 src/utils/ 新增一個日期格式化的工具

修改程式碼

把 login 函數加上錯誤處理

重構 UserService，把重複的程式碼抽出來

除錯

這段程式碼有 bug，幫我找出來

為什麼這個 API 會回傳 500 錯誤？

---

新手常見問題

Q: 需要會寫程式嗎？

不需要！ 但會更好。

Claude Code 可以：

• 幫完全不會寫程式的人從零開始建立專案
• 幫有經驗的開發者加速開發

不過，如果你有基本的程式概念，會更容易理解 Claude 在做什麼。

Q: 要付費嗎？

是的，有幾種方式：

1. Claude Pro/Max 訂閱：月費制，最簡單
2. API Key：按使用量付費，適合重度使用者
3. 企業方案：團隊使用

建議新手先用訂閱方案，不用擔心 API 費用。

詳細價格請查看 Anthropic 官網。

Q: 跟 ChatGPT 寫程式有什麼不同？

最大的差別是 Claude Code 可以直接操作你的檔案：

• ChatGPT：給你程式碼，你要自己複製貼上
• Claude Code：直接幫你寫入檔案、執行指令

這讓開發效率提升非常多。

Q: 安全嗎？我的程式碼會被看到嗎？

• 程式碼會傳送到 Anthropic 的伺服器進行處理
• Anthropic 不會用你的程式碼來訓練模型
• 如果有機密程式碼，建議使用企業方案

---

下一步

恭喜你完成入門！接下來可以：

1. 加入社群：Claude World Taiwan Discord 有問題隨時問
2. 參加 Cowork：每週三 22:00 線上共作，跟其他人一起學習
3. 看進階教學：學習 Director Mode 讓 Claude 更聽話
4. 探索 CLAUDE.md：了解如何 設定專案規則 讓 AI 更理解你的專案

---

快速指令參考

指令	說明
claude	啟動 Claude Code
claude --help	查看幫助
claude --version	查看版本
/help	在對話中查看可用指令
/clear	清除對話歷史
Ctrl+C	中斷目前操作

---

有任何問題，歡迎到 Discord 的 #help 頻道發問！