Claude Code ガイド

Appearance

原文（日本語訳） ​

npx、bun run などのラッパープロセス経由でClaude Codeを起動している場合に、Ctrl+Zがターミナルをハングする問題を修正しました。

原文（英語） ​

Fixed Ctrl+Z hanging the terminal when Claude Code is launched via a wrapper process (e.g. npx, bun run)

概要 ​

npx claude、bun run claude、その他のラッパープロセス経由でClaude Codeを起動している場合に、Ctrl+Z（プロセスのサスペンド）を押すとターミナルが応答しなくなる（ハング）問題がありました。v2.1.116ではこの問題が修正され、ラッパープロセス経由での起動でも Ctrl+Z が正常にClaude Codeをサスペンドし、シェルに戻れるようになりました。

基本的な使い方 ​

bash
# npx経由でClaude Codeを起動している場合
npx @anthropic-ai/claude-code

# または bun run 経由の場合
bun run claude

# Ctrl+Z を押すと正常にサスペンドされるようになった（ハングしない）
# [1]+  Stopped    npx @anthropic-ai/claude-code
# → fg でClaude Codeに戻れる

実践例 ​

npx経由でのClaude Codeの一時停止と再開 ​

bash
# npx でClaude Codeを起動
npx @anthropic-ai/claude-code

# 作業中に一時的に他のコマンドを実行したい場合
Ctrl+Z
# → [1]+  Stopped    npx @anthropic-ai/claude-code

# シェルで他のコマンドを実行
ls -la
git status

# Claude Code に戻る
fg
# → Claude Code が再開される

package.jsonのスクリプト経由での起動 ​

json
{
  "scripts": {
    "ai": "claude"
  }
}
bash
npm run ai
# または
bun run ai

# Ctrl+Z でサスペンド → fg で再開が正常に動作するようになった

注意点 ​

  • この修正はラッパープロセス経由での起動（npx、bun run、npm run、シェルスクリプトなど）に特有の問題を解決します
  • claude コマンドを直接起動している場合は、この問題の影響を受けませんでした
  • ハングが発生していた場合は、別ターミナルから kill コマンドでプロセスを終了する必要がありましたが、v2.1.116では不要になりました
  • Ctrl+Z でサスペンドしたプロセスは fg コマンドでフォアグラウンドに戻せます

関連情報 ​