Claude APIを使うCline — ベースURLの設定、Plan/Actモデルルーティング、実際のコスト

ClineはVS Code向けのオープンソース自律型コーディングエージェントであり、モデルは同梱していません。通常は自分のAPIキーでモデルに接続します。このガイドでは、ClaudeをClineで使うための正確な設定、メインラインモデルでAnthropicの定価より約30%低い料金で利用できる1つのsk-kn-キー、両方のプロバイダールート、Plan/Actモードを活用して請求額を削減する方法、実際のセッション費用、Anthropicを直接呼び出す場合と比べて失うものを率直に説明します。

ClineにAPIキーが必要な理由

Clineが行うすべての操作、つまりファイルの読み取り、差分の提案、ターミナルコマンドの実行、出力の読み取り、再試行は、モデル呼び出しです。ClineはClaude ProまたはMaxのサブスクリプションをClaude Codeプロバイダー経由で利用でき、Claude CLIを動かしてAPI課金ではなくサブスクリプション上限を使用できます。ただし、2026年9月時点でClineのドキュメントに記載されているトレードオフとして、このモードではレスポンスがトークン単位でストリーミングされない場合があり、画像アップロードとプロンプトキャッシュには制限があります。このガイドで設定するOpenAI CompatibleおよびAnthropicプロバイダーを含む、それ以外のすべてのルートでは、APIキーを通じてトークン単位で課金されます。それらのルートで問題になるのは、トークン単位で支払うかどうかではなく、どの料金で支払うかです。エージェントループは各ステップで増加するタスクコンテキストを再送信するため、トークン単価がセッション費用を左右する最大の要因です。ここでゲートウェイを使う理由はそれに尽きます。10ドルのチャージから始める従量課金、GPTにも到達できる1つのキー、そして有効期限のない残高です。

セットアップ — 3つのフィールド

Clineパネルを開き、設定の歯車をクリックして、APIプロバイダーをOpenAI Compatibleに設定します。値は3つです。

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...              # create at kunavo.com/app/keys
Model ID       claude-sonnet-5        # or claude-opus-5 / claude-haiku-4-5

ダッシュボードでサインアップしてチャージした後にキーを作成します。キーは一度だけ表示されるため、すぐに保存してください。キーの管理、ローテーション、支出制限についてはClaude APIキーのドキュメントで説明しています。Clineがコンテキストウィンドウや出力上限などのモデルメタデータを求めた場合は、推測せずモデルページから数値を取得してください。コンテキストウィンドウを過小設定すると、Clineが必要以上に早く切り詰めることになります。

編集を許可する前に、簡単な質問（「このファイルを説明して」など）をして、接続が正しいことを確認してください。この時点で401が出る場合、ほぼ必ずキーが原因です。404の場合は、ほぼ必ずベースURLか存在しないモデルスラッグが原因です。Kunavoはスラッグを完全一致で処理し、日付サフィックス付きの名前を別名として扱わないため、claude-sonnet-4-5-20250929は404になりますが、claude-sonnet-4-6は解決されます。

PlanモードとActモード — 最も費用を抑えられる分担

Clineの特徴は、Plan（コードベースを読み、質問し、アプローチを提案する）とAct（編集を行い、コマンドを実行する）を分離し、それぞれに異なるモデルを設定できる点です。2つのモードではトークンの使われ方が大きく異なるため、これはコスト構造にほぼ完全に対応します。

• Planは短く、推論中心です。モデルの品質によって、次の20ステップが有意義になるか、無駄になるかが決まる数回のやり取りです。ここにはclaude-opus-5を設定してください。トークン全体に占める割合が小さいため、より高性能なモデルを使っても絶対額のコストはわずかです。
• Actは長く、機械的です。各ステップでコンテキストを再送信しながら、多数の手順を実行します。ここではトークン単価が積み重なるため、より安価なSonnetを使うべきです。現在のKunavoではclaude-sonnet-5です。

具体的な数値は以下のコストセクションにあります。Opus 5で3ステップを計画し、Sonnet 5で17ステップを実行すると、オールSonnetの場合の$0.87に対して約$1.06です。これは計画品質が大幅に向上する一方で約23%増にとどまり、タスク全体をOpusで実行するよりはるかに安価です。

ネイティブ Anthropic ルート（および利用する理由）

Clineには、カスタムのベースURLフィールドを備えたネイティブのAnthropicプロバイダーもあります。これをKunavoに向けると、OpenAI互換エンドポイントではなく、ネイティブのMessages API（/v1/messages）が使われます。

