​
システム要件

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

​
インストールと認証

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

プロジェクトに移動

cd your-project-directory
3

Claude Codeを開始

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を開始

claude
2

簡単なコマンドを実行

> summarize this project
3

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

/init
4

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

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

​
トラブルシューティング

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

現在、Claude CodeはWindowsで直接実行されず、代わりにWSLが必要です。

WSLで以下の問題が発生する可能性があります：

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

  • インストール前にnpm config set os linuxを実行
  • npm install -g @anthropic-ai/claude-code --force --no-os-checkでインストール（sudoは使用しないでください）

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

​
ターミナルセットアップの最適化

Claude Codeはターミナルが適切に設定されている時に最適に動作します。体験を最適化するために以下のガイドラインに従ってください。

サポートされているシェル:

  • Bash
  • Zsh
  • Fish

​
テーマと外観

Claudeはターミナルのテーマを制御できません。それはターミナルアプリケーションによって処理されます。オンボーディング中または/configコマンドを使用していつでもClaude Codeのテーマをターミナルに合わせることができます。

​
改行

Claude Codeに改行を入力するためのいくつかのオプションがあります：

  • クイックエスケープ: \を入力してからEnterを押して改行を作成
  • キーボードショートカット: 適切な設定でOption+Enter（Meta+Enter）を押す

ターミナルでOption+Enterを設定するには：

Mac Terminal.appの場合:

  1. 設定 → プロファイル → キーボードを開く
  2. 「OptionをMetaキーとして使用」をチェック

iTerm2とVSCodeターミナルの場合:

  1. 設定 → プロファイル → キーを開く
  2. 一般の下で、左/右Optionキーを「Esc+」に設定

iTerm2とVSCodeユーザーのヒント: Claude Code内で/terminal-setupを実行して、より直感的な代替としてShift+Enterを自動的に設定します。

​
通知設定

適切な通知設定でClaudeがタスクを完了した時を見逃すことはありません：

​
ターミナルベル通知

タスク完了時の音声アラートを有効にする：

claude config set --global preferredNotifChannel terminal_bell

macOSユーザー向け: システム設定 → 通知 → [あなたのターミナルアプリ]で通知許可を有効にすることを忘れないでください。

​
iTerm 2システム通知

タスク完了時のiTerm 2アラートの場合：

  1. iTerm 2環境設定を開く
  2. プロファイル → ターミナルに移動
  3. 「ベルを無音にする」とフィルターアラート → 「エスケープシーケンス生成アラートを送信」を有効にする
  4. 希望する通知遅延を設定

これらの通知はiTerm 2固有であり、デフォルトのmacOSターミナルでは利用できないことに注意してください。

​
大きな入力の処理

広範囲なコードや長い指示を扱う場合：

  • 直接貼り付けを避ける: Claude Codeは非常に長い貼り付けコンテンツで問題が発生する可能性があります
  • ファイルベースのワークフローを使用: コンテンツをファイルに書き込み、Claudeに読み取りを依頼
  • VS Codeの制限に注意: VS Codeターミナルは特に長い貼り付けを切り詰める傾向があります

​
Vimモード

Claude CodeはVimキーバインディングのサブセットをサポートしており、/vimで有効にするか/configで設定できます。

サポートされているサブセットには以下が含まれます：

  • モード切り替え: Esc（NORMALへ）、i/I、a/A、o/O（INSERTへ）
  • ナビゲーション: h/j/k/l、w/e/b、0/$/^、gg/G
  • 編集: x、dw/de/db/dd/D、cw/ce/cb/cc/C、.（繰り返し）