建立 2026-09-15 更新 2026-09-15

安裝與登入

先決定你主要從哪裡用 Claude Code，再安裝對應的客戶端。CLI、VS Code 擴充套件與桌面應用共用同一組登入；JetBrains 外掛需要另外裝 CLI。

官方步驟見 Quickstart 與進階設定。

你需要什麼帳號

Claude 訂閱（建議日常使用）：Pro、Max、Team、Enterprise。
Claude Console：用 API 預付額度。第一次登入會自動建立 Claude Code workspace 方便對帳。
企業雲：Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry，或組織自架的 gateway。

若已設定環境變數 ANTHROPIC_API_KEY，啟動時會跳過瀏覽器登入、改請你核准該金鑰。之後要換帳號，在 session 裡打 /login。

安裝 Claude Code CLI

建議用官方原生安裝程式，它會在背景自動更新。

macOS / Linux / WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

Windows CMD（提示字元沒有 PS 時才用）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

原生 Windows 建議同時裝 Git for Windows，Claude 才能用 Bash 工具；沒裝則改用 PowerShell。WSL 不需要 Git for Windows。

也可用套件管理員：

brew install --cask claude-code

winget install Anthropic.ClaudeCode

Homebrew 與 WinGet 不會自動更新，要自己 brew upgrade claude-code 或 winget upgrade Anthropic.ClaudeCode。claude-code cask 走穩定通道（大約晚一週）；要最新版用 claude-code@latest。

裝好後確認版本：

claude --version

應印出版號與 (Claude Code)。然後進專案啟動：

cd ~/code/your-project
claude

第一次會開瀏覽器完成授權。

安裝 IDE 擴充套件

VS Code 與 Cursor：在擴充套件市集搜尋 Claude Code，或看官方 VS Code 說明。裝好後用命令選擇盤搜尋 Claude Code，在新分頁開啟。

JetBrains（IntelliJ、PyCharm、WebStorm 等）：從 Marketplace 裝 Claude Code 外掛，並另外安裝 CLI。細節見 IDE 擴充套件。

桌面應用與網頁

桌面 App 內建 Claude Code，不必再裝 CLI。從官方下載 macOS 或 Windows 版本，登入後開「程式碼」分頁。需要付費訂閱。

不想裝本機工具時，直接到 claude.ai/code 在瀏覽器跑任務。見桌面、網頁與 CI。

登入後先做這三件事

打 /help 看指令；用 /resume 找回舊對話。
按 Shift+Tab 看目前權限模式。日常建議先看懂 Manual／Auto／Plan，再決定要不要放寬。
在乾淨的 Git 狀態下開始。改壞可用 Rewind（連續按兩下 Esc）回到較早的檢查點。

不要把密鑰寫進 prompt 或 repo

API key、.env、雲端 secrets 都不要貼進對話。需要外部服務時，用環境變數或 MCP，不要把真實金鑰寫進 CLAUDE.md。