2-2: 本機環境需求與安裝流程

💻 系統需求

作業系統：macOS 10.15+、Windows 10+、Linux (Ubuntu 20.04+)
Node.js：18+ 或 Python 3.9+
Git：2.0+
記憶體：至少 4GB RAM
網路連線：穩定的網際網路（API 呼叫）
瀏覽器：Chrome、Firefox、Safari 或 Edge（OAuth 驗證用）

📦 安裝步驟

方式 1：使用 npm（推薦）

# 安裝 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 驗證安裝
claude --version
# 輸出：claude-code v1.2.0

方式 2：使用 pip

# 安裝 Claude Code CLI
pip install claude-code

# 驗證安裝
claude --version

方式 3：使用 Homebrew (macOS)

# 透過 Homebrew 安裝
brew install claude-code

# 驗證安裝
claude --version

🔐 驗證方式選擇

Claude Code 提供兩種驗證方式：API Key 和 OAuth 訂閱制。根據你的使用情境選擇合適的方式。

驗證方式	適用情境	優點	缺點
API Key	開發測試、個人專案、一次性使用	設定簡單、即刻可用、按使用量付費	需要手動管理 Key、安全性較低
OAuth 訂閱制	生產環境、團隊協作、長期使用	自動續訂、安全性高、團隊權限管理、無使用量限制	需要訂閱費用、初次設定較複雜

🔑 方式 1：API Key 設定（快速開始）

步驟 1：取得 API Key

前往 https://console.anthropic.com
登入你的 Anthropic 帳號
點選「API Keys」→「Create New Key」
複製生成的 API Key（格式：sk-ant-xxxxx）

步驟 2：設定環境變數

macOS / Linux：

# 方式 1：暫時設定（僅本次終端階段有效）
export ANTHROPIC_API_KEY="sk-ant-your-key-here"

# 方式 2：永久設定（加入 shell 設定檔）
echo 'export ANTHROPIC_API_KEY="sk-ant-your-key-here"' >> ~/.zshrc
source ~/.zshrc

# 或使用 Claude CLI 設定
claude config set api-key sk-ant-your-key-here

Windows：

# PowerShell
$env:ANTHROPIC_API_KEY="sk-ant-your-key-here"

# 或使用系統環境變數（永久）
# 控制台 → 系統 → 進階系統設定 → 環境變數
# 新增變數：ANTHROPIC_API_KEY = sk-ant-your-key-here

步驟 3：測試連線

# 測試 API Key 是否正確設定
claude test

# 輸出：
# ✅ API Key 驗證成功
# ✅ 連線到 Claude API 正常
# 帳戶額度：$100.00 剩餘

安全提醒：

不要將 API Key 提交到 Git repository
將 .env 加入 .gitignore
定期更換 API Key
生產環境建議使用 OAuth 訂閱制

🎫 方式 2：OAuth 訂閱制設定（推薦正式使用）

        📊 訂閱方案比較
        
              方案
              月費
              使用額度
              適用對象
            
              個人版
              $20 / 月
              無限制使用
              個人開發者
            
              專業版
              $50 / 月
              無限制 + 優先支援
              專業開發者、小型團隊
            
              團隊版
              $200 / 月
              無限制 + 團隊管理 + SLA
              企業團隊

方案	月費	使用額度	適用對象
個人版	$20 / 月	無限制使用	個人開發者
專業版	$50 / 月	無限制 + 優先支援	專業開發者、小型團隊
團隊版	$200 / 月	無限制 + 團隊管理 + SLA	企業團隊

步驟 1：訂閱 Claude Code

前往 https://claude.ai/subscribe
選擇適合的訂閱方案
完成付款設定（信用卡或 PayPal）
確認訂閱啟用

步驟 2：OAuth 登入

# 啟動 OAuth 驗證流程
claude login

# CLI 會自動：
# 1. 開啟瀏覽器到 https://claude.ai/auth
# 2. 要求你登入 Anthropic 帳號
# 3. 授權 Claude Code CLI 存取
# 4. 自動將 token 儲存到本機

# 輸出：
# 🌐 Opening browser for authentication...
# ⏳ Waiting for authorization...
# ✅ Successfully authenticated as user@example.com
# 🔐 Credentials saved to ~/.claude/auth.json

步驟 3：驗證登入狀態

# 查看目前登入狀態
claude whoami

# 輸出：
# 👤 使用者：user@example.com
# 📦 訂閱方案：Professional
# ⏰ 訂閱到期：2026-04-15
# ✅ 狀態：Active

🔄 OAuth Token 管理

# 登出（清除本機 token）
claude logout

# 重新登入
claude login

# 更新 token（自動續期）
claude auth refresh

# 查看 token 資訊
claude auth status

OAuth 優勢：

✅ 自動續期：Token 會自動更新，無需手動管理
✅ 更安全：使用短期 Token，不需要儲存長期 API Key
✅ 團隊管理：支援多人協作與權限控制
✅ 無使用量限制：訂閱期間內無限制使用
✅ 優先支援：專業版以上享有優先客服

🔧 進階設定

自訂設定檔位置

# Claude 預設設定檔位置：
# macOS/Linux: ~/.claude/config.json
# Windows: %USERPROFILE%\.claude\config.json

# 指定自訂設定檔
claude config set --config-file ./my-claude-config.json

# 查看目前設定
claude config list

設定代理伺服器

# 如果你在防火牆後面，需要設定 Proxy
claude config set proxy http://proxy.company.com:8080

# 設定驗證 Proxy
claude config set proxy http://user:pass@proxy.company.com:8080

# 清除 Proxy 設定
claude config unset proxy

設定預設模型

# 設定預設使用的 Claude 模型
claude config set default-model claude-3-5-sonnet-20241022

# 可選模型：
# - claude-3-5-sonnet-20241022 (最新，推薦)
# - claude-3-opus-20240229 (最強，較慢)
# - claude-3-haiku-20240307 (最快，較經濟)

✅ 驗證安裝完成

完整檢查清單

# 1. 版本檢查
claude --version
# 預期輸出：claude-code v1.2.0

# 2. 驗證狀態
claude whoami
# 預期輸出：已登入的使用者資訊

# 3. 測試連線
claude test
# 預期輸出：✅ 所有檢查通過

# 4. 簡單測試
claude chat "Hello, Claude!"
# 預期輸出：Claude 的回應

常見問題排解：

認證失敗：檢查 API Key 或重新 OAuth 登入
網路錯誤：檢查防火牆或 Proxy 設定
權限問題：確認 ~/.claude 目錄有寫入權限
訂閱過期：前往 claude.ai 續訂

🎯 下一步

恭喜！你已經完成 Claude Code 的安裝與驗證設定。在下一課，我們將學習如何進行指令測試與初次操作驗證，確保一切正常運作。

💡 小提示：建議生產環境使用 OAuth 訂閱制，開發測試階段可以先用 API Key 快速上手。