​
系統需求

  • 作業系統：macOS 10.15+、Ubuntu 20.04+/Debian 10+，或透過 WSL 的 Windows
  • 硬體：最少 4GB RAM
  • 軟體：
    • Node.js 18+
    • git 2.23+（選用）
    • GitHub 或 GitLab CLI 用於 PR 工作流程（選用）
  • 網路：需要網際網路連線進行驗證和 AI 處理
  • 地區：僅在支援的國家提供

​
安裝和驗證

1

安裝 Claude Code

To install Claude Code, run the following command:

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

導航到您的專案

cd your-project-directory
3

啟動 Claude Code

claude
4

完成驗證

Claude Code 提供多種驗證選項：

  1. Anthropic Console：預設選項。透過 Anthropic Console 連接並 完成 OAuth 流程。需要在 console.anthropic.com 啟用計費。
  2. Claude App（Pro 或 Max 方案）：訂閱 Claude 的 Pro 或 Max 方案，獲得包含 Claude Code 和網頁介面的統一訂閱。以相同價格獲得更多價值，同時在一個地方管理您的帳戶。使用您的 Claude.ai 帳戶登入。在啟動期間，選擇符合您訂閱類型的選項。
  3. 企業平台：配置 Claude Code 使用 Amazon Bedrock 或 Google Vertex AI 進行企業部署，搭配您現有的雲端基礎設施。

​
初始化您的專案

對於首次使用者，我們建議：

1

啟動 Claude Code

claude
2

執行簡單指令

> summarize this project
3

產生 CLAUDE.md 專案指南

/init
4

提交產生的 CLAUDE.md 檔案

請 Claude 將產生的 CLAUDE.md 檔案提交到您的儲存庫。

​
疑難排解

​
WSL 安裝疑難排解

目前，Claude Code 無法直接在 Windows 上執行，而是需要 WSL。

您可能在 WSL 中遇到以下問題：

作業系統/平台偵測問題：如果您在安裝期間收到錯誤，WSL 可能正在使用 Windows npm。請嘗試：

  • 在安裝前執行 npm config set os linux
  • 使用 npm install -g @anthropic-ai/claude-code --force --no-os-check 安裝（請勿使用 sudo）

找不到 Node 錯誤：如果您在執行 claude 時看到 exec: node: not found，您的 WSL 環境可能正在使用 Windows 安裝的 Node.js。您可以使用 which npm 和 which node 確認這一點，它們應該指向以 /usr/ 開頭的 Linux 路徑，而不是 /mnt/c/。要修復此問題，請嘗試透過您的 Linux 發行版套件管理器或透過 nvm 安裝 Node。

​
最佳化您的終端設定

Claude Code 在您的終端正確配置時效果最佳。請遵循這些指導原則來最佳化您的體驗。

支援的 shell：

  • Bash
  • Zsh
  • Fish

​
主題和外觀

Claude 無法控制您終端的主題。這由您的終端應用程式處理。您可以在入門期間或隨時透過 /config 指令將 Claude Code 的主題與您的終端匹配

​
換行

您有幾種選項可以在 Claude Code 中輸入換行：

  • 快速跳脫：輸入 \ 後按 Enter 建立新行
  • 鍵盤快捷鍵：透過適當配置按 Option+Enter（Meta+Enter）

在您的終端中設定 Option+Enter：

對於 Mac Terminal.app：

  1. 開啟設定 → 描述檔 → 鍵盤
  2. 勾選「使用 Option 作為 Meta 鍵」

對於 iTerm2 和 VSCode 終端：

  1. 開啟設定 → 描述檔 → 按鍵
  2. 在一般設定下，將左/右 Option 鍵設為「Esc+」

iTerm2 和 VSCode 使用者提示：在 Claude Code 中執行 /terminal-setup 以自動配置 Shift+Enter 作為更直觀的替代方案。

​
通知設定

透過適當的通知配置，永遠不會錯過 Claude 完成任務的時機：

​
終端鈴聲通知

在任務完成時啟用聲音警報：

claude config set --global preferredNotifChannel terminal_bell

對於 macOS 使用者：別忘了在系統設定 → 通知 → [您的終端應用程式] 中啟用通知權限。

​
iTerm 2 系統通知

對於任務完成時的 iTerm 2 警報：

  1. 開啟 iTerm 2 偏好設定
  2. 導航到描述檔 → 終端
  3. 啟用「靜音鈴聲」和篩選警報 → 「傳送跳脫序列產生的警報」
  4. 設定您偏好的通知延遲

請注意，這些通知專屬於 iTerm 2，在預設的 macOS 終端中不可用。

​
處理大型輸入

在處理大量程式碼或長指令時：

  • 避免直接貼上：Claude Code 可能難以處理非常長的貼上內容
  • 使用基於檔案的工作流程：將內容寫入檔案並要求 Claude 讀取
  • 注意 VS Code 限制：VS Code 終端特別容易截斷長貼上內容

​
Vim 模式

Claude Code 支援 Vim 按鍵綁定的子集，可以透過 /vim 啟用或透過 /config 配置。

支援的子集包括：

  • 模式切換：Esc（到 NORMAL）、i/I、a/A、o/O（到 INSERT）
  • 導航：h/j/k/l、w/e/b、0/$/^、gg/G
  • 編輯：x、dw/de/db/dd/D、cw/ce/cb/cc/C、.（重複）