第 1 課：入門指南
學習目標
完成本課程後，您將能夠：
- 了解什麼是 Claude Code
- 使用您偏好方法進行安裝
- 完成首次設定與驗證
- 啟動您的第一個工作階段
- 導覽介面並取得說明
先決條件
開始本課程前，請確保您已具備：
- 終端機/命令列存取 - 基本使用熟悉度
- 程式碼編輯器 - 任何編輯器（VS Code、JetBrains 等）
- API 帳號 - Anthropic 帳號用於驗證（在 console.anthropic.com 註冊）
預估時間： 20 分鐘
什麼是 Claude Code？
Claude Code 是一個 AI 驅動的命令列工具，可協助您撰寫、理解和改善程式碼。把它想像成在終端機中隨時可用的專業程式設計夥伴。
Claude Code 能做什麼？
- 撰寫程式碼： 從自然語言描述生成函式、類別和完整功能
- 閱讀與理解： 分析您的程式庫並解釋運作方式
- 編輯與重構： 在保持功能性的同時修改現有程式碼
- 除錯： 協助識別和修復 bug
- 搜尋： 快速導覽複雜的程式庫
- 自動化： 執行指令、管理 git 操作、簡化工作流程
運作原理
Claude Code 使用 Claude（Anthropic 的 AI 助手）結合專門用於檔案操作、程式碼分析和指令執行的特殊工具。
與聊天式 AI 工具不同，Claude Code 可以直接存取您的檔案並在您的環境中執行指令。
安裝
Claude Code 支援多種安裝方法。選擇最適合您系統和工作流程的方法。
方法 1：原生安裝程式（推薦）
原生安裝程式提供最佳的系統整合。
macOS / Linux：
curl -fsSL https://cdn.anthropic.com/claude-code/install.sh | sh
這將會：
- 下載最新的二進位檔案
- 將其安裝到
~/.claude/bin/ - 新增至您的 PATH（如果您確認）
- 設定 shell 自動完成
Windows (PowerShell)：
irm https://cdn.anthropic.com/claude-code/install.ps1 | iex
方法 2：npm
如果您已經安裝 Node.js，可以透過 npm 安裝：
npm install -g @anthropic-ai/claude-code
方法 3：Docker
用於容器化環境：
docker pull anthropic/claude-code:latest
執行：
docker run -it --rm \
-v $(pwd):/workspace \
anthropic/claude-code:latest
驗證安裝
安裝後，驗證是否正常運作：
claude --version
您應該會看到版本資訊顯示。
首次設定
首次執行 Claude Code 時，您需要使用 Anthropic 帳號進行驗證。
步驟 1：啟動 Claude Code
claude
步驟 2：驗證流程
首次啟動時，Claude Code 將引導您完成驗證：
- 按 Enter 開啟瀏覽器進行驗證
- 登入您的 Anthropic 帳號（或尚未註冊則註冊）
- 授予權限給 Claude Code
- 返回終端機 - 您應該會看到成功訊息
步驟 3：設定檢查
Claude Code 將在以下位置建立設定檔：
- Linux/macOS：
~/.config/claude-code/ - Windows：
%APPDATA%\claude-code
這些設定會自動管理，但您稍後可以自訂（在第 6 課中說明）。
您的第一個工作階段
讓我們啟動 Claude Code 並探索介面。
啟動工作階段
只需執行：
claude
您將會看到歡迎訊息和提示：
Claude Code v1.0.0
─────────────────────
Connected: claude-sonnet-4-5
Type your message or use /help for commands
You>
介面說明
提示顯示：
- Version： 您正在執行的 Claude Code 版本
- Model： 啟用的 Claude 模型（例如 claude-sonnet-4-5）
- Prompt： 您輸入訊息的地方
取得說明
輸入 /help 查看可用指令：
You> /help
這將顯示：
- 內建斜線指令（如
/help、/exit、/config） - 鍵盤快捷鍵
- 快速提示
基本導覽
嘗試這些基本互動：
-
提出問題：
You> 你能幫我做什麼？ -
退出工作階段：
You> /exit或按
Ctrl+D
了解架構
Claude Code 以不同模式運作。
聊天模式（預設）
在聊天模式中，您與 Claude 進行對話。Claude 可以：
- 讀取檔案（經您許可）
- 編輯檔案（經您許可）
- 執行指令（經您許可）
- 回答關於您程式碼的問題
指令旗標
Claude Code 接受幾個命令列旗標（在第 2 課詳細說明）：
-p "prompt"- 執行單一提示並退出-c "command"- 使用 Claude 的協助執行指令-r "read"- 讓 Claude 讀取檔案並處理
範例：
claude -p "說明目前目錄的內容"
常見首次問題
Q：使用 Claude Code 安全嗎？
A： 是的。Claude Code 在以下情況需要許可：
- 讀取檔案
- 進行編輯
- 執行指令
- 安裝相依性
您總是在動作執行前審查並核准。
Q：Claude Code 會將我的程式碼傳送給 Anthropic 嗎？
A： Claude Code 在以下情況將檔案內容傳送給 Anthropic 的 API：
- 您要求 Claude 讀取檔案時
- Claude 需要脈絡來回答問題時
- 您使用聊天模式時
資料會安全處理，且未經您的明確選擇加入，不會用於訓練。
Q：我可以在離線狀態使用 Claude Code 嗎？
A： 不可以。Claude Code 需要網際網路連線以透過 Anthropic API 與 Claude 通訊。
Q：Claude Code 和 Claude.ai 有什麼差別？
A：
- Claude.ai 是用於一般對話的網路聊天介面
- Claude Code 是專門用於程式設計任務的 CLI 工具，具有直接檔案存取和指令執行功能
動手試試看
練習 1.1：您的第一次對話
-
導覽至測試專案目錄：
mkdir ~/claude-test
cd ~/claude-test -
啟動 Claude Code：
claude -
進行對話：
You> 你好！你能建立一個簡單的 Python 腳本來列印 "Hello, World" 嗎？ -
遵循 Claude 的回應並在提示時核准檔案建立
-
完成時退出：
You> /exit
練習 1.2：探索說明系統
-
再次啟動 Claude Code
-
檢查可用指令：
You> /help -
詢問特定功能：
You> Claude Code 如何讀取檔案？ -
退出工作階段
✅ 檢查您的理解
回答這些問題以測試您的知識：
-
哪個指令啟動 Claude Code 工作階段？
-
start claude -
claude -
claude-code -
ai claude
-
-
如何在 Claude Code 中取得說明？
-
--help -
/help -
help -
?
-
-
首次執行 Claude Code 時會發生什麼？
- 立即啟動
- 需要透過瀏覽器驗證
- 必須手動建立設定檔
- 需要輸入 API 金鑰
-
**True 或 False：**Claude Code 可以在未經許可的情況下修改您的檔案。
- True
- False
-
-c旗標做什麼？- 建立新檔案
- 使用 Claude 的協助執行指令
- 讀取檔案
- 設定組態
答案： 1-b, 2-b, 3-b, 4-False, 5-b
總結
在本課程中，您學到了：
- 什麼是 Claude Code - AI 驅動的 CLI 程式設計助手
- 如何安裝 - 原生安裝程式、npm 或 Docker
- 如何驗證 - 瀏覽器驗證流程
- 如何啟動工作階段 - 只需執行
claude - 如何取得說明 - 使用
/help指令
下一步
在**第 2 課：基本操作**中，您將學到：
- 聊天模式基礎
- 如何讀取檔案
- 進行編輯
- 理解權限
- 基本指令旗標
進階閱讀
繼續至第 2 課：基本操作 →