モデルの呼び出し

Base URL の設定方法

Claude Code、Codex CLI、Cursor、Cline などで、Base URL、/v1 パス、API Key、Model ID を正しく組み合わせる方法を説明します。

要点

Base URL は、外部ツールが想定するプロトコルと一致させる必要があります。Claude Code は通常、Anthropic 互換のルートアドレスを使います。Codex CLI、Cursor、Cline、OpenCode、OpenClaw などの外部ツールは通常、OpenAI 互換の /v1 アドレスを使います。

BetterToken では、次のように設定します。

用途	Base URL
Claude Code / Anthropic 互換	`https://bettertoken.ai`
Codex CLI / OpenAI 互換	`https://bettertoken.ai/v1`
Cursor, Cline, OpenCode, OpenClaw	`https://bettertoken.ai/v1`

Claude Code には https://bettertoken.ai、Codex CLI と OpenAI-compatible ツールには https://bettertoken.ai/v1 を使用します。クライアントのプロトコルに合わせて接続先を選びます。

Base URL が複数ある理由

SDK によってパスの追加方法が異なります。

プロトコルまたは外部ツールの種類	一般的な動作
OpenAI 互換 SDK	通常、`/v1` 以下の chat completions や responses などのリソースを呼び出す
Anthropic 互換 SDK	通常、メッセージエンドポイントのパスを自動で追加するため、`/v1` を重ねて追加しない
外部ツール内蔵のプロバイダー	パスを自動で追加する場合と、完全な Base URL を求める場合がある

クイックリファレンス

外部ツール	推奨設定
Claude Code	`https://bettertoken.ai` と BetterToken API Key
Claude Desktop Gateway	認証方式を含め、Gateway ページの手順に従う
Codex CLI	`https://bettertoken.ai/v1` と BetterToken API Key
Cursor	`https://bettertoken.ai/v1` と BetterToken API Key
Cline	`https://bettertoken.ai/v1` と OpenAI Compatible プロバイダー
OpenCode / OpenClaw	`https://bettertoken.ai/v1` と BetterToken API Key

よくあるエラー

エラーまたは症状	考えられる原因
`404 Not Found`	Base URL のパスが SDK の想定するパスと一致していない
`model not found`	モデル広場で正確な Model ID を確認し、クライアントのモデル設定に入力してください。
`invalid_api_key`	API Key と Base URL が異なるサービスのものになっている
認証は成功するが、モデルを利用できない	モデル広場で正確な Model ID を確認し、クライアントのモデル設定に入力してください。
リクエストが失敗し続ける	Anthropic 互換アドレスを OpenAI 互換ツールで使っている、またはその逆

推奨されるトラブルシューティング手順

外部ツールが OpenAI 互換 API と Anthropic 互換 API のどちらを想定しているか確認します。
Base URL がそのプロトコルと一致しているか確認します。
API Key が同じサービスのものか確認します。
モデル広場から正確な Model ID をコピーしてください。
hello などの最小限のテストリクエストを送信します。

コード例

OpenAI 互換ツールは通常、/v1 アドレスを使います。

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://bettertoken.ai/v1"
)

response = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "hello"}]
)

Claude または Anthropic 互換の設定では通常、ルートアドレスを使います。

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://bettertoken.ai"
)

message = client.messages.create(
    model="your-model-id",
    max_tokens=1024,
    messages=[{"role": "user", "content": "hello"}]
)