章节导航

从零开始，在四十分钟内让 Claude Code 在你自己的电脑上跑起来，并完成第一次真实的代码改动。

本章是整套教程的入口。目标只有一个，就是把 Claude Code 从一个陌生的名词，变成你终端里一个能干活的助手。为了不让新手在装工具这一步就卡住，本章按照真实使用顺序把内容拆成了四个子页面，每一页只讲一件事，读完就能动手做。

阅读顺序

我们建议按下面的顺序一页一页往下走。这四个子页面之间是有依赖关系的，跳读容易在后面撞坑。

• 安装 Claude Code，讲清楚 macOS、Windows、Linux 三种系统上装 Claude Code 的三条主要路径，Native 一键脚本、Homebrew、Winget，并解释 Node.js 依赖、二进制文件落到哪、如何用 claude --version 验证装成功了没有。
• 登录与认证，覆盖 Claude 订阅账号交互式登录、Anthropic API Key、Bedrock 与 Vertex 三条认证通道，讲 claude login 与 claude logout 的用法、多身份的配置写法，以及国内网络下走代理该怎么设置。
• 第一次运行，端到端跑一次真实任务。我们会走进一个 Node.js 小项目，让 Claude Code 为它加一个 /health 端点，观察它读文件、改文件、跑测试的完整过程，理解 Read、Edit、Write、Bash 这几个基础工具到底在做什么。
• 常见安装问题，把新手最容易踩的坑集中列出来。Node 版本太老、Windows 长路径、公司内网 SSL 证书、代理设置、macOS Xcode 命令行工具缺失，每一个坑都按现象、根因、解法三段式讲清楚。

学完这一章你能拿到什么

读完这一章，你会具备三样东西。

第一，你的电脑上有一个能跑的 claude 命令，任何终端窗口里输入 claude --version 都能拿到版本号。第二，你至少完成了一次真实的代码改动，知道 Claude Code 在对话过程中的每一步都在干嘛，不再把它当成黑箱。第三，你手上有一份排错手册，装出问题时不用满互联网瞎找答案。

前置条件

你需要一台能联网的电脑，一个终端，以及一个你熟悉的代码项目。如果暂时没有合适的项目也没关系，本章第三节会带你从零建一个最小的 Node.js 项目练手。此外你需要一个 Claude 账号，Pro、Max、Team、Enterprise 订阅或 Anthropic Console 的 API Key 三选一即可。企业用户走 Bedrock 或 Vertex 也在覆盖范围内。

小提示

教程里的所有命令都是可以直接复制粘贴执行的。遇到与你系统提示不一样的地方先别慌，翻到第四节按照三段式对照排查，八成能找到答案。