システム要件を確認する

  • オペレーティングシステム: macOS 10.15+、Ubuntu 20.04+/Debian 10+、またはWSL経由のWindows
  • ハードウェア: 最低4GB RAM
  • ソフトウェア:
    • Node.js 18+
    • git 2.23+(オプション)
    • PRワークフロー用のGitHubまたはGitLab CLI(オプション)
  • ネットワーク: 認証とAI処理にインターネット接続が必要
  • 地域: サポート対象国でのみ利用可能

WSLインストールのトラブルシューティング

現在、Claude CodeはWindowsで直接実行されず、代わりにWSLが必要です。WSLで問題が発生した場合:

  1. OS/プラットフォーム検出の問題: インストール中にエラーが発生した場合、WSLがWindows npmを使用している可能性があります。以下を試してください:

    • インストール前にnpm config set os linuxを実行
    • npm install -g @anthropic-ai/claude-code --force --no-os-checkでインストール(sudoは使用しないでください)
  2. Nodeが見つからないエラー: claudeを実行時にexec: node: not foundが表示される場合、WSL環境がWindowsのNode.jsインストールを使用している可能性があります。which npmwhich nodeで確認でき、これらは/mnt/c/ではなく/usr/で始まるLinuxパスを指している必要があります。これを修正するには、Linuxディストリビューションのパッケージマネージャーまたはnvm経由でNodeをインストールしてみてください。

インストールと認証

1

Claude Codeをインストール

Install NodeJS 18+, then run:

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

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

プロジェクトに移動

bash cd your-project-directory

3

Claude Codeを開始

bash claude
4

認証を完了

Claude Codeは複数の認証オプションを提供します:1. Anthropic Console: デフォルトオプション。Anthropic Console経由で接続し、OAuthプロセスを完了します。console.anthropic.comでアクティブな請求が必要です。2. Claude App(ProまたはMaxプラン): Claude Code とWebインターフェースの両方を含む統合サブスクリプションのために、ClaudeのProまたはMaxプランに登録します。同じ価格でより多くの価値を得ながら、アカウントを一箇所で管理できます。Claude.aiアカウントでログインします。起動時に、サブスクリプションタイプに一致するオプションを選択します。3. エンタープライズプラットフォーム: 既存のクラウドインフラストラクチャを使用したエンタープライズデプロイメント用に、Amazon BedrockまたはGoogle Vertex AIを使用するようにClaude Codeを設定します。

プロジェクトを初期化する

初回ユーザーには以下をお勧めします:

1

Claude Codeを開始

bash claude
2

簡単なコマンドを実行

bash summarize this project
3

CLAUDE.mdプロジェクトガイドを生成

bash /init
4

生成されたCLAUDE.mdファイルをコミット

生成されたCLAUDE.mdファイルをリポジトリにコミットするようClaudeに依頼します。