コンテンツにスキップ
無料で登録
はじめに

よくある質問

BetterToken のアカウント、請求、残高、使用量、API Key、Base URL、モデル呼び出し、外部ツールの設定、接続エラーに関する回答と解決方法を確認できます。

AI コーディングツールに関する質問

ここでは、Claude Code、Codex、Cursor、Cline などの AI コーディングツールについて説明します。各ツールの概要に続いて、API Key、Base URL、プロトコルの選択、使用量の確認を BetterToken とどのように組み合わせるかを解説します。

アカウントと請求

  • 紹介プログラムのルール:友人の登録と初回チャージ後の紹介特典、特典残高の使われ方、手動審査が行われる場合を説明します。
BetterToken の使用料金はどのように計算されますか?

BetterToken は実際の Token 使用量に基づいて課金し、追加のマークアップを加えずに Anthropic / OpenAI の料金に従います。

詳細は料金ページを参照してください。

登録後に返金を申請できますか?

支払い済みのチャージの返金が必要な場合は、サポートにお問い合わせください。

同じ API Key を複数のツールで使えますか?

はい。同じ API Key を Claude Code、Codex、Cursor などのツールで同時に使用できます。使用量は共有されます。

使用量はどこで確認できますか?

Dashboard にログインすると、現在の使用量と請求記録を確認できます。

インストールと設定

BetterToken の base_url は何ですか?

BetterToken では、プロトコルに応じて 2 つのエンドポイントを使い分けます。

用途Base URL
Claude Code / ANTHROPIC_BASE_URLhttps://bettertoken.ai
Codex / OPENAI_BASE_URL / 外部ツールhttps://bettertoken.ai/v1

すべてのツールで同じアドレスを使い回さないでください。

Claude Code でモデルを指定する必要がありますか?

BetterToken API Key、Base URL https://bettertoken.ai、使用する Model ID を設定して Claude Code に接続します。 YOUR_MODEL_ID をコピーした ID に置き換えます。ANTHROPIC_MODEL で主モデルを、3 つの ANTHROPIC_DEFAULT_*_MODEL 変数で Haiku、Sonnet、Opus のエイリアスを設定します。同じモデルでも、役割ごとに別のモデルでも指定できます。 モデル広場から正確な Model ID をコピーしてください。

Codex でモデルを指定する必要がありますか?

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

Cursor などの外部ツールでモデルを指定する必要がありますか?

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

OpenClaw などの外部ツールで追加の headers は必要ですか?

通常は必要ありません。

確認した公式ドキュメントでは、Cursor、Cline、Zed などの一般的な外部ツールは Base URL、API key、モデル ID を主に使用します。OpenCode と OpenClaw は任意の headers に対応していますが、公式ドキュメントではカスタムヘッダーや固有の認証要件向けの機能として説明されており、BetterToken の必須設定ではありません。

追加のヘッダーは、ツールの公式ドキュメント、独自の upstream gateway、tenant routing、observability、cache レイヤーで明示的に必要な場合だけ設定してください。

設定後に認証が失敗する場合はどうすればよいですか?

次の項目を確認してください。

  1. API Key が正しく、余分な空白が入っていないこと
  2. Claude Code では https://bettertoken.ai、Codex または外部ツールでは https://bettertoken.ai/v1 を使用していること
  3. 古い ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、OPENAI_API_KEY、OPENAI_BASE_URL が設定を上書きしていないこと
  4. 外部ツールについては、バージョン制限、モデルの allowlist、upstream gateway が明示的に要求する追加ヘッダーなど、公式の追加要件がないか確認すること

問題が解決しない場合は、サポートにお問い合わせください。

モデル呼び出し

  • AI モデルの選び方:プロトコル、タスクの種類、品質、速度、コンテキスト長、コストを基準に AI モデルを選ぶ方法を説明します。
  • モデルのバージョンを確認する:API 呼び出しでモデルが自分のバージョンを誤って答える理由と、実際に使用したモデルを確認する方法を説明します。
  • Base URL の設定:Claude Code、Codex CLI、Cursor、Cline などで、Base URL、/v1 パス、API Key、Model ID を正しく組み合わせる方法を説明します。
  • 出力トークンの上限:max_tokens、max_completion_tokens、max_output_tokens と、モデル呼び出しの出力 Token 上限を設定する方法を説明します。
  • Pydantic で構造化 JSON を検証する:LLM が返す JSON を Pydantic で検証し、元の応答を保持して修復と再試行を明示的に扱います。

コストとトークン

信頼性と使用制限

BetterToken はどのように信頼性を維持しますか?

BetterToken は複数のプロバイダーに接続し、次の仕組みを使用します。

  • 複数プロバイダー:1 つのプロバイダーに障害が発生しても、すべてのリクエストが停止するわけではありません
  • 動的ルーティング:BetterToken は高速で安定した経路をリアルタイムに選択します
  • 優先的な互換性維持:Claude Code と Codex エコシステムを中心に信頼性を維持します
使用制限や timeout が発生した場合はどうすればよいですか?

BetterToken は個別プロバイダーの使用制限と timeout を自動的に処理します。問題が続く場合は、次を確認してください。

  1. 残高が十分にあること
  2. ツールの timeout を長くすること(API_TIMEOUT_MS=3000000 を推奨)
  3. 現在の quota 状態をサポートに確認すること
BetterToken は本番環境に適していますか?

BetterToken は主に Claude Code や Codex などの AI コーディングツールを使用する個人開発者向けです。大規模な本番 API ワークロードでは、自身の要件に基づいて評価してください。

プライバシーとセキュリティ

  • データセキュリティ:BetterToken API 呼び出しにおけるデータセキュリティの境界、HTTPS 通信、ログ、利用記録、および利用者側でのセキュリティ対策を説明します。
BetterToken はリクエストの内容を保存しますか?

BetterToken は relay として動作し、会話内容を永続化しません。詳細はプライバシーポリシーを参照してください。

API Key が漏えいした場合はどうすればよいですか?

すぐに Dashboard にログインし、古い Key を削除して新しい Key を作成します。その後、その Key を使っているすべてのツールを更新してください。

地域別のアクセス

  • ロシアからの直接アクセス:ロシアの利用者が地域サイトと API へ直接アクセスする方法、VPN が不要な場合、ネットワーク問題のトラブルシューティングを説明します。

関連ガイド