高度な設定

ベストプラクティス

API Key の保護、モデル選択、コスト管理、安定したリクエスト、エラー処理、Claude Code や Codex CLI などの外部ツール設定に関する BetterToken の推奨事項です。

API Key を安全に保つ

環境変数を使用し、ハードコードしないでください。 API Key をソースコードや設定ファイルに直接書くと、バージョン管理で誤って公開されるリスクがあります。推奨する方法は次のとおりです。

# Add to ~/.zshrc or ~/.bashrc so it loads automatically each session
export BETTERTOKEN_API_KEY="your-api-key-here"

Claude Code では、シェル設定に公開するのではなく、env フィールドを settings.json で使用してシークレットを管理します。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here"
  }
}

API Key を定期的にローテーションします。 漏えいの疑いがある場合は、Dashboard から直ちに Key を削除し、新しいものを生成します。

十分な Timeout を設定する

AI モデルの Response には時間がかかる場合があります。特に複雑な推論タスクではその傾向があります。早すぎる切断を避けるため、Timeout を十分に長く設定します。

{
  "env": {
    "API_TIMEOUT_MS": "3000000"
  }
}

3000000 ms は 50 分です。深い推論や長時間のエージェントタスクに適しています。

競合する環境変数を削除する

以前に公式 Anthropic API、OpenAI API、または別のリレーサービスを使用していた場合、古い環境変数が BetterToken の設定を上書きし、Request が意図せず誤った Endpoint に送信されることがあります。

BetterToken を設定する前に、次の項目を確認して削除します。

# Check if they exist
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL

# Clear them
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL
unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Claude Code：まずプロバイダーを確認する

YOUR_MODEL_ID をコピーした ID に置き換えます。ANTHROPIC_MODEL で主モデルを、3 つの ANTHROPIC_DEFAULT_*_MODEL 変数で Haiku、Sonnet、Opus のエイリアスを設定します。同じモデルでも、役割ごとに別のモデルでも指定できます。

2 つの設定を混在させないでください。Request が誤ったモデルにルーティングされる可能性があります。

不要なトラフィックを無効にします。 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 を設定すると、Claude Code からのバックグラウンド Request が減り、実際のコーディングタスクのために API クォータを確保できます。

Claude Code に /v1 を追加しないでください。 ANTHROPIC_BASE_URL は https://bettertoken.ai にします。

複数ツールで 1 つの API Key を使用する

同じ API Key を Claude Code、Codex、外部ツールで使用できます。クォータは共有されるため、集中管理が簡単になります。

ただし、Endpoint はプロトコルに一致させる必要があります。

Claude Code / ANTHROPIC_BASE_URL: https://bettertoken.ai
Codex / OPENAI_BASE_URL / external tools: https://bettertoken.ai/v1

プロジェクトやチームごとに使用量を分けて追跡する必要がある場合は、Dashboard で複数の API Key を作成し、各ツールまたはプロジェクトに 1 つずつ割り当てます。

モデル広場から正確な Model ID をコピーしてください。

トラブルシューティングチェックリスト

API Key が正しいことを確認する — Dashboard を確認し、余分な空白なしで慎重に貼り付けます
プロトコルの Endpoint を確認する — Claude Code は https://bettertoken.ai、Codex / 外部ツールは https://bettertoken.ai/v1 を使用します
競合する環境変数を確認する — echo $ANTHROPIC_AUTH_TOKEN、echo $OPENAI_BASE_URL、関連コマンドを実行します
ツール公式の設定要件を確認する — 外部ツールでは、まず Base URL、API Key、モデル ID、ツールバージョンを確認します。追加ヘッダーは、ツール公式ドキュメントまたは上流 Gateway が明示的に要求する場合のみ追加します
残高を確認する — 残高がなくなると Request は拒否されます
サポートに連絡する — 上記の手順で問題が解決しない場合