Claude APIを使ったKilo Code — OpenAI互換ベースURLの設定とモード別ルーティング

Kilo CodeはVS Codeで最も利用されているオープンソースAIコーディングエージェントの1つです。Clineファミリーの兄弟ツールと同様に、独自のOpenAI互換APIエンドポイントを持ち込めます。つまり、単一のsk-kn-キーでエディター内でClaudeを実行でき、主要モデルではAnthropicの表示価格より約30%安くなります。このガイドでは、3項目の設定、タスクごとに選ぶClaudeモデル、そしてエージェント型コーディングセッションの実際の費用を説明します。

Kilo CodeにAPIキーが必要な理由

Kilo Codeはモデルを同梱していません。ファイルの読み取り、編集の提案、コマンドの実行、結果の確認など、すべての操作がトークン単位で課金されるAPI呼び出しです。Claude Proのようなチャットサブスクリプションではこれをカバーできず、拡張機能には直接のAPIアクセスが必要です。Kunavoはまさにこの形で提供しています。$10のチャージから始める従量課金、ClaudeとGPTに使える1つのキー、そして有効期限のない残高です。エージェント型ループは各ステップで増加するタスクコンテキストを再送するため、トークン単価はセッション費用を左右する最大の要因です。そのため、claude-sonnet-5の約30%割引は急速に積み重なります。

3つの項目

Kilo Codeでは、プロバイダーが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

登録して$10をチャージした後、ダッシュボードからキーを取得します。キーは一度だけ表示されるため、すぐに保存してください。キー管理の全体についてはClaude APIキーのドキュメントで説明しています。

Kilo Codeのセットアップ

1. VS CodeマーケットプレイスからKilo Codeをインストールし、サイドバーから開きます。
2. 拡張機能の設定（歯車アイコン）を開き、Providersセクションへ移動します。
3. API ProviderをOpenAI Compatibleに設定します。
4. ベースURL：https://api.kunavo.com/v1 · APIキー：自分のsk-kn-…キー · モデル：claude-sonnet-5。
5. 保存したら、「このファイルを説明して」のような小さな依頼を行い、コードを編集させる前に接続を確認します。

Kilo Codeはモードごとのモデル上書き（Architect / Code / Debug）に対応しています。計画にはより強力なモデル（claude-opus-5）、実行にはより安価なモデル（claude-sonnet-5）を割り当てるのに適しています。

ClineとRoo Code

Kilo CodeとRoo CodeはいずれもClineファミリーのフォークであるため、上記3項目は3つのツールすべてで同一です。プロバイダーはOpenAI Compatible、ベースURLはhttps://api.kunavo.com/v1、キー、モデルIDです。異なるのは、各ツールがモデル振り分けのために提供する機能であり、コスト削減はそこにあります。そのため、それぞれに専用ガイドがあります。Claude APIでClineを使うではPlan/Actの分割を、Claude APIでRoo Codeを使うでは名前付き設定プロファイルとモードごとのモデル割り当てを説明しています。

3つのツールはいずれも、カスタムベースURLオプション付きのネイティブAnthropicプロバイダーを追加で搭載しています。これをhttps://api.kunavo.comに指定すると、代わりにネイティブのMessages API（/v1/messages）を使用します。これは、cache_controlが未翻訳のままパススルーされ、キャッシュされた入力には入力料金の10%が課金されるため便利です（プロンプトキャッシュのドキュメントを参照）。どちらの経路も機能しますが、最初はOpenAI互換のほうが簡単です。

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

選ぶべきClaudeモデル

ここではclaude-opus-5が高度な推論向けの選択肢です。Anthropicの最新Opusであり、前世代のclaude-opus-4-7（$3.50／$17.50）と同じ$3.50／$17.50で課金されます。固定して使っている場合は前世代モデルも引き続き利用できます。モデル項目は同じエンドポイント上の単なるスラッグなので、切り替えは1語を変更するだけです。新しいキーも、新しいプロバイダー設定も必要ありません。すべてのモデルの完全な料金はClaude API料金ガイドと料金ページに掲載されています。

セッションの実際の費用

エージェント型ツールは、各ステップでシステムプロンプト、タスク履歴、新しいファイルコンテキストを再送するよう設計されているため、トークンを大量に消費します。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),
}

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 agentic step: the tool resends the task context + file reads.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

請求額を抑える

1. 1つのタスクを永遠に延長せず、新しいタスクを開始する。 ツールは各ステップで会話全体を再送するため、長時間実行するタスクは二次関数的に高額になります。新しいタスク＝新しく小さなコンテキストです。
2. モードごとに振り分ける。 Kilo Codeではモードごとにモデルを設定できます。Architectはclaude-opus-5、Codeはclaude-sonnet-5、簡単な質問はclaude-haiku-4-5です。計画が占めるトークンは少ないため、そこに強力なモデルを使っても費用はわずかです。
3. キャッシュにはネイティブAnthropic経路を使う。 キャッシュされた入力には入力料金の10%が課金されます。各ステップで安定したプレフィックスを再送するループでは、これが利用可能な最大の節約になります（仕組み）。
4. キーごとの支出を確認する。 エディター専用のキーにダッシュボードで支出上限を設定し、使用量を確認して、エージェント型コーディングに1週間で実際いくらかかるかを把握します。

よくある質問