安装 Claude Code

在 macOS、Windows、Linux 上安装 Claude Code 并验证，随后再接入 StoryClaw。

Claude Code 提供原生安装器，自带运行时，不需要先装 Node.js，装好后会自动在后台更新。

系统要求

项目	要求	说明
macOS	13.0 或更高	Apple Silicon 与 Intel 均支持
Windows	10（1809+）/ 11 / Server 2019+	原生运行或 WSL 均可
Linux	Ubuntu 20.04+、Debian 10+、Alpine 3.19+	—
硬件	4 GB 以上内存，x64 或 ARM64 处理器	—
Node.js	建议 22 或更高	只有用 npm 安装时才涉及

macOS

在终端里运行：

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

也可以用 Homebrew：

brew install --cask claude-code

Homebrew 装的版本不会自动更新，需要自己执行 brew upgrade claude-code。

Windows

在 PowerShell 里运行：

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

在 CMD 里则是：

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

也可以用 WinGet（同样不会自动更新，要自己执行 winget upgrade Anthropic.ClaudeCode）：

winget install Anthropic.ClaudeCode

安装不需要管理员权限。建议再装上 Git for Windows——它提供 Git Bash，Claude Code 会用它来执行 Bash 工具；不装的话则改用 PowerShell 执行命令。如果你的项目在 WSL 里，就在 WSL 终端里按下面的 Linux 步骤安装并启动，不要从 PowerShell 启动。

Linux

在终端里运行：

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

Debian、Fedora、RHEL、Alpine 也可以用官方签名的 apt / dnf / apk 仓库安装，命令见 Claude Code 官方安装文档。这类安装同样不会自动更新，跟随系统的升级流程走。

用 npm 安装

如果你已经有稳定的 Node.js 环境，或者原生安装器在你机器上受阻，npm 是官方仍然支持的备选路径：

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

npm 包从 v2.1.198 起把 Node.js 22 声明为所需版本，低于这个版本安装时会打印 EBADENGINE 警告，但通常仍能装完，碰到问题就升级 Node.js。装进来的是同一个原生二进制，运行时并不用到 Node.js。不要用 sudo npm install -g，容易搞出权限和安全问题。升级用 npm install -g @anthropic-ai/claude-code@latest，别用 npm update -g——后者受初装时的 semver 范围限制，不一定升到最新版。

验证安装

在终端里运行：

claude --version

打印出版本号即表示安装成功。如果提示 command not found，先开一个新终端——安装脚本会更新 PATH，而已经打开的会话仍用着旧值。

装好后 Claude Code 仍然连的是 Anthropic，继续看配置 Claude Code 把它切到 StoryClaw。

编辑器插件

Claude Code 也能在编辑器里运行，与命令行共用同一份配置，接好 StoryClaw 后插件侧无需再配。

VS Code / Cursor——安装 Claude Code 插件，或在扩展面板（Cmd+Shift+X / Ctrl+Shift+X）搜索 "Claude Code"。插件会给编辑器加上内联 diff、@ 提及文件、改动计划审查等能力。
JetBrains IDE——从 JetBrains Marketplace 安装 Claude Code 插件，装完重启 IDE。支持 IntelliJ IDEA、PyCharm、WebStorm 等。

常见问题排查

现象	解决办法
刚装完就提示 `claude: command not found`	先开一个新终端。仍然不行就手动把安装目录加进 `PATH`：macOS / Linux 执行 `echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc`；Windows 把 `%USERPROFILE%\.local\bin` 加进用户变量 `Path` 后重开终端。
装完但找不到文件	先确认二进制存在：macOS / Linux 用 `ls ~/.local/bin/claude`，Windows 用 `Test-Path "$env:USERPROFILE\.local\bin\claude.exe"`。存在就说明只是 `PATH` 没配好。
CMD 里报 `'irm' 不是内部或外部命令`	你在 CMD 里，用上面的 CMD 命令；反过来报 `The token '&&' is not a valid statement separator` 则说明你在 PowerShell 里。
`npm install -g` 报 `EACCES` 或其他权限错误	不要用 `sudo`。修正 npm 的全局安装路径，或改用 nvm 管理 Node.js。
下载失败或卡住	网络问题。走代理的话先设置 `export https_proxy=http://127.0.0.1:7890`（Windows 用 `$env:https_proxy="http://127.0.0.1:7890"`），再重新执行安装命令。
Windows SmartScreen 拦截安装	点「更多信息」→「仍要运行」。

On this page