> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ベストプラクティス

> BetterToken を最大限に活用するためのヒント。

## API Key を安全に保つ

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

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

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

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here"
  }
}
```

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

***

## 十分な Timeout を設定する

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

```json theme={null}
{
  "env": {
    "API_TIMEOUT_MS": "3000000"
  }
}
```

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

***

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

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

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

```bash theme={null}
# 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：まずプロバイダーを確認する

**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`

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

外部ツールでは、<a href={"https://bettertoken.ai/pricing"}>モデル広場</a>の **GPT プロバイダー**からモデル ID をコピーします。

***

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

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