入门与安装

这一组解决一个问题：先让 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