CoreCodeドキュメント

ヘルプ

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 と表示します。リレーとは無関係です。オンボーディングをスキップしてください。

  1. エディタで ~/.claude.json(Windows では %USERPROFILE%\.claude.json)を開きます。
  2. トップレベルに "hasCompletedOnboarding": true を追加して保存します。
  3. もう一度 claude を実行します。

残りの公式へのリクエスト(自動更新、テレメトリ、エラー報告)がまだ失敗する場合は、~/.claude/settings.json の env に "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" を追加して無効にしてください。推奨設定を参照してください。

Invalid API key · Please run /login

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 policyAnthropic の安全分類器が、この会話内のメッセージを拒否しました。同じ会話をもう一度送っても再び拒否されるため、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

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 にあります。