JA ▾

Claude CodeのOpenAI代替:コーディングエージェントのセットアップ

Claude CodeはAnthropic独自のAPIと通信するため、OpenAIスタイルのエンドポイントに単純に接続することはできません。代わりに有効なのは、カスタムOpenAI Base URLを受け付けるコーディングエージェントであり、それらをこのAPIに接続する方法です。

更新

APIサーバーのキューブに光るケーブルで接続されたターミナルウィンドウ。カスタムエンドポイントを使用するコーディングエージェントを示すイラスト

主なポイント

  • Claude CodeはAnthropicのAPIフォーマットを基盤としていますが、本サービスはOpenAIのチャット完了フォーマットを使用しています。
  • Aider、Continue、Cline、Cursorスタイルのツールは、カスタムOpenAI互換のBase URLとモデル名を受け付けます。
  • Base URL https://api.minimaxapikey.com/v1、モデルID uncensored、Bearerキーを使用してください。
  • まずcurlでテストし、エージェントが一度に多数の呼び出しを行うため、同時実行数を8リクエスト以下に保ってください。

短い答え

Claude CodeのOpenAI代替を検索したなら、まず置き換えたい対象を決めましょう。Claude CodeはAnthropicのターミナルコーディングエージェントです。Anthropic独自のAPI(OpenAIとは異なるリクエスト形式)をターゲットに設計されています。本サービスはOpenAIチャット完了フォーマットを実装しているため、URLを変更するだけでは互換しません。

有効なのは、任意のOpenAI互換エンドポイントを受け付けるコーディングエージェントやエディタープラグインの大きなファミリーです。Base URL、キー、モデル名を指定すると、通常のPOST /v1/chat/completionsリクエストが送信されます。Aider、Continue、Clineはこのグループに属し、いくつかのエディターはOpenAIモデル用のBase URL上書き機能を持っています。このAPIの場合、3つの値はBase URL https://api.minimaxapikey.com/v1、モデルID uncensored、そしてBearerトークンとしてのキーです。

期待値を現実的に保ってください。エンドポイントの背後にあるモデルは、独立したプロバイダーが提供する1つのオープンウェイトモデルで、法的な成人用途に対してコンテンツ拒否なしで回答するようにチューニングされています。Claudeではなく、いかなるモデルベンダーの公式APIでもありません。リポジトリに適しているかどうかは、ご自身のタスクで確認する必要があります。この記事では、そのテストを低コストで実行する方法を示します。

Claude CodeでURLを単純に変更できない理由

APIフォーマットはアドレス以上のものです。AnthropicのAPIには独自のメッセージ構造、システムプロンプトの表現方法、ツール使用ブロック、ストリーミングイベントがあります。OpenAIスタイルのサーバーは、ロールを持つmessages、関数定義のtools配列、およびchoices[0].deltaを運ぶサーバー送信イベントを期待します。1つのフォーマット向けに構築されたクライアントは、URLが到達可能であっても、他のフォーマットのサーバーに対しては失敗したり誤動作したりします。

一部の人は2つの間に翻訳レイヤー、つまりリクエストとレスポンスを書き換える小さなプロキシを配置します。これは機能しますが、実行してデバッグするのは別のソフトウェアであり、ツール呼び出しやストリーミングの周辺でそのようなレイヤーが破綻しがちです。Claude Codeがサードパーティエンドポイントの公式設定を提供しているかどうかは、Anthropicの最新ドキュメントで確認する必要があります。これらのオプションは変更されるためです。

より簡単な方法は、すでにOpenAIフォーマットに対応したエージェントを選択することです。基本的なループにおいて何も失われません:エージェントはファイルを読み取り、プロンプトを構築し、モデルに編集を依頼し、それを適用します。モデルは置き換える部分であり、その部分には互換性のあるエンドポイントが必要です。

ツールに触れる前にcurlでエンドポイントをテストする

