入門與安裝

這一組解決一個問題：先讓 Claude Code 在你的真實環境里正確跑起來。不要一上來就配 MCP、Hooks（鉤子）或 Subagents（子 Agent）；先確認它是什麼、裝在哪、用哪個賬號登入、日常入口選哪一個。

1. 這一組包含什麼

入門與安裝一共 4 章：

• Claude Code 是什麼：先理解它不是聊天框，而是進入專案現場的智慧體式程式設計工具（agentic coding tool）。
• 安裝和更新 Claude Code：選擇官方原生安裝器（native installer）、Homebrew、WinGet 或 Linux 包管理器，並驗證 PATH（命令搜尋路徑）、claude doctor 和更新策略。
• 登入與認證：區分 Claude.ai 訂閱、Console API key（控制台 API 金鑰）、Teams、Enterprise、Bedrock、Vertex AI、Microsoft Foundry。
• 選擇平臺與整合：判斷日常主入口用 CLI（終端命令列）、Desktop（桌面應用）、IDE、Web（網頁）、Mobile（移動端）、Slack 還是 CI/CD。

flowchart TD
    Concept["理解產品定位"]
    Install["安裝和更新"]
    Auth["登入與認證"]
    Platform["選擇平臺入口"]
    Core["進入核心配置"]

    Concept --> Install
    Install --> Auth
    Auth --> Platform
    Platform --> Core

    style Concept fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
    style Auth fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
    style Core fill:#dcfce7,stroke:#22c55e,stroke-width:2px

2. 章節入口

3. 推薦閱讀順序

新手按這個順序讀：

1. 先讀“Claude Code 是什麼”，確認它適合你的工作方式。
2. 再讀“安裝和更新 Claude Code”，按你的系統選一個安裝路徑，不要混裝。
3. 然後讀“登入與認證”，避免 Claude.ai、Console API key（控制台 API 金鑰）和雲供應商憑據互相覆蓋。
4. 最後讀“選擇平臺與整合”，確定日常主入口。

如果你已經裝好了，可以按問題跳：

• claude 命令不存在：看安裝章節的 PATH（命令搜尋路徑）和 claude doctor。
• 版本不對或更新混亂：看安裝章節的更新策略和混裝排查。
• 登入後還是不能用：看認證章節的憑據優先順序。
• 團隊要接 Bedrock / Vertex / Foundry：看認證章節的企業雲供應商部分。
• 不知道終端、桌面應用、IDE、網頁入口怎麼選：看平臺章節的入口矩陣。

4. 先不要做什麼

入門階段先不要急著做這些：

• 一上來開放 bypassPermissions。
• 直接接很多 MCP。
• 把團隊所有規則塞進 CLAUDE.md。
• 先寫 Hooks（鉤子）、Skills（技能）、Subagents（子 Agent）。
• 把 Claude Code SDK 接進產品。

這些都屬於後續章節。入門階段的目標是先得到一個穩定、可解釋、可復現的本機入口。

5. 完成後的驗收標準

讀完這一組，你應該能做到：

• 能解釋 Claude Code 和普通聊天式程式設計助手的區別。
• 能在自己的系統上安裝並驗證版本。
• 能執行 claude doctor 或等價診斷流程。
• 能說清當前登入走的是 Claude.ai、Console、Bedrock、Vertex AI 還是 Foundry。
• 能判斷日常主入口用終端、桌面應用、IDE 還是網頁。
• 能知道什麼時候需要移動端、Slack、GitHub Actions 或 CI/CD 整合。
• 能進入下一組核心配置，而不是繼續靠預設設定亂跑。

6. 官方資料

• Claude Code overview
• Quickstart
• Advanced setup
• Authentication
• Platforms and integrations