API Provider   Anthropic
Base URL       https://api.kunavo.com   # origin only — the client appends /v1/messages
API Key        sk-kn-...
Model ID       claude-sonnet-5

2つの経路ではベースURLが異なることに注意してください。 OpenAI互換プロバイダーではhttps://api.kunavo.com/v1が必要です。Anthropicプロバイダーでは、クライアント自身が/v1/messagesを付加するため、末尾のないオリジンhttps://api.kunavo.comが必要です。/v1形式をAnthropicプロバイダーに貼り付けると、モデルが見つからないように見える404が発生します。

ネイティブ経路で得られるのはプロンプトキャッシュです。cache_controlは翻訳されずにそのまま通過し、キャッシュされた入力には入力料金の10%が課金されます（プロンプトキャッシュのドキュメントを参照）。各ステップで同じプレフィックスを再送信するループでは、これが利用できる最大の節約策であり、モデルを変更するよりも効果が大きくなります。どちらの経路も使えます。開始時はOpenAI互換の方が簡単で、後から設定を変更するだけで切り替えられます。

ただし、プロンプトキャッシュ自体にネイティブ経路は必要ありません。長いプロンプトでは、KunavoがOpenAI互換の経路上でキャッシュのブレークポイントを自ら設定します。設定先は、システムプロンプト、ツール定義、そして会話にアシスタントのターンが含まれていれば最後のメッセージで、エージェントのループでは最初のステップより後のすべてのステップがこれに当たります。Clineがその経路で設定したcache_controlは保持されます。ネイティブ経路では、リクエストはClineが送ったとおりに渡され、ブレークポイントは追加されないため、何がキャッシュされるかはClineが設定するブレークポイント次第です。

設定するClaudeモデル

モデルフィールドを1語変更するだけで切り替えられます。キー、プロバイダー設定、エンドポイントは同じです。Anthropicの公式料金との比較を含むモデル別の全料金はAnthropic Claude APIの料金表に、最新のカタログは料金ページに掲載されています。

Kunavo上のClineとAnthropicを直接呼び出す場合の比較

直接利用のほうが適している場合も含めた、率直な比較です。

その容量の行は記載どおりに読んでください。チームに保証されたクォータ、契約上のSLA、またはモデルベンダーとの調達関係が必要なら、直接利用してください。料金差はそのために支払うものです。Clineを使う個人開発者や小規模チームでは、通常、トレードオフは逆方向になります。

Clineセッションに実際にかかるコスト

エージェント型ツールは、各ステップでシステムプロンプト、タスク履歴、新しいファイルコンテキストを再送するよう設計されているため、トークンを大量に消費します。Kunavo料金での現実的な数字は次のとおりです。

実行可能な計算式：

# Kunavo Claude rates (USD per 1M tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
    "claude-opus-5":     (3.50, 17.50),
}

def step_cost(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# One Act-mode step: Cline resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, read the error, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# The same task planned on Opus 5, executed on Sonnet 5:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

請求額を抑える

1. 1つのタスクをいつまでも延長せず、新しいタスクを開始してください。 Clineは各ステップで会話全体を再送信するため、長時間実行するタスクではコストが二次関数的に増加します。新しいタスクなら、コンテキストも新しく小さくなります。これは、このリストで最も効果の大きい習慣です。
2. PlanとActをモデル間で分担してください。 上で説明したとおり、これは規律の問題ではなく、設定フィールドで決まります。
3. キャッシュにはネイティブ Anthropic ルートを使用してください。 入力単価の10%でのキャッシュ入力は、安定したプレフィックスを再送するループにおける最大の構造的節約です。
4. エディター専用の支出上限付きキーを用意してください。 ダッシュボードで別のキーを作成し、そのキーに月次支出上限を設定して、使用状況を確認してください。エージェントによる実際のコーディングを1週間行うことだけが、コストを正直に見積もる方法です。上限は各リクエストの前に確認され、暦月の開始時にリセットされます。また、キーは単独で無効化できるため、すべてをローテーションする代わりに、1回の操作でエディターを停止できます。
5. まだ2つのツールのどちらにするか迷っていますか？ ClineとClaude Codeの比較では機能一覧ではなく課金構造を比較しています。どちらも同じエンドポイントに対して実行できるため、選択はいつでも元に戻せます。

よくある質問