Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

親プロセスから古いWebSocket/OAuthファイルディスクリプタ環境変数を継承した場合に発生するCLIのクラッシュ（メモリ不足）を修正しました。

原文（英語） ​

Fixed a crash (out-of-memory) when the CLI inherits a stale websocket/OAuth file-descriptor environment variable from a parent process

概要 ​

特定の環境でClaude Code CLIが起動直後にメモリ不足（OOM）でクラッシュする問題が修正されました。原因は、親プロセス（シェル・IDE・CI環境など）から引き継いだ古いWebSocketまたはOAuthのファイルディスクリプタ環境変数でした。この修正により、スタートアップ時の安定性が向上します。

基本的な使い方 ​

この修正はバックグラウンドで自動的に適用されます。ユーザー側での操作は不要です。

バージョン 2.1.178 以降では、古い環境変数を検出して安全に無視するようになりました。

実践例 ​

影響を受けていたシナリオ ​

IDEから起動した場合:

bash
# VS Code や JetBrains IDE のターミナルから起動
# 親プロセスがWebSocketのFDを持っている場合にクラッシュ
claude
# → OOMクラッシュ（修正済み）

CI/CDパイプラインでの使用:

yaml
# GitHub Actions 等でのジョブ定義
- name: Run Claude Code
  run: claude --auto --print "コードをレビューしてください"
  # → 前のステップの環境変数が残っている場合にクラッシュ（修正済み）

Claude Codeを複数インスタンス起動した場合:

bash
# 既存のclaude セッションから新しいclaudeを起動
claude -p "subcommand" | claude --auto
# → FDの継承によるクラッシュ（修正済み）

アップデート前の回避策（現在は不要） ​

以前この問題を回避するために実施していた対策:

bash
# 環境変数をリセットしてから起動
env -i HOME=$HOME PATH=$PATH claude

# または問題の環境変数を明示的にアンセット
unset CLAUDE_WEBSOCKET_FD
unset CLAUDE_OAUTH_FD
claude

バージョン 2.1.178 以降ではこれらの回避策は不要です。

注意点 ​

  • この修正はClaude Code CLI に影響します（Web UI・IDE拡張には関係しません）
  • OOMクラッシュが発生していた場合は claude --version でバージョンを確認し、2.1.178 以降に更新してください
  • 更新方法: npm install -g @anthropic-ai/claude-code
  • CI/CD環境でのクラッシュが解消されるため、自動化ワークフローの信頼性が向上します

関連情報 ​