Claude Code の Bash ツール実行エラーを解決する — タイムアウト・Permission Denied・出力切れの原因と対処法

# 長時間かかるビルドコマンドの例
# タイムアウトを300秒（5分）に設定して実行
npm run build
 
# テストスイートを実行する場合は10分に設定
npm run test:integration

# ❌ 対話モード（タイムアウトする）
npm init
git rebase -i main
 
# ✅ 非対話モード（正常に完了する）
npm init -y
git rebase main  # -i フラグを除去

# バックグラウンドでビルドを実行
npm run build > /tmp/build.log 2>&1 &
BUILD_PID=$!
echo "Build started with PID: $BUILD_PID"
 
# 後で結果を確認
wait $BUILD_PID && echo "SUCCESS" || echo "FAILED"
cat /tmp/build.log

bash: ./script.sh: Permission denied
# または
EACCES: permission denied, open '/path/to/file'
# または
fatal: could not create work tree dir: Permission denied

# 権限を確認
ls -la script.sh
# 出力例: -rw-r--r-- 1 user group 1234 Apr 8 10:00 script.sh
# → 実行権限（x）がない
 
# 実行権限を付与
chmod +x script.sh
 
# または bash 経由で実行（権限付与不要）
bash script.sh

# ❌ 書き込み制限のあるディレクトリ
git clone https://github.com/user/repo.git /opt/repo
 
# ✅ 書き込み可能なディレクトリ
git clone https://github.com/user/repo.git /tmp/repo

# npm のロックファイルが残っている場合
rm -f package-lock.json
rm -rf node_modules/.package-lock.json
 
# git のロックファイルが残っている場合
rm -f .git/index.lock

# 大量のログを出力するコマンド
npm install
# → 出力の途中で切れてしまい、成功/失敗が判断できない

# 全出力をファイルに保存し、最後の部分だけ確認
npm install > /tmp/npm-output.log 2>&1
echo "Exit code: $?"
tail -20 /tmp/npm-output.log

# エラー行だけ抽出
npm run build 2>&1 | grep -E "error|Error|ERROR|failed|Failed" | tail -20
 
# テスト結果のサマリーだけ取得
npm test 2>&1 | tail -30

# npm の出力を最小限にする
npm install --silent
# または
npm install --loglevel=error
 
# pip の出力を抑制する
pip install package-name --quiet --break-system-packages

Error: ENOENT: no such file or directory, open '/path/to/file'
# または
bash: node: command not found
# または
/usr/bin/env: 'python3': No such file or directory

# ❌ 相対パスは基準ディレクトリがずれるリスクあり
cd project && node scripts/build.js
 
# ✅ 絶対パスなら確実
node /tmp/repos/project/scripts/build.js
 
# ✅ または cd と実行を1行にチェーンする
cd /tmp/repos/project && node scripts/build.js

# ファイルの存在確認
FILE="/tmp/repos/project/package.json"
if [ -f "$FILE" ]; then
  echo "File exists"
  cat "$FILE" | head -5
else
  echo "File not found: $FILE"
  # 親ディレクトリの内容を確認
  ls -la "$(dirname "$FILE")"
fi

# コマンドの所在を確認
which node
which python3
which npm
 
# パスを確認
echo $PATH
 
# npx 経由で実行（ローカルインストールのみでOK）
npx tsc --version

# 環境変数を設定したはずなのに空になる
echo $MY_API_KEY
# → (空)
 
# または .env ファイルの値が読み込まれない
node -e "console.log(process.env.DATABASE_URL)"
# → undefined

# ❌ 別々のコマンドでは引き継がれない
# コマンド1: export MY_VAR="hello"
# コマンド2: echo $MY_VAR  → 空
 
# ✅ 1つのコマンド内で完結させる
export MY_VAR="hello" && echo $MY_VAR
 
# ✅ インライン環境変数
MY_VAR="hello" node -e "console.log(process.env.MY_VAR)"

# .env ファイルの値を現在のシェルに読み込む
set -a && source .env && set +a && node server.js
 
# または dotenv を使用（Node.js の場合）
node -r dotenv/config server.js

# .env ファイルに記述
echo 'DATABASE_URL=postgresql://localhost/mydb' >> .env
echo 'NODE_ENV=development' >> .env
 
# package.json の scripts で環境変数を設定
# "scripts": {
#   "dev": "NODE_ENV=development node server.js"
# }

# 1. 基本的なコマンド実行テスト
echo "Hello from Bash tool" && echo "Exit code: $?"
 
# 2. ファイル操作の権限テスト
touch /tmp/test-permission.txt && echo "Write OK" && rm /tmp/test-permission.txt
 
# 3. Node.js / Python の実行テスト
node -e "console.log('Node.js OK:', process.version)"
python3 -c "import sys; print(f'Python OK: {sys.version}')"
 
# 4. ネットワーク接続テスト
curl -s -o /dev/null -w "%{http_code}" https://api.anthropic.com/v1/messages
# → 401 が返ればネットワーク接続は正常（認証エラーは接続できている証拠）
 
# 5. git 操作テスト
cd /tmp && git init test-repo && cd test-repo && echo "test" > test.txt && git add . && git commit -m "test" && echo "Git OK" && rm -rf /tmp/test-repo

WORK="/tmp/repos/my-project"
cd "$WORK" && npm run build

# cd と実行を && で繋ぐ
cd /tmp/repos/my-project && npm test

# set -e でエラー時に即停止
set -e
cd /tmp/repos/my-project
npm install
npm run build
echo "All steps completed successfully"