生APIが動作していることが分かれば、統合問題の診断は容易です。APIキーページでキーを作成し、エクスポートしてリクエストを1回実行してください。成功すれば、その後の失敗はキーやネットワークの問題ではなく、ツールの設定に起因します。

export UNCENSORED_KEY="paste-your-key-here"

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise coding assistant."},
      {"role": "user", "content": "Write a Python function that parses an ISO date string."}
    ]
  }'

GET /v1/modelsでモデル一覧も取得できます。多くのツールはプロバイダー保存時にキーの有効性を確認するためにこのエンドポイントを呼び出すため、設定前に動作確認をしておく価値があります。完全なリクエストリファレンスはドキュメントページをご覧ください。

各ツールがBase URLを入力する場所

設定の名前は異なりますが、考え方はどこでも同じです。表は一般的なコーディングツールと入力するフィールドをリストしています。メニューはバージョン間で移動するため、これをマップとして扱い、現在のレイアウトについては各ツールのドキュメントを確認してください。

ツールエンドポイントを入力する場所使用するモデル名
AiderOpenAI Base URLとキー用の環境変数またはコマンドラインフラグopenai/uncensored
Continueプロバイダーがopenaiで、apiBaseを持つ設定ファイル内のモデルエントリuncensored
Clineプロバイダーリスト、OpenAI互換オプションを選択uncensored
Cursorモデル設定、Base URL上書き機能付きOpenAI APIキーセクションカスタムモデルとしてuncensored
独自のスクリプト任意のOpenAI SDKのbase_url引数uncensored

このサービスはちょうど1つのモデルのみを公開するため、モデルピッカーを設定する必要はありません。ツールがモデル名を必要とする wherever、uncensoredと入力してください。ツールが既知のモデルのリストを要求し、不明な名前を拒否する場合は、「カスタムモデル」または「モデルの追加」オプションを探してください。

Aiderの例

Aiderはターミナルで実行され、gitリポジトリ内のファイルを編集して結果をコミットするため、精神的にはClaude Codeに最も近いです。内部ではLiteLLMを使用しているため、モデル名にはプロバイダープレフィックスが付きます。OpenAI互換サーバーの場合、このプレフィックスはopenai/です。

pip install aider-chat

export OPENAI_API_BASE="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"

cd your-repo
aider --model openai/uncensored

起動したら、単一ファイルの小さな変更を依頼し、diffを確認してください。複数ファイルのタスクを渡す前に、ドキュメントストリングの追加や関数の名前変更など、数秒で検証できることから始めてください。Aiderはターンごとにリポジトリマップとチャットに追加したファイルを送信するため、プロンプトがすぐに大きくなります。100,000トークンのウィンドウ(プロンプトと完了の合計)は寛大ですが、大きなリポジトリでは関連するファイルのみを追加する必要があります。

Aiderがモデルのコンテキストサイズや価格を認識していないと警告する場合、それは予想される動作です:カスタムモデル名のエントリがないためです。この警告は動作を妨げません。

Continueの例

ContinueはVS CodeやJetBrains内でチャット、編集、オートコンプリート機能を追加するエディター拡張機能です。その設定はモデルをリストし、それぞれにプロバイダーとオプションの上書きが含まれています。このAPI用のモデルエントリは以下のようになります。ファイル名とスキーマはインストールされているContinueのバージョンに依存するため、現在のドキュメントと比較してください。

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.minimaxapikey.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

チャットと編集リクエストはこの種のエンドポイントでよく機能します。タブオートコンプリートは異なるワークロードです:入力のほぼすべての一時停止で起動し、非常に低いレイテンシーを必要とし、これは小さなローカルモデルによってより良く提供されます。ホストされたチャットモデルをインライン補完に使用すると、1分あたりの制限である300リクエストに対して多くのリクエストを消費し、ほとんど成果が得られません。

最小限のエージェントを自分で構築する

