灵集 AI · Claude CLI 安装教程返回帮助中心

Claude Code CLI 安装与登录

选择适合系统的安装方式，完成版本检查、环境诊断和登录，最后在项目中做一次只读验证。

原生安装无需先装 Node.js；仅选择 npm 安装时才需要 Node.js 和 npm。下面的安装方式选择一种即可，避免重复安装造成版本或 PATH 混乱。

适用范围：本页介绍 CLI 安装和 Claude 官方账号登录。灵集 AI 的 API 密钥与官方账号登录是不同的接入方式；第三方接口配置不在本页范围内。

在自己信任的终端执行命令，不要将账号密码、API Key、Token 或 .env 内容粘贴到脚本、截图和公开聊天中。

1. Windows 安装

PowerShell 原生安装

打开 PowerShell，运行官方安装脚本：

irm https://claude.ai/install.ps1 | iex

可选：WinGet 安装

已使用 Windows 软件包管理器的用户，也可以选择：

winget install Anthropic.ClaudeCode

安装后关闭并重新打开终端，再进行版本检查。PowerShell、CMD、Git Bash 和 WSL 是不同环境；请在实际要使用的环境中验证。

如果公司电脑限制脚本执行，请联系管理员确认策略，不要自行绕过限制。

2. macOS、Linux、WSL 安装

在 macOS / Linux 终端，或已经进入的 WSL 终端中运行：

curl -fsSL https://claude.ai/install.sh | bash

WSL 与 Windows 的安装环境不同。准备在 WSL 使用时，应在 WSL 内安装和验证；Windows 中能运行不代表 WSL 中也已安装。

3. npm 兼容安装

npm 全局安装作为兼容方式保留。原教程优先推荐原生安装、Homebrew 或 WinGet；仅当团队环境仍统一使用 npm 时，选择本方式。

先安装 Node.js 当前 LTS 版本，重新打开终端并检查：

node -v
npm -v

能输出版本号后，再安装 Claude Code：

npm install -g @anthropic-ai/claude-code
不要使用 sudo npm install -g 处理权限报错。应检查 npm 全局目录权限；混用原生与 npm 安装时，先用 claude doctor 确认实际使用的安装，再按官方迁移指引处理旧版本。

4. 验证安装

claude --version
claude doctor
  • claude --version 输出版本号：说明命令可用。
  • claude doctor 没有阻塞项：说明基础环境检查通过。
  • 找不到 claude：先重新打开终端，再检查 PATH 和安装环境。
  • doctor 报网络、权限或 shell 问题：先处理阻塞项，再继续登录和配置。

需要协助判断验证结果时

可将下面的提示词与已隐藏敏感信息的输出，交给可用的 AI 助手：

这是 Claude Code 安装验证结果，请帮我判断是否可以继续。

claude --version：
【粘贴版本输出】

claude doctor：
【粘贴已隐藏敏感信息的诊断结果】

请判断是否有阻塞问题、最可能的原因、下一步最小修复动作，以及是否可以进入登录和模型配置。不要让我粘贴 API Key、Token 或账号密码。

5. 启动与登录

在准备使用的项目目录中打开终端，运行：

claude

按终端和浏览器提示完成官方账号登录。账号需要具备 Claude Code 使用权限；免费 Claude.ai 账号通常不包含该权限，请以账号实际可用权益为准。

登录失败时先检查

  1. 浏览器是否正常打开，登录后终端是否收到回调。
  2. 账号是否具备 Claude Code 权限。
  3. 网络是否能访问 Claude 服务。
  4. claude doctor 是否仍有阻塞项。

先解决登录问题，再进入模型配置和正式任务，避免同时更改多个配置而难以定位原因。

Claude Code 登录没有完成，请帮我排查。

现象：
【浏览器是否打开、终端是否回调、已隐藏敏感信息的报错文字】

请判断更像浏览器回调、账号权限、网络还是终端环境问题。说明应该先重新登录、重新打开终端，还是检查 doctor，并告诉我哪些信息不能粘贴。不要修改项目文件。

6. 首次启动：只读检查

进入对话后，先发送以下提示词，确认当前目录与环境正常：

请只读检查当前 Claude Code 环境。

要求：
1. 不要修改文件，不要读取 .env 或其他密钥文件。
2. 告诉我当前是否能正常响应。
3. 告诉我当前工作目录是什么，是否能只读查看该目录。
4. 如果发现权限、网络、账号或 shell 问题，请先说明，不要继续任务。
5. 判断下一步是否可以配置模型，还是应先修复环境。

确认可以正常对话和只读查看目录后，再开始明确的小任务。首次启动不宜直接修改公司项目、读取敏感配置、同时接入多个模型，或执行“优化整个项目”这类范围不清的要求。

常见问题与排障顺序

Windows 常见现象

现象优先检查
PowerShell 能用，CMD 不能用重新打开终端，检查 PATH 刷新及终端环境差异。
Windows 能用，WSL 不能用确认 WSL 内是否单独安装。
安装后找不到命令先重开终端，再确认安装是否完成、命令是否加入 PATH。
doctor 报 shell 问题检查当前 shell 配置与权限限制。
公司电脑无法执行脚本请管理员确认安全策略与权限。

按阶段排查

  1. 安装命令：是否执行成功，有无报错。
  2. 命令可用：claude --version 能否返回版本。
  3. 环境健康：claude doctor 是否有阻塞项。
  4. 登录状态：浏览器登录和终端回调是否完成。
  5. 项目只读：能否正常对话并只读查看当前目录。

前一阶段未通过时，先处理该阶段的问题。

Claude Code 安装失败了，请帮我按阶段排查。

现象和报错：
【粘贴已隐藏敏感信息的输出】

依次判断：安装命令是否成功、claude 是否进入 PATH、版本检查是否可用、doctor 是否有阻塞项、登录是否完成。给出下一步最小修复动作，不要让我重复试错，不要让我粘贴任何密钥。

验收清单

  • claude --version 能输出版本。
  • claude doctor 没有阻塞性错误。
  • 启动 claude 后能正常进入对话。
  • 能完成一次只读环境检查。

安装或使用遇到问题，可返回 帮助中心售后服务 获取支持。提问时请隐藏账号凭证。