ステップ1:実際のエラーを取得する
claude --version # is the CLI there at all?
claude # start it directly: the real error prints here
claude doctor # install health check
ターミナルでは動作し、拡張機能やアプリだけが失敗する場合、問題はClaude Code自体ではなく、ラッパーの起動元の環境(PATH、Nodeのバージョン、プロキシ変数)にあります。ターミナルでも失敗する場合は、そこで表示されるメッセージを検索してください。
既知の原因(イシュートラッカーより)
- VS Codeでバックグラウンドセッションを再開する。 次のコマンドで開始したセッションを開くと:
claude --bgまさにこのエラーが発生します。macOS、Windows、Linuxで報告されています(#77162)。先にバックグラウンドエージェントを停止するか、新しいセッションを開いてください。 - Windows:クラッシュ後に残る孤立したプロセス。 古いプロセスがロックを保持しているため、アプリを再起動できません(#42776, #53247)。タスクマネージャーで残っている
claudeプロセスを終了してください。その報告で確実な対処方法とされているのは、Windowsの完全な再起動です。 - Apple Silicon上のデスクトップアプリ で、CLIは動作するのにセッション開始のたびに失敗する場合(#59866、既知の問題の重複報告)、アプリを更新してください。それまではターミナルでCLIを使用してください。
- 18未満のNode.js、または壊れたPATH がnpmによるインストール後に存在すると、ラッパーはCLIを起動できません。
node -v。ネイティブインストーラーに切り替えて、Nodeへの依存をなくしてください。 - 無効な`~/.claude/settings.json`。 フックや権限のブロックに余分なカンマがあると、CLIは即座に終了します。JSONを検証してください。
- Windowsのシェルの不一致 — 特定のモデルで、Git Bashから実行したPowerShellツールが失敗する場合(#87980)、別のシェルを試してください。
上記のいずれにも当てはまらない場合
- すべてを更新する:
claude updateを実行し、VS Code拡張機能またはデスクトップアプリも更新してください。 - ネイティブインストーラーで再インストールしてください(
curl -fsSL https://claude.ai/install.sh | bash、または次のガイドに記載されているPowerShell / CMDのワンライナー: インストールガイド). - VS Codeをターミナルから起動し、正常に動作するCLIと同じ環境を継承させてください。
- 次のコマンドの出力を添えて、新しいイシューを登録してください:
claude doctor— トラッカーではクラッシュ報告が迅速にトリアージされます。
関連情報
Claude Codeは起動するものの、その後APIエラーで失敗する場合は、別の問題です。参照: APIエラー500, 過負荷 / 529, APIエラー400 または OAuthエラー。拡張機能については、次を参照してください: VS CodeでのClaude Code.
この問題への対処に疲れましたか?
代わりにAI Prime Techのゲートウェイ経由でClaude Codeを実行してください。ゲートウェイ独自のアップストリームアカウントで同じClaudeモデルを利用でき、環境変数を2つ変更するだけで切り替えられます。新規アカウントには $5分の無料APIクレジット を、コード FIXIT が付与されます。カードは不要です。
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyよくある質問
「Claude Codeプロセスがコード1で終了しました」は何を意味しますか?
VS Code拡張機能またはデスクトップアプリがClaude Code CLIを起動し、CLIがエラーで終了したことを意味します。ターミナルでclaudeを実行して、実際のエラーメッセージを確認してください。
WindowsでClaude Codeがコード1で終了する問題を解消するにはどうすればよいですか?
残っているclaudeプロセスを終了し(アプリが再起動しない場合はWindowsを再起動)、node -vとPATHを確認し、~/.claude/settings.jsonを検証してください。必要に応じて、ネイティブインストーラーで再インストールしてください。
Claude Codeがターミナルでは動作するのに、VS Codeでは動作しないのはなぜですか?
VS Codeが異なる環境(PATH、Node、プロキシ変数)で起動されたためです。claudeが動作するターミナルからVS Codeを起動するか、シェルのプロファイルで変数を修正してください。
ゲートウェイでClaude Codeを実行
同じモデルを環境変数の設定だけで利用できます。額面の7.69231倍のクレジット、または定額無制限プランを選べます。 新規アカウント:コードFIXITで$5分の無料APIクレジット。
APIキーを取得 無制限プランを見るAI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。