安装 Claude Code

Claude Code 是一个由 AI 驱动的编码助手，可以理解项目代码、跨多个文件修改内容并调用开发工具。你可以在终端中使用它，也可以配合 IDE 和桌面应用完成开发任务。

本页覆盖原生安装、Homebrew、WinGet 和 npm。安装完成后，再使用 LAYSO AI API Key 完成模型供应商配置。

前置要求

• 一个有效的 LAYSO AI API Key，无需额外购买 Claude 订阅。
• macOS 13+、Ubuntu 20.04+/Debian 10+、Windows 10 1809+，或相应的 WSL 环境。
• Windows 用户需要安装 Git for Windows。
• 使用 npm 方式时需要 Node.js 18 或更高版本。

终端 CLI

原生安装（推荐）

原生安装不依赖 Node.js，并会自动在后台检查更新。

macOS / Linux / WSL：

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

Windows PowerShell：

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

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

PowerShell 与 CMD 命令不同

如果看到 The token '&&' is not a valid statement separator，说明当前使用的是 PowerShell，请改用上面的 PowerShell 命令。

Homebrew

适用于 macOS：

brew install --cask claude-code

Homebrew 安装默认不会自动更新，请定期运行：

brew upgrade claude-code

WinGet

适用于 Windows：

winget install Anthropic.ClaudeCode

WinGet 安装默认不会自动更新：

winget upgrade Anthropic.ClaudeCode

npm

npm 方式需要 Node.js 18+：

npm install -g @anthropic-ai/claude-code

不要使用 sudo npm install -g，否则可能产生权限和安全问题。

选择发布版本

原生安装器支持 latest、stable 或指定版本号。默认使用 latest。

稳定版本

macOS / Linux / WSL：

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

Windows PowerShell：

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd

指定版本

把 <VERSION> 替换为需要安装的版本号：

curl -fsSL https://claude.ai/install.sh | bash -s <VERSION>

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) <VERSION>

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd <VERSION> && del install.cmd

验证安装

关闭并重新打开终端，然后运行：

claude --version
claude doctor

正常输出版本号即表示安装成功。

首次启动

进入项目目录并启动 Claude Code：

cd /path/to/your-project
claude

首次运行时仔细检查工作目录和权限提示。不要在不信任的目录中允许自动执行命令。

更新与卸载

更新

安装方式	更新命令
原生安装	自动后台更新，也可运行 claude update
Homebrew	brew upgrade claude-code
WinGet	winget upgrade Anthropic.ClaudeCode
npm	npm install -g @anthropic-ai/claude-code@latest

卸载包管理器版本

brew uninstall --cask claude-code
npm uninstall -g @anthropic-ai/claude-code

Windows：

winget uninstall Anthropic.ClaudeCode

常见安装问题

命令不存在

重新打开终端。如果仍然找不到命令，检查 ~/.local/bin 或 npm 全局可执行目录是否已经加入 PATH。

npm 没有安装正确的二进制文件

确认 npm 允许安装可选依赖，并检查平台与 CPU 架构是否受支持：

npm list -g --depth=0

Windows 启动失败

确认已经安装 Git for Windows，并在新的 PowerShell 或 CMD 窗口中重试。WSL 用户应在 WSL 内运行 Linux 安装命令。

下一步

安装完成后继续阅读 Claude Code 配置模型供应商，使用根地址 https://api.layso.ai 接入 LAYSO AI。