Claude Code ガイド

Appearance

エラーメッセージの改善：レート制限・5xxエラー・不明なスラッシュコマンドの対応強化 ​

原文（日本語に翻訳） ​

エラーメッセージを改善：サーバーのレート制限をプランの使用制限と区別して表示するようになった。5xx/529エラーにはstatus.claude.comへのリンクが表示される。不明なスラッシュコマンドには最も近い候補が提案される。

原文（英語） ​

Improved error messages: server rate limits are now distinguished from plan usage limits; 5xx/529 errors show a link to status.claude.com; unknown slash commands suggest the closest match.

概要 ​

Claude Codeのエラーメッセージが3つの点で改善されました。①サーバーのレート制限とプランの使用量上限が明確に区別されるようになりました。②サーバーエラー（5xx/529）発生時に、サービス状況確認ページへのリンクが表示されます。③存在しないスラッシュコマンドを入力した際に、最も近いコマンドが提案されるようになりました。これらの改善により、問題の原因を素早く特定して対処できるようになります。

基本的な使い方 ​

レート制限エラーの新しい表示 ​

従来の表示（区別なし）：

エラー：リクエストが制限されています

改善後の表示（区別あり）：

# サーバーレート制限の場合
⚠️ サーバーのレート制限に達しました（一時的な制限）
しばらく待ってから再試行してください。

# プラン使用量上限の場合
⚠️ プランの月次使用量上限に達しました
https://claude.ai/settings/billing でプランをアップグレードできます。

5xx/529エラーの新しい表示 ​

❌ サーバーエラーが発生しました (529)
サービスの状況を確認してください：https://status.claude.com
問題が続く場合は、しばらく後に再試行してください。

不明なスラッシュコマンドの候補提案 ​

# 誤って /reviwe と入力した場合
/reviwe

# 新しいエラーメッセージ：
❌ 不明なコマンド: /reviwe
もしかして: /review

実践例 ​

レート制限の種類による対処方法 ​

# サーバーレート制限（一時的）の場合
→ 数分待ってから再試行する
→ アクティブな並行セッション数を減らす

# プラン使用量上限の場合
→ https://claude.ai/settings/billing でプランを確認
→ 月次リセットまで待つ
→ 上位プランへのアップグレードを検討

5xx/529エラー時の対応フロー ​

エラーが発生したら：

1. https://status.claude.com を確認
   → インシデントが報告されていれば、復旧を待つ

2. インシデントがなければ：
   → 数分後に再試行
   → Claude Code を再起動してみる
   → ネットワーク接続を確認

スラッシュコマンドの候補機能を活用 ​

# タイポした場合でも正しいコマンドに誘導される
/secuirty-review  → もしかして: /security-review?
/inizt            → もしかして: /init?
/resum            → もしかして: /resume?

CI/CDでのエラーハンドリング改善 ​

bash
# スクリプトでClaude Codeを使用する場合
# エラーメッセージがより詳細になり、自動化スクリプトでの
# エラー種別の判定が容易になる

claude --print "タスクを実行してください" || {
  echo "エラーが発生しました"
  echo "レート制限の場合は待機、サーバーエラーの場合は status.claude.com を確認"
}

注意点 ​

  • レート制限の2種類を把握する: サーバーレート制限は一時的（数分で解消）ですが、プランの使用量上限は月次リセットまで継続します。エラーメッセージで種類を確認することが重要です。
  • status.claude.comはリアルタイム情報: 5xxエラー時にはまずstatus.claude.comを確認することで、自分の問題か、サービス全体の問題かをすぐに判断できます。
  • スラッシュコマンドの補完機能との連携: タブ補完を使えばタイポを最小化できますが、候補提案機能がバックアップとして機能します。

関連情報 ​