Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

macOS で Claude Code が終了時にハングする問題を修正しました。

原文（英語） ​

Fixed Claude Code hanging on exit on macOS

概要 ​

macOS 環境で Claude Code を終了しようとした際に、プロセスが応答しなくなる（ハングする）問題が修正されました。この問題により、ユーザーは強制終了（Ctrl+C や kill コマンド）を使わなければならない状況が発生していましたが、本修正によって正常に終了できるようになりました。

基本的な使い方 ​

修正後は Claude Code を通常の方法で終了できます。追加の操作は不要です。

bash
# 通常の終了方法が正常に動作するようになった
$ claude
# ... 作業後 ...
# /exit コマンドで終了
> /exit

# または Ctrl+D で終了
# ハングせずに即座にシェルに戻る

実践例 ​

ユースケース: 長時間の作業セッション後の終了 ​

修正前は特に長時間の作業セッション後や、複数のツール呼び出しを行った後に終了時のハングが発生しやすい傾向がありました。

bash
# 長いセッション後でも正常に終了できる
$ claude --print "大規模なコードレビューをお願いします"
# ... 長い処理後 ...
# 正常終了（ハングなし）

# セッション終了スクリプトも問題なく動作
$ claude -p "タスク完了" && echo "終了しました"
終了しました

ユースケース: スクリプト内での Claude Code 使用 ​

スクリプト内で Claude Code を使用する場合も、終了時のハングがなくなったことで安定して動作します。

bash
#!/bin/bash
claude --print "コードをレビューして" < code.txt
echo "レビュー完了"  # このメッセージが確実に表示されるようになった

注意点 ​

  • この問題は macOS 固有の問題でした（Linux/Windows では発生しなかった）
  • 修正前は Ctrl+C を押してもハングが解消しない場合があり、別のターミナルウィンドウから kill コマンドで強制終了する必要がありました
  • v2.1.83 以降では、このような強制終了が不要になります

関連情報 ​