Claude Code 是一个跑在终端里的 AI 编程助手，不是图形界面软件。 安装之前需要备好命令行环境和 Node.js，登录有订阅账号和 API Key 两条路，两套计费体系完全独立。下面从零开始逐步讲清。
安装 Claude Code 之前需要什么？
三样东西缺一不可：
- 终端：macOS 自带 Terminal，Windows 用 PowerShell 或 WSL 都行。如果你从来没打开过终端，先搜一下自己系统怎么打开——Claude Code 的所有操作都在这里完成。
- Node.js 和 npm：Claude Code 通过 npm 安装。打开终端输入
node -v，能看到版本号说明已装好；没反应就去 nodejs.org 下载 LTS 版本，装完重启终端。 - 能访问 claude.ai 的网络：安装过程需要从 npm 拉包，登录时要跳转到 claude.ai 做认证。中国大陆、香港、澳门不在 Anthropic 官方支持的地区名单内，网络准备需要自行解决。
关于地区限制和付款门槛的完整说明：Claude 国内怎么用？注册与付款全流程。
安装命令怎么执行？
环境就绪后，终端里一条命令：
npm install -g @anthropic-ai/claude-code-g 表示全局安装，装完之后在任意目录都能直接运行 claude 命令。装完输入 claude，出现欢迎界面就算成功。如果你用的是公司电脑或受管理的设备，全局安装可能受限，问一下你的 IT 管理员。
具体命令以 Anthropic 官方文档（code.claude.com/docs）为准，版本迭代可能有细节变化。
订阅登录和 API Key 登录有什么区别？
Claude Code 有两条登录路径，计费互不相关，不能拿一边的余量抵另一边。
订阅账号登录（新手推荐）
首次运行 claude 会自动打开浏览器，跳转到 claude.ai 完成 OAuth 认证。用你的 Pro 或 Max 订阅账号登录即可。这种方式下，Claude Code 与 claude.ai 网页端、桌面端、移动端共用同一个用量池——白天 Claude Code 用了很多额度，晚上回网页端聊天可能就所剩不多了。
API Key 登录
通过 Anthropic Console 生成 API Key，设置环境变量 ANTHROPIC_API_KEY 后启动。费用按 token 从 Console 余额扣减，和订阅额度没有关系。适合需要精确控制成本或跑长任务的场景。
注意一点：如果你的终端里同时设了 ANTHROPIC_API_KEY 环境变量，Claude Code 会优先用 API Key 而跳过订阅认证。想切回订阅登录，先执行 unset ANTHROPIC_API_KEY 清除这个变量再重新启动。
Claude Code 只有付费订阅才能用。截至 2026 年 9 月，Free 档不含 Claude Code，Pro $20/月是起步门槛。三档订阅的用量和价格差异：Claude Pro 和 Max 区别详解。
常见安装失败怎么排查？
| 症状 | 常见原因 | 解决办法 |
|---|---|---|
npm: command not found | Node.js 没装或 PATH 没配好 | 重新安装 Node.js LTS，装完重启终端 |
| 安装卡住或超时 | 网络连不上 npm 仓库 | 检查网络环境，或给 npm 配镜像源 |
| 权限报错（EACCES） | 全局安装缺权限 | macOS/Linux 前面加 sudo，或改 npm 全局目录到用户路径下 |
claude 命令没反应 | npm 全局 bin 目录不在 PATH 里 | 执行 npm bin -g 查路径，手动加到 PATH |
| 登录跳转后回不到终端 | 浏览器拦截了回调 | 换默认浏览器重试，或用 claude setup-token 手动生成长期 token |
大部分安装问题出在网络和权限上。卡住了在命令后面加 --verbose 看详细日志，定位问题会快很多。
登录后怎么确认一切正常？
进入 claude 交互界面后，先给它一个简单指令试试——比如让它看看当前目录有哪些文件，确认它能正常读取和响应。如果它能列出文件并回答你的问题，说明安装、网络、登录三关都已经通过了。不用急着丢大项目过去，先拿一个无关紧要的小任务跑一遍完整流程。
如果你主要需求不是编程而是日常 AI 对话，而且 Claude 的付款门槛暂时搞不定，国内能直接开通的 ChatGPT Plus 也是成熟选择：ChatGPT Plus 国内充值教程。
下一步可以看新手第一课，十分钟跑通一个小任务：Claude Code 第一个任务怎么跑。
套餐、价格、模型以 Anthropic 官网当时显示为准，本文核对日期 2026-09-17。