安裝 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。
下載失敗或卡住	網路問題。走 Proxy 的話先設定 `export https_proxy=http://127.0.0.1:7890`（Windows 用 `$env:https_proxy="http://127.0.0.1:7890"`），再重新執行安裝命令。
Windows SmartScreen 攔截安裝	點「更多資訊」→「仍要執行」。

On this page