実行プログラムと拡張機能

Strataをコーディングエージェントにつなぐ:OpenAI・Anthropic・Codex API

StrataはlocalhostでOpenAI・Anthropic互換APIを提供し、コーディングツールのリクエストをローカルモデルへ渡します。

StrataはOpenAI Chat CompletionsとAnthropic Messagesに対応し、Strata 0.1.39以降はOpenAI Responses API1も提供します。既定では127.0.0.1:8080でリクエストを受け、Qwen3.8-Flash-Nextの回答を返します。同じPCのコーディングエージェントは対応するbase URLを使い、Codex CLI2は/v1/responses経由で接続できます。/healthと/v1/modelsを確認し、短いPOSTリクエストを実際に送ります。ネットワークへ公開するためにhostを0.0.0.0へ変更せず、loopbackで確認してください。

実行条件と要点
  • 既定のアドレスはhttp://127.0.0.1:8080で、Chat Completions・Anthropic Messages・Responses APIを別々のパスで提供します。
  • Responses APIはStrata 0.1.39から対応し、Codex CLIがこのエンドポイントを使用します。
  • まずlocalhostのhealth・モデル一覧を読み、短い実リクエストで応答を確認します。

StrataのローカルAPIが受け取るものと返すもの

StrataはローカルPCでQwen3.8-Flash-Nextを実行し、APIリクエストに回答を返すサーバーです。コーディングエージェントが送る会話メッセージとツール定義を入力とし、モデルのテキストや対応形式のツール呼び出し3を返します。エージェント自体をインストールするのではなく、利用中のクライアントでモデルサーバーのアドレスを設定します。

同じPCのクライアントからはhttp://127.0.0.1:8080を使います。Chat Completionsは/v1/chat/completions、Anthropic Messagesは/v1/messages、Responses APIは/v1/responsesです。既定のloopbackアドレスは他のPCから到達できないため、テストのためにサーバーをネットワークへ公開する必要はありません。

まずプロジェクトの導入ガイドに沿ってサーバーを起動し、コーディングツールが対応するAPI形式を選びます。Responses APIはStrata 0.1.39からの対応なので、それ以前の版ではChat Completions対応クライアントを使います。

黒いタワー型PCとモニター、その横に置かれたRAMモジュール
Strataはローカルサーバーからコーディングツールへモデルの回答を返します。

まずlocalhostでhealthとモデル一覧を確認する

サーバーウィンドウに準備完了が表示されたら、ターミナルでcurl http://127.0.0.1:8080/healthを実行します。状態が返ったらcurl http://127.0.0.1:8080/v1/modelsを実行して、読み込まれたモデルIDを確認します。APIキーを設定した場合は、両方のリクエストにAuthorization: Bearer <key>ヘッダーを付けます。

モデル一覧が空、または接続エラーになる場合は、Strataが起動中か、セットアップで別のポートを指定していないか確認します。別のプログラムが8080番を使用している場合は、Strataに設定したポートを各リクエストに使います。モデルが読み込まれていなければ、まずブラウザチャットから短い質問を送り、セットアップが完了しているか確認します。

机の上のグラフィックカード、RAMモジュール、NVMe SSD
まずlocalhostのhealthとモデル一覧が応答することを確認します。

Chat Completionsの実リクエストを送る

モデル一覧が返ったら、次のリクエストで短い質問を送ります。modelには/v1/modelsが返したIDを、会話内容はmessagesに指定します。成功すると、応答JSONのchoices[0].message.contentに回答が入ります。

Chat Completionsリクエスト
curl http://127.0.0.1:8080/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{"model":"strata","messages":[{"role":"user","content":"이 서버가 답하면 Strata 연결이 된 거예요."}],"max_tokens":128}'
`model`は`/v1/models`が返したIDに置き換えます。

クライアントに合わせてAPIアドレスとモデルIDを設定する

OpenAI互換クライアントではbase URLをhttp://127.0.0.1:8080/v1に設定します。Strataはリクエストのモデル名を処理しますが、クライアントが名前を検証する場合はモデル一覧のIDを使います。Claude CodeはAnthropic形式の/v1/messagesを使うため、ANTHROPIC_BASE_URL=http://127.0.0.1:8080を設定します。クライアントが認識するANTHROPIC_MODEL名も必要な場合がありますが、これはローカルの送信先へリクエストを向けるためのクライアント側設定です。

Codex CLIはStrata 0.1.39以降、Responses API(/v1/responses)を利用できます。このAPIはstatelessで、各リクエストに会話入力全体を含める必要があり、previous_response_idによるサーバー側の会話保存には対応しません。Responses APIに対応しない、または互換性が合わない場合は、Chat Completions対応の別クライアントを使います。

API応答は接続できたことを示します。コーディングエージェントがファイルを読んだり編集したり、コマンドを実行したりするには、クライアントが該当ツールを提供し、利用者が許可する必要があります。まず読み取り専用の操作や小さなテスト用リポジトリで、ツール呼び出しと結果を確認してください。

オープン型PC作業台に取り付けた2枚のグラフィックカード
クライアントが対応する形式に合わせてAPI経路を選びます。

用語の注釈

  1. API — 別のコードからプログラムの機能を呼び出すための決められたインターフェースです。

    本文に戻る
  2. CLI — Command-Line Interfaceの略です。ターミナルにコマンドを入力してプログラムを操作する方式です。

    本文に戻る
  3. ツール呼び出し — ファイル読み取り、検索、コマンド実行などの外部機能を、名前と引数でモデルが要求する形式です。実行の有無はエージェントランタイムと権限設定が決めます。

    本文に戻る

よくある質問

この記事で最初に確認すべきことは何ですか?
StrataはOpenAI Chat CompletionsとAnthropic Messagesに対応し、Strata 0.1.39以降はOpenAI Responses APIも提供します。既定では`127.0.0.1:8080`でリクエストを受け、Qwen3.8-Flash-Nextの回答を返します。同じPCのコーディングエージェントは対応するbase URLを使い、Codex CLIは`/v1/responses`経由で接続できます。`/health`と`/v1/models`を確認し、短いPOSTリクエストを実際に送ります。ネットワークへ公開するためにhostを`0.0.0.0`へ変更せず、loopbackで確認してください。