---
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="/docs/claude-code/official/00-getting-started/overview" />
  <Card title="安装和更新 Claude Code" description="按系统选择安装方式，处理 PATH、版本验证、claude doctor、混装和更新策略。" href="/docs/claude-code/official/00-getting-started/install" />
  <Card title="登录与认证" description="个人、团队、Console、Bedrock、Vertex AI、Microsoft Foundry 的认证路径和优先级。" href="/docs/claude-code/official/00-getting-started/authentication" />
  <Card title="选择平台与集成" description="终端、桌面应用、IDE、网页、移动端、Slack、CI/CD 各自适合什么任务。" href="/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="/docs/claude-code/official/01-core-capabilities" />
  <Card title="总入口：官方教程中文版" description="回到总览，查看 14 章完整学习路径。" href="/docs/claude-code/official" />
</Cards>
