Claude Code は非常に強力なツールですが、使い込んでいると「このエラー、また出た…」という場面に遭遇することがあります。本記事では、よくあるエラーとその対処法を体系的にまとめました。

Claude Code を使っていると、以下のメッセージが表示されることがあります。

API Error: 400 due to tool use concurrency issues.
Run /rewind to recover the conversation.

原因: ツールの実行中にユーザーが割り込み操作（Ctrl+C など）を行ったり、複数のツール呼び出しが競合した場合に発生します。会話の状態が壊れた（不整合な）状態になっているため、API が 400 を返しています。

エラーメッセージに記載の通り、/rewind コマンドで最後の変更を巻き戻し、会話を正常な状態に戻せます。

/rewind

直前のツール実行が取り消され、会話の文脈はそのまま継続できます。

巻き戻しが不要な場合や /rewind でも解消しない場合は、新しいセッションを開始するのが最も確実です。

# 現在のセッションを終了
exit

# 新しいセッションを開始
claude

2025年11月時点では、VS Code 拡張の Claude Code では /rewind が未対応でした。2026年時点では対応状況が改善されている可能性がありますが、未対応の場合はサイドバーで新しいセッションを作成してください。

💡 ヒント: コンテキストを引き継ぎたい場合は、会話の要点を CLAUDE.md やドキュメントとしてプロジェクト内に残しておくと、セッションをまたいでもスムーズに作業を再開できます。

長時間の作業やファイル読み込みを繰り返すと、コンテキストウィンドウの上限に達することがあります。

対処方法:

• /compact コマンドでコンテキストを要約・圧縮する
• /clear でコンテキストをリセットしてから続きを指示する
• CLAUDE.md に重要な前提情報をまとめておき、セッション冒頭で読み込ませる

# コンテキストを圧縮
/compact

# または完全にリセット
/clear

Claude Code がファイルへの書き込みやコマンド実行を試みた際に、パーミッション設定によりブロックされた場合に発生します。

確認ポイント:

1. .claude/settings.json の deny ルールに該当していないか確認する
2. 意図的に許可したい場合は allow または ask ルールに追加する

{
  "permissions": {
    "allow": [
      "Bash(npm run build:*)"
    ]
  }
}

ask ルールに設定されたコマンドを実行しようとした際に表示される確認プロンプトです。エラーではなく正常な動作です。y または yes で承認してください。

API キーが正しく設定されていない、または期限切れの場合に発生します。

対処方法:

# 環境変数を確認
echo $ANTHROPIC_API_KEY

# 再設定
export ANTHROPIC_API_KEY="sk-ant-..."

Anthropic Console で API キーの有効性を確認し、必要であれば新しいキーを発行してください。

短時間に大量のリクエストを送った場合や、月間トークン上限に達した場合に発生します。

対処方法:

• しばらく待ってから再実行する
• Anthropic Console でトークン使用量と制限を確認する
• /cost コマンドでセッション内のコスト消費を確認する

/cost

インストール後に claude コマンドが認識されない場合です。

対処方法:

# パスを確認
which claude

# npm グローバルのパスを確認
npm config get prefix

# .bashrc に追加（例）
export PATH=~/.npm-global/bin:$PATH
source ~/.bashrc

Claude Code は Node.js 18 以上が必要です。

# バージョン確認
node -v

# nvm で最新版に切り替え
nvm install --lts
nvm use --lts

エラーを未然に防ぐために、以下の習慣をおすすめします。

コンテキストを定期的に保存する

長い作業セッションでは、重要な決定や方針を CLAUDE.md にこまめに記録しておきましょう。セッションが壊れても即座に復旧できます。

/status で状態を確認する

作業中に /status コマンドで現在のコンテキスト使用量やツールの状態を確認する習慣をつけると、エラーが起きる前に対処できます。

定期的にセッションを切り替える

長時間同じセッションで作業を続けると不安定になることがあります。タスクの区切りでセッションを切り替え、CLAUDE.md で前後の文脈をつなぐのが安定した運用パターンと考えています。

Claude Code は継続的にアップデートされているため、エラーの挙動が変わることもあります。公式ドキュメントやリリースノートも合わせて参照してください。