Claude Code のよくあるエラーと修正方法

エラーメッセージ一覧

以下のエラーメッセージは Claude Code 2.1.299 でテストしたものです。

400

API Error: 400 {"error":"模型 xxx 不存在或未上线，请前往 https://aicodewith.com/zh/dashboard/pricing 查看可用模型列表 (request_id: …)"}

• •モデル名のスペルが間違っているか、モデルが利用できません：/model を実行して選び直すか、モデルページでモデル ID を確認してください。
• •コンテキストが長すぎます：/compact を実行して会話を圧縮するか、/clear で新しいセッションを開始してください。

401 認証

Failed to authenticate. API Error: 401 {"error":"请在请求中提供有效的 API Key。"}

1. ダッシュボードからキーをもう一度コピーし、先頭／末尾のスペースや改行がないこと、キーが削除されていないことを確認してください。
2. キーは ANTHROPIC_AUTH_TOKEN に設定し、ANTHROPIC_API_KEY は空のままにしてください。
3. 新しいターミナルで echo $ANTHROPIC_API_KEY を実行し、~/.zshrc または ~/.bashrc にある古い値を削除してください。
4. すべての Claude Code セッションを閉じて開き直し、/status を実行してください。

403 キー無効化

Failed to authenticate. API Error: 403 此 API Key 已被停用，如有疑问请联系我们 https://aicodewith.com/zh/contact

キーが無効化または削除されると、このエラーは数秒以内に表示されます。ダッシュボードでキーの状態を確認し、新しいキーを作成して設定を更新してください。不明な点があればお問い合わせください。

Not logged in

Not logged in · Please run /login

これはキーが空か設定されていないことを意味し、Claude アカウントにログインする必要があるという意味ではありません。~/.claude/settings.json の ANTHROPIC_AUTH_TOKEN にキーを入力し、Claude Code を再起動してください。

429 レート制限

{"error":"当前并发请求过多，请稍后重试 (request_id: …)"}

（このエラーは curl の同時リクエストで再現しました。Claude Code 内での表示は異なる場合があります。）

従量課金には5時間または週次のクォータはありませんが、レート制限と同時実行数の制限は引き続き適用されます。一度に送信するリクエストが多すぎると、超過したリクエストが 429 を返します。少し待ってから再試行してください。

• •余分な Claude Code セッションを閉じ、並列サブエージェントを減らしてください。同じキーを共有するスクリプトや CI ジョブもカウントされます。
• •担当者またはパイプラインごとに別のキーを作成すると、発生元を特定しやすくなります。

overloaded

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}

リクエストとキーは問題ありません。その瞬間にモデルが混雑しているだけです。急増は通常短時間で、特定のモデルにのみ影響します。

• •少し待ってから再送信してください。会話は失われません。
• •/model を実行して別のモデル（たとえば Opus から Sonnet）に切り替え、先に作業を進めてください。
• •モデルページでチャネルのステータスを確認し、必要に応じてキーを別のチャネルに切り替えてください。

タイムアウト／接続切断（ECONNRESET）

API Error: Connection dropped (ECONNRESET)

このエラーは、API エンドポイントに到達できないか、ドメインが間違っている場合に表示されます。

• •/status を実行し、API エンドポイントが api.aicodewith.ai であり、デフォルトの Anthropic アドレスになっていないことを確認してください。
• •ローカルプロキシまたは VPN を一時的に無効にして再試行してください。中国からの接続は直接動作する場合があります。

キーが間違っている場合やネットワークに到達できない場合、Claude Code は約3～4分間自動的に再試行し、その間インターフェースはメッセージなしで空白のままになります。長時間応答がない場合は、まずキーとエンドポイントを確認してください。

サードパーティ API の問題（Base URL、設定が反映されない）

There's an issue with the selected model (...). It may not exist or you may not have access to it. Run --model to pick a different model.

ANTHROPIC_BASE_URL が https://aicodewith.ai に設定されているか、不正なパス（/foo など）が含まれていると、このエラーが発生します。モデルの問題に見えますが、実際にはエンドポイントが間違っています。代わりに https://api.aicodewith.ai を使用してください。

環境変数は ~/.claude/settings.json より優先されます。ターミナルで export した古い値は設定ファイルを上書きします。設定を変更した後は、すべての Claude Code セッション（VS Code および JetBrains プラグインを含む）を閉じて開き直してください。標準設定は次のとおりです：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
  }
}

• •ANTHROPIC_BASE_URL には /v1 や末尾のスラッシュを含めないでください。
• •初回実行でログインページに固まる場合は、~/.claude.json に "hasCompletedOnboarding": true を追加してください。

Claude Code 連携ガイドClaude Code 中継設定Claude Haiku API エラーのトラブルシューティング

FAQ