コンテンツにスキップ
OpenCode
app.header.homeapp.header.docs

サーバー

HTTP 経由で OpenCode サーバーと通信します。

opencode serve コマンドは、OpenCode クライアントが使用できる OpenAPI エンドポイントを公開するヘッドレス HTTP サーバーを実行します。

使用法

Terminal window
opencode serve [--port <number>] [--hostname <string>] [--cors <origin>]

オプション

フラグ説明デフォルト
--portリッスンするポート4096
--hostnameリッスンするホスト名127.0.0.1
--mdnsmDNS 検出を有効にするfalse
--mdns-domainmDNS サービスのカスタムドメイン名opencode.local
--cors許可する追加のブラウザーオリジン[]

--cors は複数回渡すことができます。

Terminal window
opencode serve --cors http://localhost:5173 --cors https://app.example.com

認証

HTTP 基本認証でサーバーを保護するには、OPENCODE_SERVER_PASSWORD を設定します。ユーザー名はデフォルトで opencode になるか、OPENCODE_SERVER_USERNAME を設定してオーバーライドします。これは、opencode serve と opencode web の両方に当てはまります。

Terminal window
OPENCODE_SERVER_PASSWORD=your-password opencode serve

仕組み

opencode を実行すると、TUI とサーバーが起動します。 TUI はサーバーと通信するクライアントです。サーバーは OpenAPI 3.1 仕様のエンドポイントを公開します。このエンドポイントは、SDK を使用してアクセスできます。

opencode serve を実行してスタンドアロンサーバーを起動できます。すでに OpenCode TUI を実行している場合でも、opencode serve は新しいサーバーを起動します。

既存のサーバーに接続する

TUI を起動すると、ポートとホスト名がランダムに割り当てられます。代わりに、--hostname と --port フラグ を使用して固定できます。次に、これを使用してサーバーに接続します。

/tui エンドポイントは、サーバー経由で TUI を駆動するために使用できます。たとえば、プロンプトを事前入力したり、実行したりできます。この設定は、OpenCode IDE プラグインによって使用されます。

仕様

サーバーは、次の場所で閲覧できる OpenAPI 3.1 仕様を公開しています。

http://<hostname>:<port>/doc

たとえば、http://localhost:4096/doc。この仕様を使用して、クライアントを生成したり、要求と応答のタイプを検査したりできます。または、Swagger エクスプローラーで表示します。

API

OpenCode サーバーは次の API を公開します。

Global

メソッドパス説明レスポンス
GET/global/healthサーバーの健全性とバージョンを取得する{ healthy: true, version: string }
GET/global/eventグローバルイベントの取得 (SSE ストリーム)イベントストリーム

Project

メソッドパス説明レスポンス
GET/projectすべてのプロジェクトをリストするProject[]
GET/project/current現在のプロジェクトを取得Project

Path and VCS

メソッドパス説明レスポンス
GET/path現在のパスを取得するPath
GET/vcs現在のプロジェクトの VCS 情報を取得するVcsInfo

Instance

メソッドパス説明レスポンス
POST/instance/dispose現在のインスタンスを破棄するvoid

Config

メソッドパス説明レスポンス
GET/config設定情報を取得するConfig
PATCH/config設定を更新するConfig
GET/config/providersプロバイダーとデフォルトのモデルをリストする{ providers: Provider[], default: { [key: string]: string } }

プロバイダー

メソッドパス説明レスポンス
GET/providerすべてのプロバイダーをリストする{ all: Provider[], default: {...}, connected: string[] }
GET/provider/authプロバイダーの認証方法を取得する{ [providerID: string]: ProviderAuthMethod[] }
POST/provider/{id}/oauth/authorizeOAuth を使用してプロバイダーを認証するProviderAuthAuthorization
POST/provider/{id}/oauth/callbackプロバイダーの OAuth コールバックを処理するvoid

Session

メソッドパス説明詳細
GET/sessionすべてのセッションをリストする戻り値 Session[]
POST/session新しいセッションを作成する本文: { parentID?, title? }、Session を返します。
GET/session/statusすべてのセッションのセッションステータスを取得する戻り値 { [sessionID: string]: SessionStatus }
GET/session/:idセッションの詳細を取得する戻り値 Session
DELETE/session/:idセッションとそのすべてのデータを削除する戻り値 boolean
PATCH/session/:idセッションのプロパティを更新する本文: { title? }、Session を返します。
GET/session/:id/childrenセッションの子セッションを取得する戻り値 Session[]
GET/session/:id/todoセッションの ToDo リストを取得する戻り値 Todo[]
POST/session/:id/initアプリを分析して AGENTS.md を作成する本文: { messageID, providerID, modelID }、boolean を返します。
POST/session/:id/forkメッセージで既存のセッションをフォークする本文: { messageID? }、Session を返します。
POST/session/:id/abort実行中のセッションを中止する戻り値 boolean
POST/session/:id/shareセッションを共有する戻り値 Session
DELETE/session/:id/shareセッションの共有を解除する戻り値 Session
GET/session/:id/diffこのセッションの差分を取得するクエリ: messageID?、FileDiff[] を返します。
POST/session/:id/summarizeセッションを要約する本文: { providerID, modelID }、boolean を返します。
POST/session/:id/revertメッセージを元に戻す本文: { messageID, partID? }、boolean を返します。
POST/session/:id/unrevert元に戻したすべてのメッセージを復元する戻り値 boolean
POST/session/:id/permissions/:permissionID許可リクエストに応答する本文: { response, remember? }、boolean を返します。

