---
title: "入門與安裝"
description: "Claude Code 入門與安裝：用 4 章完成產品定位、安裝更新、登入認證、平臺入口選擇，先把終端、桌面應用、IDE、網頁和雲供應商邊界理清。"
canonical: "https://xiangyugongzuoliu.com/tag/claude-code"
verifiedAt: "2026-05-08"
---

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

> [!NOTE]
> **適合從這裡開始的人**：第一次安裝 Claude Code、換電腦重灌、登入方式混亂、終端 / 桌面應用 / IDE / 網頁入口不知道怎麼選，或者要給團隊寫一份最小上手路徑。

## 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。

```mermaid
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. 章節入口

<Cards>
  <Card title="Claude Code 是什麼" description="先理解產品定位、智慧體迴圈、適合任務和不適合任務，再決定要不要安裝。" href="/zh-Hant/docs/claude-code/official/00-getting-started/overview" />
  <Card title="安裝和更新 Claude Code" description="按系統選擇安裝方式，處理 PATH、版本驗證、claude doctor、混裝和更新策略。" href="/zh-Hant/docs/claude-code/official/00-getting-started/install" />
  <Card title="登入與認證" description="個人、團隊、Console、Bedrock、Vertex AI、Microsoft Foundry 的認證路徑和優先順序。" href="/zh-Hant/docs/claude-code/official/00-getting-started/authentication" />
  <Card title="選擇平臺與整合" description="終端、桌面應用、IDE、網頁、移動端、Slack、CI/CD 各自適合什麼任務。" href="/zh-Hant/docs/claude-code/official/00-getting-started/platforms" />
</Cards>

## 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 接進產品。

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

> [!IMPORTANT]
> **安裝完成不等於配置完成**：能執行 `claude` 只是第一步。真正穩定使用前，還要繼續讀 settings、permissions 和 memory。

## 5. 完成後的驗收標準

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

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

## 6. 官方資料

- [Claude Code overview](https://code.claude.com/docs/en/overview)
- [Quickstart](https://code.claude.com/docs/en/quickstart)
- [Advanced setup](https://code.claude.com/docs/en/setup)
- [Authentication](https://code.claude.com/docs/en/authentication)
- [Platforms and integrations](https://code.claude.com/docs/en/platforms)

<Cards>
  <Card title="下一組：核心配置與能力" description="安裝和登入之後，繼續整理 settings（設定）、permissions（許可權）、memory（記憶）和 MCP。" href="/zh-Hant/docs/claude-code/official/01-core-capabilities" />
  <Card title="總入口：官方教程中文版" description="回到總覽，檢視 14 章完整學習路徑。" href="/zh-Hant/docs/claude-code/official" />
</Cards>
