StoryClaw Docs

Claude Code のインストール

macOS、Windows、Linux に Claude Code をインストールして動作を確認し、そのうえで StoryClaw に接続します。

Claude Code はランタイムを同梱したネイティブインストーラーを提供しています。Node.js は不要で、インストール後はバックグラウンドで自動更新されます。

システム要件

項目要件説明
macOS13.0 以降Apple Silicon と Intel の両方に対応
Windows10（1809 以降）/ 11 / Server 2019 以降ネイティブ実行と WSL のどちらでも可
LinuxUbuntu 20.04+、Debian 10+、Alpine 3.19+—
ハードウェアメモリ 4 GB 以上、x64 または ARM64—
Node.js22 以降を推奨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 の導入も推奨します——Claude Code は付属の Git Bash を使って Bash ツールを実行します。導入しない場合は PowerShell でコマンドを実行します。プロジェクトが WSL 内にある場合は、PowerShell からではなく WSL のターミナルで下の Linux の手順に従ってインストールし、起動してください。

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 ではユーザー環境変数 Path に %USERPROFILE%\.local\bin を追加してターミナルを開き直してください。
インストールしたのにファイルが見つからないまずバイナリの有無を確認します。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 にブロックされる「詳細情報」→「実行」をクリックしてください。

API キー

StoryClaw コンソールでキーを作成し、CC Switch に貼り付ければ接続完了です。

Claude Code の設定

Claude Code を StoryClaw の Anthropic Messages エンドポイントに向けます。手動設定でも CC Switch の GUI でも構いません。

On this page

システム要件macOSWindowsLinuxnpm でインストールするインストールを確認するエディター拡張機能トラブルシューティング