Claude Code使用教程：Windows/macOS一文装好并上手

这篇Claude使用教程专讲Claude Code：从安装、验证到绑定API Key，再到常见报错排查。按步骤走，10分钟内就能在终端里把Claude Code跑起来，用它做代码生成、改错和简单的开发协作。

一、安装前准备：Node.js版本别踩坑

Claude Code依赖Node.js环境，建议先安装Node.js 18及以上版本，再开启新的终端窗口。Windows用户用安装包一路下一步即可，macOS可用官方安装包或包管理器安装。装完后在终端输入node -v确认版本号正常。

二、安装Claude Code：npm全局安装与国内镜像

在终端执行全局安装命令：npm install -g @anthropic-ai/claude-code，这就是最常用的Claude Code安装方式。若你所在网络访问npm官方源较慢，可改用镜像源：npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com。安装完成后重新打开终端，输入claude --version验证Claude Code是否可用。

三、首次运行与绑定API Key：让Claude Code真正可用

Claude Code需要Anthropic的API Key授权，首次运行claude时通常会引导你配置Key。更稳妥的方式是先在系统里设置环境变量ANTHROPIC_API_KEY，再启动Claude Code，避免每次重复输入。完成后在项目目录进入终端，用自然语言描述任务即可，例如让Claude Code分析报错、生成修复补丁并提示你如何验证。

四、Claude Code常见问题：卡住、报错与中断怎么处理

如果Claude Code出现请求失败或频繁中断，优先检查网络稳定性与是否触发了服务端限流；换更稳定的网络环境通常能明显改善。遇到安装报错，多数与Node.js版本过低或全局权限有关，升级Node.js并用管理员/sudo权限重装往往能解决。若claude --version无输出，建议确认全局npm路径已加入PATH，并在新终端里再次运行Claude Code。