夜雨聆风怎么安装 Claude Code？ 怎么登录并真正跑起来？
覆盖 Windows、macOS、Linux 全平台，照着操作，10 分钟基本都能跑通。
一、先装一个依赖：Node.js
Claude Code 本质上是一个 Node.js CLI 工具，所以需要先安装 Node.js 环境。
去 Node.js 官网下载 LTS（长期支持版），建议版本：
Node.js ≥ 18 推荐 Node.js 20 LTS
安装完成后，在终端验证：
node -v
npm -v
能看到版本号，说明环境正常。
如果 npm 下载比较慢，可以临时切换国内镜像：
npm config set registry https://registry.npmmirror.com
安装完成后建议切回官方源：
npm config set registry https://registry.npmjs.org
注意：切镜像只是加速项，不是必选项，先跑通再优化。
二、4 种安装方式，选一个即可
根据自己的系统和习惯选择一种安装方式：
npm install -g @anthropic-ai/claude-code | |
curl -fsSL https://claude.ai/install.sh \| bash | |
irm https://claude.ai/install.ps1 \| iex | |
winget install Anthropic.ClaudeCode |
推荐方案：
大部分用户直接使用：
npm install -g @anthropic-ai/claude-code
兼容性最好，也最容易排查问题。
安装完成后验证：
claude --version
看到版本号，就说明安装成功。
三、3 种登录方式，选一个即可
第一次运行：
claude
Claude Code 会要求登录。
方式 A：OAuth 浏览器授权（推荐新手）
执行 claude 后，会自动打开浏览器并跳转到 Anthropic 控制台完成授权。
适合：
个人开发者 官方订阅用户 第一次体验 Claude Code
优点是零配置、最省事。
注意：国内可能无法访问官方页面，也存在封号问题。
方式 B：直接配置 ~/.claude.json
如果无法使用 OAuth，或者需要使用 API Key、中转服务、CI/CD 环境，可以直接修改配置文件。
先运行一次：
claude
生成配置文件后，编辑：
{
"hasCompletedOnboarding": true,
"primaryApiKey": "sk-ant-你的Key"
}
保存后重新打开终端，再次执行 claude 即可。
如果接入 DeepSeek 或其他兼容服务，可以配置：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
"ANTHROPIC_MODEL": "deepseek-chat"
}
}
两个容易踩坑的地方：
地址必须带 /anthropic后缀；使用的是 ANTHROPIC_AUTH_TOKEN，不是API_KEY。
方式 C：图形化切换工具 cc-switch
如果经常需要切换官方账号、DeepSeek、中转服务或者多个 API Key，可以使用 cc-switch。
它支持：
50+ Provider 预设 一键切换账号 MCP 管理 配置备份 本地代理和故障转移
比较适合重度用户和团队协作场景。
四、最容易卡住的 3 个问题
1. 安装成功但找不到 claude
通常是环境变量没有刷新。
解决办法：
关闭并重新打开终端； 检查 PATH 配置； 执行：
npm prefix -g
确认全局安装目录是否已加入环境变量。
2. 登录后提示 401 Unauthorized
一般只有三种原因：
API Key 填错； 账号余额不足； 区域限制导致请求失败。
建议先重新复制 Key，再排查网络和账户状态。
3. 修改配置后仍然跳登录页
大概率是配置文件有问题。
重点检查：
{
"hasCompletedOnboarding": true
}
是否存在，以及 JSON 是否有语法错误。
最稳的方法：
python -m json.tool < ~/.claude.json
能正常输出，就说明格式没有问题。
五、装好之后第一件事：执行 /init
不要急着直接提问。
先进入项目目录：
cd 你的项目
claude
然后执行：
/init
Claude Code 会自动扫描项目结构、分析技术栈，并生成一份 CLAUDE.md 草稿。
这个动作相当于给 AI 做一次项目入职培训，让它理解你的代码规范、目录结构和开发约定。
以后无论是写代码、重构、修 Bug，还是生成测试，Claude Code 的表现都会明显提升。
推荐路线：
Node.js → 安装 Claude Code → 登录 → 进入项目目录 → /init
先保证跑起来，再考虑切源、多模型和高级玩法。
