本教程面向零基础读者，目标是用一条命令、不装 Node.js、不碰 npm，在 15 分钟内把 Claude Code 跑起来并交付一个可运行的小项目。我们会以 Anthropic 2025 年 10 月正式 GA（General Availability）的原生安装器（Native Installer）为主线，因为它把过去"先装 Node 18+、再用 npm 全局安装、再配 PATH"的三步链路压缩成了一条 curl / PowerShell 命令，是 2026 年官方首推的安装方式。学完你将掌握：安装、首次认证、目录初始化、CLAUDE.md 记忆文件、第一次有效对话、以及一个能直接跑的 TODO CLI 实战。
cd 切目录、会复制粘贴命令即可。如果你连终端都没怎么用过，先用 Terminal（macOS）或 PowerShell（Windows）打开一个窗口跟着敲就行。在过去很长一段时间，Claude Code 只有一种官方安装方式：
npm install -g @anthropic-ai/claude-code
这条命令的背后是一整套隐性依赖链：你需要先有 Node.js 18+，需要 npm，需要全局写入权限，Windows 下还要解决 claude 命令不在 PATH 里的"command not found"问题。对零基础用户，这条链路上的任何一环卡住，整套体验就断了。
2025 年 10 月，Anthropic 宣布原生安装器正式 GA。它把 Claude Code 打包成一个自包含的可执行文件，安装脚本只做三件事：下载二进制、放进标准目录、写入 PATH。没有 Node.js，没有 npm，没有全局权限纠葛。2026 年，它已成为官方文档的推荐路径，Homebrew、WinGet、apt 等包管理器作为补充，npm 退居"兜底方案"。
理解这段演进的意义在于：网上大量 2024–2025 年中段的教程仍在教 npm install，而你今天应当首选原生安装器，避免老路径带来的环境问题。
打开终端，粘贴并回车：
curl -fsSL https://claude.ai/install.sh | bash
预期结果：脚本会自动识别你的操作系统与 CPU 架构（Intel / Apple Silicon / x86_64 / arm64），下载对应的二进制文件到 ~/.local/bin/claude（或系统约定的 bin 目录），并把该目录追加到你的 shell PATH。
安装完成后新开一个终端窗口（让 PATH 生效），然后验证：
claude --version
正常情况下会打印出一行版本号，例如 2.x.x。看到版本号即代表安装成功。
以管理员或普通用户身份打开 PowerShell，执行：
irm https://claude.ai/install.ps1 | iex
脚本会把 claude.exe 放到用户目录下的约定位置并写入用户级 PATH。完成后新开一个 PowerShell 窗口，验证：
claude --version
brew install --cask claude-code，适合已经在用 brew 管理软件的人。winget install Anthropic.ClaudeCode，适合企业内网用 winget 统一分发的场景。npm install -g @anthropic-ai/claude-code，仅在上述方法都不可用时使用，且需要 Node.js 18+。三种信息源交叉印证：Anthropic 官方 setup 文档把"Native Install"列为推荐项；tokenmix 与 morphllm 的 2026 安装指南均确认原生安装器为默认路径；deepwiki 的安装章节同样标注 npm 为 fallback。
原生安装器装好之后，二进制本身只是一个壳，真正驱动它的是你的 Claude 账号或 API key。第一次运行 claude 会进入引导式登录。
在任意目录执行：
claude
首次启动会出现认证选择菜单，常见有三种方式：
sk-ant-... 开头的 key，通过环境变量注入：
bash
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"
Windows PowerShell 用 $env:ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"。适合按 token 计费、想精确控成本的开发者。预期结果：登录成功后，终端底部会出现一条输入框，光标闪烁，等待你的第一条指令。此时你已进入 Claude Code 的交互式会话（REPL）。
https://claude.ai/oauth/... 链接，手动粘到浏览器打开即可。export HTTPS_PROXY=http://your-proxy:port。/login。Claude Code 的工作单位是"目录"——你 cd 到哪里，它就认为哪里是当前项目。我们来建一个干净的练习目录：
mkdir ~/my-first-claude-project && cd ~/my-first-claude-project
Windows：
mkdir $HOME\my-first-claude-project ; cd $HOME\my-first-claude-project
进入目录后再次启动：
claude
此时 Claude Code 会意识到这是一个"空的新项目"，并在会话开始时给你一些初始化建议。
/init 生成 CLAUDE.md 记忆文件CLAUDE.md 是 Claude Code 的项目记忆文件——一段纯 Markdown，每次会话开始时会被自动注入到上下文里，告诉模型这个项目的约定、技术栈、命令、风格偏好。它对输出质量的影响是所有配置项里最大的。
在 REPL 里输入：
/init
预期结果：Claude 会扫描当前目录（虽然现在是空的），并基于你和它的一两句交互，生成一份 CLAUDE.md 草稿，内容通常包括：项目概述、技术栈、构建/测试命令、代码风格约定。
由于目录是空的，生成的会是模板。我们手动把它改成下面这样，为接下来的实战做准备：
# 项目：my-first-claude-project
## 概述
一个用于学习 Claude Code 的练习项目，第一个交付物是一个命令行 TODO 工具。
## 技术栈
- 语言：Node.js（仅运行时需要，开发可依赖 Claude Code 安装器自带的运行环境，或本机 Node）
- 无外部依赖，仅用 Node 标准库（fs、path）
## 约定
- 数据文件存放在项目根目录的 todos.json
- 所有用户可见文案使用中文
- 函数与变量命名使用英文 snake_case
## 常用命令
- 运行：node todo.js
- 测试：手动运行 `node todo.js add "买菜"` 后查看 todos.json
保存后，下一次启动 claude 时，这份内容会自动进入上下文，你会发现它"天然就知道"要用 Node、要用中文、数据存 todos.json。
记忆文件是分层的：项目根
CLAUDE.md（进版本库，团队共享）→ 父目录CLAUDE.md（个人偏好）→~/.claude/CLAUDE.md（全局偏好，所有项目生效）。越靠下层越通用，越靠上层越具体。
现在让 Claude Code 帮我们从零写出第一个可运行程序。在 REPL 里输入：
帮我实现一个命令行 TODO 工具，文件名 todo.js。要求：
1. 支持 add "内容" 增加待办
2. 支持 list 列出所有待办
3. 支持 done <序号> 标记完成
4. 数据存到 todos.json
5. 不引入任何第三方依赖
遵循 CLAUDE.md 里的约定。
预期结果：Claude Code 会创建 todo.js，写入实现，并提示你可以怎么运行。一份典型实现大约 60 行，核心是 fs.readFileSync / fs.writeFileSync 读写 JSON。
退出 REPL（按两次 Ctrl+C 或输入 /exit），在终端验证：
node todo.js add "买菜"
node todo.js add "写周报"
node todo.js list
node todo.js done 1
node todo.js list
预期输出：
$ node todo.js list
1. [完成] 买菜
2. [未完成] 写周报
同时项目根目录会出现一个 todos.json，内容随操作更新。
这就完成了一个最小闭环：需求 → 对话 → 代码 → 运行 → 验证。对零基础读者，这条闭环跑通的意义远大于程序本身——你证明了可以用自然语言驱动一个真实的工程产物。
进入 REPL 后，以 / 开头的是斜杠命令，以 @ 开头的是文件引用。下面是最常用的一组：
| 命令 | 作用 |
|---|---|
/init |
扫描项目并生成 CLAUDE.md 草稿 |
/memory |
快速编辑各层 CLAUDE.md |
/clear |
清空当前会话上下文（保留 CLAUDE.md） |
/help |
查看所有命令 |
/login |
重新登录或切换账号 |
/config |
打开设置（主题、模型、权限等） |
/exit |
退出 REPL |
@todo.js |
把某个文件内容显式喂给上下文 |
Esc Esc |
回溯编辑上一条消息 |
记住一个心法：上下文是有限的资源。当对话变长、模型开始"忘事"或答非所问时，第一反应应当是 /clear 重新开始一个干净会话，而不是继续追问。
flowchart TD
A[打开终端] --> B[curl / PowerShell 一键安装]
B --> C{claude --version<br/>能看到版本?}
C -- 否 --> D[检查 PATH / 重开终端 / 查看常见问题]
D --> B
C -- 是 --> E[cd 到项目目录]
E --> F[claude 启动 REPL]
F --> G[首次认证 /login]
G --> H[/init 生成 CLAUDE.md]
H --> I[编辑 CLAUDE.md 写明约定]
I --> J[自然语言提需求]
J --> K[Claude 生成/修改代码]
K --> L[退出 REPL 运行验证]
L --> M{运行符合预期?}
M -- 否 --> J
M -- 是 --> N[交付 ✅]
把上面几步串起来，完整的从零到可运行过程如下，你可以照着逐行复制：
# 1. 安装（macOS/Linux）
curl -fsSL https://claude.ai/install.sh | bash
# 2. 新开终端，验证
claude --version
# 3. 建项目目录
mkdir ~/my-first-claude-project && cd ~/my-first-claude-project
# 4. 启动并登录
claude
# -> 浏览器登录 claude.ai 授权
# 5. 在 REPL 内初始化记忆
/init
# -> 用编辑器把 CLAUDE.md 改成第六步前的模板，保存
# 6. 在 REPL 内提需求，让它生成 todo.js
# （粘贴第六步的需求块）
# 7. 退出 REPL（Ctrl+C 两次）
# 8. 终端验证
node todo.js add "买菜"
node todo.js list
这套流程的价值在于它的可复现性：换一台新机器，换一个新项目，只要把第 5、6 步的内容换掉，剩下的命令一字不改。这也是为什么"原生安装器 + /init + CLAUDE.md"被视作 2026 年最值得固化的入门基线。
Q：执行 claude 提示 command not found。
A：原生安装器把二进制放进的是用户级 bin 目录，PATH 没刷新。彻底关闭所有终端窗口再开一个；仍不行就手动把 ~/.local/bin（macOS/Linux）或用户 Scripts 目录（Windows）加入 PATH。
Q：我以前用 npm install -g 装过旧版，要不要卸载？
A：建议卸载以避免两套 claude 冲突：npm uninstall -g @anthropic-ai/claude-code，再用原生安装器重装。which -a claude（macOS/Linux）可以看到系统里有几个 claude。
Q：登录后第一次对话就报错 / 转圈不出结果。
A：检查网络与代理。Claude Code 走 HTTPS 到 api.anthropic.com 与 claude.ai，企业内网常拦截。设 HTTPS_PROXY 后 /clear 重试。
Q：CLAUDE.md 写了但模型好像没遵守？
A：检查文件确实在项目根目录、文件名大小写完全正确（CLAUDE.md，全大写）。/memory 可以看到当前生效的所有层级记忆。
Q：原生安装器还需要 Node.js 吗？ A：安装和运行 Claude Code 本身不需要。但如果你让它写的是 Node 程序（如本教程的 todo.js），那么运行那个程序时仍需本机有 Node.js——这是"运行你的代码"的需求，不是"运行 Claude Code"的需求。
claude --version → 登录 → /init → 生成并运行 todo.js 的完整链路，并能口头复述 CLAUDE.md 的作用。本文由「51学通信」原创整理，站长爱卫生（微信：gprshome201101）持续输出通信与 AI 工程实战内容。Claude Code 的命令与行为以官方最新文档为准，安装器命令在不同版本间可能微调，动手前建议先
claude --help核对一次。[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。