Message

メソッドパス説明詳細
GET/session/:id/messageセッション内のメッセージをリストするクエリ: limit?、{ info: Message, parts: Part[]}[] を返します。
POST/session/:id/messageメッセージを送信して応答を待ちます本文: { messageID?, model?, agent?, noReply?, system?, tools?, parts }、{ info: Message, parts: Part[]} を返します
GET/session/:id/message/:messageIDメッセージの詳細を取得する戻り値 { info: Message, parts: Part[]}
POST/session/:id/prompt_asyncメッセージを非同期に送信する (待機なし)body: /session/:id/message と同じ、204 No Content を返します。
POST/session/:id/commandスラッシュコマンドを実行します本文: { messageID?, agent?, model?, command, arguments }、{ info: Message, parts: Part[]} を返します
POST/session/:id/shellシェルコマンドを実行する本文: { agent, model?, command }、{ info: Message, parts: Part[]} を返します

Command

メソッドパス説明レスポンス
GET/commandすべてのコマンドをリストするCommand[]

File

メソッドパス説明レスポンス
GET/find?pattern=<pat>ファイル内のテキストを検索path、lines、line_number、absolute_offset、submatches と一致するオブジェクトの配列
GET/find/file?query=<q>ファイルとディレクトリを名前で検索するstring[] (パス)
GET/find/symbol?query=<q>ワークスペースのシンボルを検索するSymbol[]
GET/file?path=<path>ファイルとディレクトリをリストするFileNode[]
GET/file/content?path=<p>ファイルを読むFileContent
GET/file/status追跡されたファイルのステータスを取得するFile[]

/find/file クエリパラメータ

  • query (必須) — 検索文字列 (あいまい一致)
  • type (オプション) — 結果を "file" または "directory" に制限します
  • directory (オプション) — 検索用のプロジェクトルートをオーバーライドします。
  • limit (オプション) — 最大結果 (1 ～ 200)
  • dirs (オプション) — 従来のフラグ ("false" はファイルのみを返します)

Tool (Experimental)

メソッドパス説明レスポンス
GET/experimental/tool/idsすべてのツール ID をリストするToolIDs
GET/experimental/tool?provider=<p>&model=<m>モデルの JSON スキーマを含むツールをリストするToolList

LSP, Formatter, MCP

メソッドパス説明レスポンス
GET/lspLSP サーバーのステータスを取得LSPStatus[]
GET/formatterフォーマッタのステータスを取得するFormatterStatus[]
GET/mcpMCP サーバーのステータスを取得する{ [name: string]: MCPStatus }
POST/mcpMCP サーバーを動的に追加する本文: { name, config }、MCP ステータスオブジェクトを返します。

Agent

メソッドパス説明レスポンス
GET/agent利用可能なすべてのエージェントをリストするAgent[]

Logging

メソッドパス説明レスポンス
POST/logログエントリを書き込みます。本体:{ service, level, message, extra? }void

TUI

メソッドパス説明レスポンス
POST/tui/append-promptプロンプトにテキストを追加しますvoid
POST/tui/open-helpヘルプダイアログを開くvoid
POST/tui/open-sessionsセッションセレクターを開くvoid
POST/tui/open-themesテーマセレクターを開くvoid
POST/tui/open-modelsモデルセレクターを開くvoid
POST/tui/submit-prompt現在のプロンプトを送信しますvoid
POST/tui/clear-promptプロンプトをクリアvoid
POST/tui/execute-commandコマンドを実行する ({ command })void
POST/tui/show-toastトーストを表示 ({ title?, message, variant })void
GET/tui/control/next次の制御リクエストを待ちます制御リクエストオブジェクト
POST/tui/control/response制御リクエストに応答する ({ body })void

Auth

メソッドパス説明レスポンス
PUT/auth/:id認証資格情報を設定します。本文はプロバイダーのスキーマと一致する必要がありますvoid

Event

メソッドパス説明レスポンス
GET/eventサーバー送信イベントストリーム。最初のイベントは server.connected、次にバスイベントサーバー送信イベントストリーム

Documentation

メソッドパス説明レスポンス
GET/docOpenAPI 3.1 仕様OpenAPI 仕様を備えた HTML ページ