コンテンツにスキップ
日本語
РусскийEnglish简体中文HindiEspañolPortuguês (BR)日本語FrançaisDeutsch한국어
無料で登録
Coding Agent のセットアップ

Claude Code のインストールとモデル設定

BetterToken API Key、Base URL、Model ID で Claude Code に接続します。設定変更後に再起動するか、セッション中に /model でモデルを切り替えます。

BetterToken API Key、Base URL https://bettertoken.ai、使用する Model ID を設定して Claude Code に接続します。 モデル広場から正確な Model ID をコピーしてください。

主要設定

フィールド値
API KeyBetterToken API Key
Base URLhttps://bettertoken.ai
ModelYOUR_MODEL_ID

前提条件

登録して BetterToken API Key を取得

アカウントをお持ちの方は、ログインして残高をチャージし、コンソールでキーを作成してください。

インストール

Anthropic は Node.js が不要なネイティブインストーラーを推奨しています。npm を使う場合は Node.js 22 以降をインストールしてから、次を実行します。

ターミナルウィンドウ
npm install -g @anthropic-ai/claude-code

コマンドラインでの設定

BetterToken の自動設定スクリプトは、Claude Code のプロバイダー設定を書き込みます。Node.js が必要です。API Key を引数で渡さなかった場合は、実行時に入力します。

macOS / Linux

ターミナルウィンドウ
curl -fsSL "https://bettertoken.ai/install-claudecode-provider.sh" | bash

Windows

ターミナルウィンドウ
iwr "https://bettertoken.ai/install-claudecode-provider.ps1" -OutFile "$env:TEMP\install-claudecode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-claudecode-provider.ps1"

スクリプトが完了したら、~/.claude/settings.json（Windows では %USERPROFILE%\.claude\settings.json）を確認し、Claude Code を完全に再起動します。各フィールドを自分で管理する場合は、次の手動設定を使用してください。

手動設定

システムファイル
macOS / Linux~/.claude/settings.json
Windows%USERPROFILE%\.claude\settings.json

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

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID"
  }
}

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

例には任意の設定 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 を含めています。自動更新、エラー報告、一部の可用性チェックとアカウント機能を無効にします。認証には不要です。手動で更新するには claude update を実行します。パッケージマネージャーでインストールを管理している場合は、その更新機能を使ってください。更新手順と設定の影響を参照してください。

VS Code 拡張機能

拡張機能は VS Code の settings.json を使用します。独立した claudeCode.environmentVariables 設定を追加してください。

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://bettertoken.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_API_KEY"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    },
    {
      "name": "API_TIMEOUT_MS",
      "value": "3000000"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "YOUR_MODEL_ID"
    }
  ]
}

接続の確認

プロジェクトで Claude Code を起動します。

ターミナルウィンドウ
claude

短いメッセージを送信します。401、接続、モデルに関するエラーがなく、通常の応答が返れば設定は完了です。対話セッション内で /status を実行し、次の 2 行を確認してください。

  • Anthropic base URL の行に BetterToken の Base URL https://bettertoken.ai が表示されることを確認します。この行がなければ、変数が現在のセッションに渡っていません。settings.json のパスを確認し、Claude Code を完全に再起動してください。
  • 認証の行に、claude.ai アカウントでのログインではなく ANTHROPIC_AUTH_TOKEN が表示されることを確認します。

スクリプトから接続を確認するには、短いプロンプトを送信します。

ターミナルウィンドウ
claude -p "Reply with only: OK"

正常に OK が返れば、接続は機能しています。

既存のログインとの競合

環境変数の認証情報は、保存済みの claude.ai ログインより優先されます。起動時に認証情報の取得元が 2 つあるという警告が表示されたら、どちらか一方の設定を解除してください。BetterToken API Key だけを残すには、/logout を実行します。シェルで ANTHROPIC_API_KEY も設定している場合は、先に解除してください。

モデルの切り替え

設定の Model ID を変更し、Claude Code を再起動します。セッション中は /model YOUR_MODEL_ID で切り替えられます。

ANTHROPIC_DEFAULT_FABLE_MODEL で設定する fable など、ほかのエイリアスには公式のエイリアスマッピングに従って利用可能な Model ID を指定します。カスタム ID のコンテキストウィンドウを Claude Code が誤って判定する場合は、確認済みのモデルの上限に合わせてカスタムモデルのウィンドウ設定手順に従ってください。

/model に BetterToken のモデルを表示する（任意）

最近の Claude Code リリースを使用してください。~/.claude/settings.json の既存の env ブロックに "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1" を追加し、Claude Code を完全に再起動します。起動時に Claude Code が https://bettertoken.ai の /v1/models に問い合わせ、利用可能なモデルを取得します。公式のゲートウェイ設定ガイドを参照してください。

モデルの検出を確認するには、claude --debug で起動し、~/.claude/debug/<session-id>.txt 内の [gatewayDiscovery] の行を確認します。モデルをキャッシュしたことを示す行があれば、検出は成功しています。

Claude Code は、ゲートウェイプロトコルで説明されているとおり、Model ID に claude または anthropic を含むゲートウェイモデルのみを表示します（大文字と小文字は区別しません）。/v1/models が返すその他のモデル（GPT モデルを含む）は、BetterToken で利用できても /model には表示されません。Model ID を直接設定すれば、Claude Code からこれらのモデルを呼び出せます。Claude Code 2.1.309 のテストでは、この方法で指定した GPT モデルが Anthropic Messages 経由でテキストとファイル読み取りのリクエストに応答しました。

よくあるエラー

エラー対処方法
401 または認証エラーANTHROPIC_AUTH_TOKEN を確認し、API Key の前後にある空白を削除します。
ConnectionRefusedhttps://bettertoken.ai をそのまま使用し、/v1 を追加しないでください。
Model IDモデル広場で正確な Model ID を確認し、クライアントのモデル設定に入力してください。
設定が反映されないファイルパスを確認し、競合する環境変数を削除して、Claude Code を完全に再起動します。
起動時に 2 つの認証情報が競合するという警告が出るどちらか一方の設定を解除するか、/logout を実行してください。
証明書 / TLS エラー。企業のプロキシでよく発生NODE_EXTRA_CA_CERTS に CA 証明書ファイルのパスを設定し、Claude Code を再起動してください。
400 とともに Extra inputs are not permitted など、認識できないフィールドについて表示されるenv に "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1" を追加し、Claude Code を完全に再起動してください。解消しない場合はサポートに連絡してください。
長いセッションでコンテキストが長すぎると表示される/compact を実行してセッションを圧縮してください。

API Key 使用時に利用できない機能

リモートコントロール（Remote Control）と音声入力には、claude.ai アカウントでのログインが必要です。BetterToken API Key と独自の Base URL を使用する場合は利用できません。これは Claude Code クライアントの制限で、通常のコーディング対話には影響しません。

高度な設定

複数ツールの設定をまとめて管理する場合は CC Switch を参照してください。

関連する質問

技術情報

プロトコルとエンドポイント

Claude Code は Anthropic Messages を使用します。ANTHROPIC_BASE_URL に https://bettertoken.ai を設定してください。クライアントが /v1/messages を追加するため、Base URL に /v1 を追加しないでください。

BetterTokenAI MODEL APIsすべてのモデルを1つのAPIでAI API · 従量課金$2 割引$5 チャージでチャージ額の $5 全額が残高に反映。API の利用を始める初回チャージ：$5 分の残高、$2 割引条件を満たす初回チャージが対象。