Claude Code 基于 Node.js 运行。本机需要 Node.js 18.0 或更高版本（推荐 22 LTS）。
有四种安装方式，任选其一。推荐方法 1。
%USERPROFILE%\.local\bin\claude.exe'claude' 不是内部或外部命令，把 %USERPROFILE%\.local\bin 加到系统环境变量 PATH 中。sudo npm install -g，会导致权限问题。安装完成后，把 ~/.npm-global/bin 加入 PATH。
在 VS Code 中按 Ctrl+Shift+X，搜索 "Claude Code"，点击安装。或在终端执行：
Claude Code 需要 Anthropic API 密钥或 OAuth 登录才能使用。
Claude Code 默认连接的是 Anthropic 的美国服务器，在中国大陆网络环境下通常无法直连。需要以下任一方式解决：
市面上有多家国内厂商提供 Anthropic API 代理中转，例如 OpenRouter、API2D、OhMyGPT 等。它们的用法类似——注册后获得一个「中转地址 + API Key」，然后设置环境变量：
常见中转服务商对比（仅供参考，自行评估）：
| 服务商 | 特点 | 价格参考 |
|---|---|---|
| OpenRouter | 海外服务，需代理访问 | 按量计费 |
| API2D | 国内服务商，无需代理 | ≈官方价 × 1.2-1.5 |
| OhMyGPT | 国内服务商，支持多种模型 | 按量或包月 |
如果你不需要 Claude 的原生能力，可以使用 DeepSeek、通义千问等国产大模型。部分工具（如 claude-code-router）可一键切换为国产模型后端：
| 错误信息 | 原因 | 解决方法 |
|---|---|---|
claude: command not found |
PATH 环境变量未包含安装路径 | export PATH="$HOME/.local/bin:$PATH"（Linux/macOS）或把 %USERPROFILE%\.local\bin 加入 Windows 系统 PATH |
npm ERR! code EACCESpermission denied |
用了 sudo npm install -g 或全局目录无写入权限 |
参考 步骤 2 配置 ~/.npm-global，不要用 sudo |
curl: (56) 写入失败TLS 连接错误 |
网络不通或被防火墙阻止 | 检查网络连接，尝试挂代理 Windows: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 |
bash: syntax error near unexpected token '<' |
安装脚本返回了 HTML（地区限制） | 使用 npm 安装方式，或通过中转服务使用 |
Error: 401 Unauthorized |
API Key 无效或未配置 | 检查 ANTHROPIC_API_KEY 环境变量是否设置正确运行 claude /login 重新认证 |
SELF_SIGNED_CERT_IN_CHAIN |
企业网络有 TLS 代理拦截 | npm config set strict-ssl false（仅开发环境）或配置 NODE_EXTRA_CA_CERTS |
| 安装后提示 Node.js 版本过低 | Node.js < 18.0 | 升级到 Node.js 22 LTS：nvm install 22 && nvm use 22 |
Windows 上 'irm' is not recognized |
在 CMD 而非 PowerShell 中运行了 PowerShell 命令 | 打开 PowerShell（开始菜单搜索 "PowerShell"），或使用 CMD 安装命令 |
ENOMEM 内存不足 |
系统内存 < 4GB | 关闭其他程序释放内存，或升级硬件 |
| Linux 安装过程中进程被 Killed | 内存不足（常见于 1-2G VPS） | 添加 swap：sudo fallocate -l 2G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile |
claude doctor 可获得完整的运行环境诊断报告。