ヘルプ
Claude Code のエラー
エラーメッセージから原因を探せます。各項目で、意味と対処法を説明します。まずリクエストの送信先を確認してください。Claude Code で /status を実行し、Base URL が https://corecode.live になっているはずです。違っていれば、先に Claude Code で設定を直してください。
Unable to connect to Anthropic services
初回起動時、オンボーディングは Anthropic のサービスに接続しますが、中国本土からは多くの場合つながらないため、Claude Code は Unable to connect to Anthropic services や Failed to connect to api.anthropic.com と表示します。リレーとは無関係です。オンボーディングをスキップしてください。
- エディタで
~/.claude.json(Windows では%USERPROFILE%\.claude.json)を開きます。 - トップレベルに
"hasCompletedOnboarding": trueを追加して保存します。 - もう一度
claudeを実行します。
残りの公式へのリクエスト(自動更新、テレメトリ、エラー報告)がまだ失敗する場合は、~/.claude/settings.json の env に "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" を追加して無効にしてください。推奨設定を参照してください。
Invalid API key · Please run /login
Claude Code がリレーのキーを見つけられず、公式ログインに切り替わりました。よくある原因は次のとおりです。
- 変数を別のターミナルでしか設定していない。
~/.claude/settings.jsonのenvに書くのが確実で、すべてのターミナルと VS Code 拡張機能がそれを読みます。 - 変数名のスペルミス。リレーのキーは
ANTHROPIC_AUTH_TOKEN、アドレスはANTHROPIC_BASE_URLに入れます。 - Claude Code を再起動していない。設定は起動時にしか読み込まれません。
表示される案内どおりに claude.ai アカウントで /login を実行しないでください。Claude Code が公式アカウントに切り替わってしまいます。
Auth conflict: Both a token and an API key are set
ANTHROPIC_AUTH_TOKEN と ANTHROPIC_API_KEY の両方が設定されていて、Claude Code がどちらを使うか判断できません。ANTHROPIC_API_KEY を削除し、ANTHROPIC_AUTH_TOKEN だけを残してください。現在のターミナルでも空であることを echo $ANTHROPIC_API_KEY(PowerShell では $env:ANTHROPIC_API_KEY)で確認してください。以前 claude.ai にサインインしていた場合は、/logout も実行してください。
401 authentication_error
リレーはリクエストを受け取りましたが、キーを受け付けません。コピー時に文字が欠けた、キーが削除された、別のプロバイダーのキーである、などが考えられます。API キーのページからコピーし直し、sk- で始まっていて前後に空白がないことを確認してください。
403
| メッセージ | 原因 | 対処法 |
|---|---|---|
| Insufficient quota | 残高を使い切っています。 | ウォレットでチャージしてください。すぐに使えるようになり、設定の変更は不要です。 |
| Only requests from Claude Code are accepted | 仅限CC(Claude Code 限定)グループのキーは Claude Code CLI だけを受け付け、SDK、curl、その他のクライアントは拒否されます。 | Claude Code で使ってください。他のクライアントでは、可外接(外部クライアント可)グループのキーを使ってください。 |
| Request not allowed | リクエストが Anthropic に直接送られ、地域制限で拒否されました。つまり、リレーを経由していません。 | /status で Base URL を確認してください。上記を参照してください。 |
| This conversation contains a message the upstream model refused under its usage policy | Anthropic の安全分類器が、この会話内のメッセージを拒否しました。同じ会話をもう一度送っても再び拒否されるため、CoreCode は転送せずに止めています。分類器は通常のリクエストを拒否することもあり、Claude Code の auto モードが送る別個のチェックも対象になります。 | 新しい会話を始めるか、拒否されたメッセージを編集して送り直してください。繰り返し起きる場合は、CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS が設定されていないか確認してください。auto モードのコストを参照してください。 |
429 rate_limit_error
キーがリクエストレートまたは同時実行数の上限を超えました。Claude Code は自動で待ってから再試行するので、たまに出る程度なら対処は不要です。頻繁に出る場合は、同時に動かす Claude Code のセッションとサブエージェントを減らしてください。同時実行数を増やしたい場合はお問い合わせください。
529 overloaded_error
Anthropic が一時的に過負荷になっています。原因は設定ではなく、Claude Code は自動で再試行します。数分以上続く場合はサービスステータスを確認するか、/model でしばらくモデルを切り替えてください。
500、502、503、504
Service deployment in progress; retry shortly.を伴う503:CoreCode がリリース中です。レスポンスにはRetry-After: 5が付くので、数秒後に再試行してください。処理中のリクエストは影響を受けません。- それ以外の
5xx:上流またはゲートウェイの障害です。まずサービスステータスを確認してください。正常に見えるのにエラーが繰り返される場合は、利用ログから失敗したリクエストの時刻をお知らせください。
400 invalid_request_error
| メッセージ | 対処法 |
|---|---|
prompt is too long | コンテキストがモデルの上限を超えています。/compact で履歴を圧縮するか、/clear で新しいセッションを始めてください。 |
| Model does not exist | 料金ページに載っているモデル名を、ベンダー名のプレフィックスなしで使ってください。 |
長時間出力がない、またはタイムアウトする
拡張思考では、モデルが数分間テキストを出さないことがありますが、正常です。CoreCode のゲートウェイの読み取りタイムアウトは 10 分です。Claude Code 自身のタイムアウトは、ミリ秒で指定する API_TIMEOUT_MS です。10 分より短く設定すると、長い思考がクライアントによって打ち切られます。
プロキシや VPN を使っているとき
corecode.live は中国本土から直接アクセスできます。グローバルプロキシを使うとリクエストが遠回りになり、遅くなるうえ、ときどきストリームが切れます。プロキシクライアントで corecode.live に DIRECT ルールを追加してください。支払いページが開かない場合も、プロキシをオフにして試してください。
それでも解決しないとき
まずサービスステータスを確認してください。正常に見える場合は、次の 3 点をお知らせください。claude --version の出力、エラーの正確な内容、利用ログから見た失敗したリクエストの時刻です。WeChat グループで質問することもできます。その他の質問は FAQ にあります。