ガイド一覧 / コーディング支援
OpenCode で XHuoAPI を使う
OpenCode はオープンソースのコーディングエージェントで、ターミナル UI・デスクトップアプリ・IDE 拡張があり、OpenAI Chat Completions 互換のエンドポイントに接続できます。XHuoAPI はこのエンドポイントを提供しているので、設定ファイルに provider を 1 つ追加するだけで使えます。OpenCode 2.1.2 で実際にファイルを作成させており、以下はその検証で使った設定です。
はじめる前に
- コンソールで登録し、API トークンを作成します。登録に必要なのはメールアドレスだけで、電話番号は不要です。
- トークン作成時にティアを選びます。新規アカウントの既定は Standard です。ティアは価格と安定性、そして利用できるモデルを決めます。詳細は料金ページを参照してください。
まず確認
ツールを設定する前に、curl でキーとモデルが使えることを確認してください。「設定したのに反応がない」の半分はこれで切り分けられます。
curl https://api.xhuoapi.ai/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'
設定手順
OpenCode 2 をインストールします。OpenCode 1 と 2 はどちらも opencode コマンドを使うため同時にはインストールできません。1 の設定の書き方は異なります（下のヒント参照）。
npm install -g @opencode/cli opencode --version
API キーを環境変数に設定します。変数名は自由で、次の手順の env に同じ名前を書きます。
export XHUOAPI_API_KEY=YOUR_XHUOAPI_KEY
プロジェクトのディレクトリに opencode.jsonc を作り、以下の provider を書きます。package は OpenAI 互換のもの、baseURL は /v1 まで、models のキーは料金ページの表記どおりのモデル ID です。
{
"$schema": "https://opencode.ai/config.json",
"providers": {
"xhuoapi": {
"name": "XHuoAPI",
"env": ["XHUOAPI_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": { "baseURL": "https://api.xhuoapi.ai/v1" },
"models": {
"glm-5.3": { "name": "GLM-5.3" },
"deepseek-v4.1-flash-none": { "name": "DeepSeek V4.1 Flash" },
"qwen3.8-max": { "name": "Qwen3.8-Max" }
}
}
}
}
モデルは provider/モデル ID の形で指定します。プロジェクトのディレクトリで opencode を実行すると対話画面、opencode run で単発タスクを実行できます。
opencode run -m xhuoapi/glm-5.3 "Create hello.py that prints hello" opencode
注意点
よく使われるモデル
この種のツールでよく選ばれるモデルです。モデル名をクリックするとティア別の価格を確認できます。全一覧は料金ページにあります。
手順は各ツールの現行の公式ドキュメントに基づいています。アップデートで UI が変わることがあります。相違があればお知らせください。