API Key を安全に保つ
環境変数を使用し、ハードコードしないでください。 API Key をソースコードや設定ファイルに直接書くと、バージョン管理で誤って公開されるリスクがあります。推奨する方法は次のとおりです。env フィールドを settings.json で使用してシークレットを管理します。
十分な Timeout を設定する
AI モデルの Response には時間がかかる場合があります。特に複雑な推論タスクではその傾向があります。早すぎる切断を避けるため、Timeout を十分に長く設定します。3000000 ms は 50 分です。深い推論や長時間のエージェントタスクに適しています。
競合する環境変数を削除する
以前に公式 Anthropic API、OpenAI API、または別のリレーサービスを使用していた場合、古い環境変数が BetterToken の設定を上書きし、Request が意図せず誤った Endpoint に送信されることがあります。 BetterToken を設定する前に、次の項目を確認して削除します。Claude Code：まずプロバイダーを確認する
Claude プロバイダーでは、ANTHROPIC_MODEL、ANTHROPIC_SMALL_FAST_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、その他のモデル固有変数を設定しないでください。GPT プロバイダーでは、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL を通じてモデルマッピングを追加します。
2 つの設定を混在させないでください。Request が誤ったモデルにルーティングされる可能性があります。
不要なトラフィックを無効にします。 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 を設定すると、Claude Code からのバックグラウンド Request が減り、実際のコーディングタスクのために API クォータを確保できます。
Claude Code に /v1 を追加しないでください。 ANTHROPIC_BASE_URL は https://www.bettertoken.ai にします。
複数ツールで 1 つの API Key を使用する
同じ API Key を Claude Code、Codex、外部ツールで使用できます。クォータは共有されるため、集中管理が簡単になります。 ただし、Endpoint はプロトコルに一致させる必要があります。- Claude Code /
ANTHROPIC_BASE_URL:https://www.bettertoken.ai - Codex /
OPENAI_BASE_URL/ external tools:https://www.bettertoken.ai/v1
トラブルシューティングチェックリスト
- API Key が正しいことを確認する — Dashboard を確認し、余分な空白なしで慎重に貼り付けます
- プロトコルの Endpoint を確認する — Claude Code は
https://www.bettertoken.ai、Codex / 外部ツールはhttps://www.bettertoken.ai/v1を使用します - 競合する環境変数を確認する —
echo $ANTHROPIC_AUTH_TOKEN、echo $OPENAI_BASE_URL、関連コマンドを実行します - ツール公式の設定要件を確認する — 外部ツールでは、まず
Base URL、API Key、モデル ID、ツールバージョンを確認します。追加ヘッダーは、ツール公式ドキュメントまたは上流 Gateway が明示的に要求する場合のみ追加します - 残高を確認する — 残高がなくなると Request は拒否されます
- サポートに連絡する — 上記の手順で問題が解決しない場合