既存のツールが合わない場合、ツール呼び出しサポートにより小型エージェントの作成が容易になります。APIはtoolsとtool_choiceを受け取り、tool_callsをストリーミングで返し、結果はrole: "tool"付きのメッセージとして受け取ります。以下のループは、ファイルを読み取る関数を1つモデルに渡し、モデルがプレーンテキストで応答するまで処理を続行します。

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="paste-your-key-here")

tools = [{
    "type": "function",
    "function": {
        "name": "read_file",
        "description": "Return the text of a file in the current project.",
        "parameters": {
            "type": "object",
            "properties": {"path": {"type": "string"}},
            "required": ["path"],
        },
    },
}]

messages = [{"role": "user", "content": "Summarise what main.py does."}]

while True:
    resp = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
    msg = resp.choices[0].message
    messages.append(msg)
    if not msg.tool_calls:
        print(msg.content)
        break
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        with open(args["path"], encoding="utf-8") as f:
            result = f.read()
        messages.append({"role": "tool", "tool_call_id": call.id, "content": result})

書き込み関数と実行前の確認プロンプトを追加すると、約50行でコーディングエージェントのコアが完成します。読み書きする前に常にパスを検証してください:モデルは好きなパスを要求する可能性があります。

計画すべき制限とコスト

エージェントはチャットする人間とは異なります。バースト状のリクエストを送信し、しばしば並列で実行します。フルキーは最大8つの同時リクエストと1分あたり300リクエストまで許可します。トライアルキーは同時2、1分あたり60までで、エージェントには厳しい場合があります。制限超過時はHTTP 429とエラーコードrate_limitedまたはconcurrencyが返されます。一時的な過負荷時にはRetry-After: 5付きの429も返されます。多くのクライアントは429でリトライしますが、もしクライアントがリトライしない場合は並列設定を下げてください。ストリーミングリクエストはストリーム終了まで同時実行スロットを保持するため、長時間のストリーミング編集は8の制限にカウントされます。

コスト面では、前払いクレジットから従量課金で課金され、入力トークン100万トークンあたり$0.15、出力トークン100万トークンあたり$0.50です。例えば、1つのセッションで30,000入力トークンを含むリクエスト40回を送信し、それぞれ1,000出力トークンを受信した場合を考えます。これは入力トークン1,200,000($0.18)と出力トークン40,000($0.02)で、合計$0.20になります。失敗または拒否されたリクエストには課金されず、クレジットは期限切れになりません。チャージ額とボーナスについては、料金ページをご覧ください。

新規アカウントは、キーページでワンクリックで$0.50のトライアルクレジットを請求できます。カードは不要で、7日間有効です。これはcurlテストと数回の小さなAider編集を実行するのに十分です。プロンプトはトレーニングに使用されません。

質問と回答

Claude Code 自体をこの API に接続できますか?

直接的にはできません。Claude Code は Anthropic の API 形式向けに構築されており、本サービスは OpenAI 互換のチャット完了エンドポイントを実装しています。Claude Code がサポートする機能については Anthropic の最新ドキュメントをご確認ください。このエンドポイントを使用するには、OpenAI 互換のエージェントを使用してください。

カスタム OpenAI 用 Base URL で動作するコーディングツールはありますか?

Aider、Continue、Cline はいずれも、OpenAI 互換の Base URL、API キー、モデル名を入力できます。Cursor も OpenAI 互換モデル用の Base URL 上書き機能を提供していますが、最新の設定とプランの制限をご確認ください。

API はエージェント用の関数呼び出しをサポートしていますか?

はい。ツールと tool_choice を送信し、streaming された tool_calls を受信し、role: tool で結果を返すことができます。特定のエディタープラグインがこれらのフィールドを使用するかどうかは、プラグイン次第です。

コーディングセッションの料金はどのくらいですか?

料金は入力トークン100万トークンあたり$0.15、出力トークン100万トークンあたり$0.50です。エージェントは大量のコンテキストを再送信するため、請求額の入力トークンが支配的になります。

キーはフォーム 1 つで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。

API キーを取得