OpenCode クラウドサーバー導入手順:常駐まで
2026-10-20 時点で、QCode のクラウドサーバーに OpenCode をインストールし、opencode serve で常駐させ、QCode のキーでモデルを呼び出せます。クラウドサーバーと AI サービスは別々に販売され、アカウントと残高だけを共有します。
更新日 2026-10-20
このツールを QCode エンドポイントに接続。Claude・GPT・中国系モデルを 1 キーで。
- トークン単位の課金・最新単価は /models
- カード(Visa / Mastercard / AMEX)・Apple Pay・Google Pay・暗号資産で支払い可能
- チャージ後すぐにセルフサービスで開通
導入の 4 ポイント
ヘッドレス HTTP サービス
公式サーバードキュメントによると、opencode serve は OpenAPI エンドポイントを公開するヘッドレス HTTP サーバーを起動します。既定のポートは 4096、既定の待ち受けアドレスは 127.0.0.1 です。
完全な root 権限
QCode のクラウドサーバーは KVM ホストで、独立したパブリック IPv4 と完全な root 権限が付きます。システムとデータは自分で管理します。
トライアル期間
トライアルは 1 日(24 時間)で、選んだ構成に応じて課金されます。期間中にパネルから 1、3、6、12 か月に切り替えられます。切り替えない場合、終了時にサーバーは削除され、データは保持されません。
注文時に選択
注文時に SSH 公開鍵を入力でき、「鍵ログインのみ(root パスワードログインを無効化)」も選べます。現在はウェブコンソールがなく、秘密鍵を失うとシステムの再インストールでしか再ログインできず、データは消去されます。
このサーバーでできること
QCode のクラウドサーバーで OpenCode を動かす手順は、root 権限付きの KVM ホストを注文し、OpenCode 公式のスクリプトでインストールし、QCode のエンドポイントを opencode.json に書き、tmux の中で opencode serve を実行する、というものです。QCode のクラウドサーバーは、単独で販売される海外のマシンで、独立したパブリック IPv4 が付きます。AI サービスとは別の製品で、アカウントと残高だけを共有します。QCode のドキュメントには香港、日本、韓国、米国、ドイツが記載され、各地域に 1 本以上の回線があります。
公式ページの説明
OpenCode の公式サーバードキュメント(opencode.ai/docs/server、OpenCode 1 のドキュメント)によると、opencode serve はヘッドレス HTTP サービスです。既定のポートは 4096、既定の待ち受けアドレスは 127.0.0.1 で、--hostname と --port で変更できます。OPENCODE_SERVER_PASSWORD を設定すると HTTP basic auth が有効になり、ユーザー名は既定で opencode です。QCode ドキュメントの OpenCode ページは ~/.config/opencode/opencode.json の QCode エンドポイントを掲載しています。
タイムライン
QCode の OpenCode 接続ページは 2026-10-20 に確認され、OpenCode 2 の節が追加されています。
OpenCode 2 の npm パッケージ @opencode/cli がバージョン 2.1.0 を公開しました。opencode.ai/docs は引き続き OpenCode 1 のドキュメントで、OpenCode 2 のドキュメントは opencode.ai/v2/docs にあります。
QCode のクラウドサーバーのドキュメントと Cloud ページは 2026-10-20 に確認しました。構成はオンラインでアップグレードでき、サーバーごとに最大 3 つのスナップショットがあり、注文ページでは SSH 公開鍵を任意で入力できます。
確認済み vs 未確認
確認済み(公式ページの記載と照合済み)
QCode のクラウドサーバー:単独で販売される海外のマシン、KVM、完全な root 権限、1 台につき独立したパブリック IPv4 が 1 つ(開通時に割り当てられ、変更できません)、香港・日本・韓国・米国・ドイツの回線、1 日(24 時間)の有料トライアル、トライアル中の 1、3、6、12 か月への切り替え、オンラインでの構成アップグレード、1 台につき最大 3 つのスナップショット。OpenCode の opencode serve はヘッドレス HTTP サービスで、既定は 127.0.0.1:4096 です。OPENCODE_SERVER_PASSWORD で basic auth を有効にでき、OpenCode 1 の公式インストールスクリプトは curl -fsSL https://opencode.ai/install です。
未確認と公式未発表
GitHub にユーザーの報告があります(#56668、2026-10-18 作成、報告バージョンは Desktop 2.0.32、2026-10-20 時点でも open)。デスクトップで新しいリモートサーバーを SSH で追加すると、最初の接続でリモートの OpenCode サーバーのダウンロードまたはアップロードに数分かかり、ダイアログには Connecting over SSH… とだけ表示されて固まったように見えるとのことです。これはユーザーの報告であり、公式の結論ではありません。
2 つの実行方法
opencode serve
別のクライアントやスクリプトから呼び出すためのヘッドレス HTTP サービスです。既定では 127.0.0.1 だけを待ち受けます。リモートから使うときは --hostname でアドレスを変え、OPENCODE_SERVER_PASSWORD で保護します。
ローカルの TUI
公式サーバードキュメントによると、opencode を実行すると TUI とサーバーが同時に起動し、TUI はサーバーに接続するクライアントです。opencode serve は単独のサーバーを起動できます。
導入手順
① QCode で注文します。地域、回線、構成、システム、期間を選び、トライアルなら 1 日を選びます。ネットワークの手順には独立したパブリック IPv4 が 1 つ必ず含まれます。root パスワードを設定する手順で、SSH 公開鍵を任意で入力できます。② 開通後、ssh root@サーバーのIP でログインします。root パスワードは注文時に設定したものです。③ OpenCode 公式インストールページの curl -fsSL https://opencode.ai/install | bash でインストールします。公式ページはこのスクリプトを OpenCode 1 のインストール方法として案内しており、QCode ドキュメントには、ページ上の provider / options.baseURL の設定は OpenCode 1 でも OpenCode 2 でも使えると書かれています。OpenCode 2 はインストールコマンドが異なり、既定のコマンドでは両者を併存できません(よくある質問の最後を参照)。④ ~/.config/opencode/opencode.json に QCode のエンドポイントを書き、opencode auth login でキーを保存します。⑤ tmux で常駐させます。tmux new -s opencode を実行し、OPENCODE_SERVER_PASSWORD=your-password opencode serve を起動し(既定では 127.0.0.1:4096 だけを待ち受けます)、Ctrl+B の後に D を押して切り離します。戻るときは tmux attach -t opencode を使います。
OpenCode を QCode に接続する
QCode ドキュメントの OpenCode 設定:設定ファイルは ~/.config/opencode/opencode.json で、Anthropic provider の baseURL に https://api.qcode.cc/claude/v1、OpenAI provider に https://api.qcode.cc/openai/v1 を設定します。キーは opencode auth login または /connect で書き込み、OpenCode 1 では ~/.local/share/opencode/auth.json に、OpenCode 2 では SQLite に保存され、旧 auth.json はインポートされます。利用前に API direct access 権限を有効にしてください。この権限は既定で無効で、オンラインサポートへの連絡または hi@qcode.cc へのメールで、購入した API キーに対して有効化してもらいます。課金はトークン単位で、モデルごとの単価は /models に記載されています。月額プランにまだ踏み切れない場合は、クォータパックが $4 からあります。7〜90 日以内に使い切る一度限りの枠です。個人プランをお使いで枠が足りないときはブースターパックを追加できます。
よくある質問
クラウドサーバーに OpenCode をインストールするには?
OpenCode 公式インストールページのスクリプトを使います。curl -fsSL https://opencode.ai/install | bash です。公式ページはこのスクリプトを OpenCode 1 のインストール方法として案内しています。OpenCode 2 はインストールコマンドが異なります。最後の質問を参照してください。
SSH を切断すると opencode serve は止まりますか?
フォアグラウンドで実行すると接続の終了とともに停止します。QCode ドキュメントは tmux でタスクを保持する方法を紹介しています(ドキュメントの例のセッション名は agent で、名前は自由に決められます。ここでは opencode を使います)。tmux new -s opencode でセッションを作り、opencode serve を実行し、Ctrl+B の後に D を押して切り離します。戻るときは tmux attach -t opencode を使います。tmux のセッションは、予期しない切断や切り離しの後も残ります。
OpenCode で QCode のキーを使ってモデルを呼ぶには?
QCode ドキュメントのとおり ~/.config/opencode/opencode.json を書きます。Anthropic provider の baseURL に https://api.qcode.cc/claude/v1、OpenAI provider に https://api.qcode.cc/openai/v1 を設定します。キーは opencode auth login または /connect で書き込み、OpenCode 1 では ~/.local/share/opencode/auth.json に、OpenCode 2 では SQLite に保存され、旧 auth.json はインポートされます。利用前に API direct access 権限を有効にしてください。
クラウドサーバーと一緒に AI プランも買う必要がありますか?
必要ありません。QCode ドキュメントは、クラウドサーバーと AI サービスが別々に販売され、アカウントと残高だけを共有すると説明しており、マシン上で Claude Code や Codex を動かすために AI プランを買う必要はないとしています。OpenCode から QCode のモデルを呼び出すには QCode のキーを使います。モデル側はトークン単位の課金で、モデルごとの単価は /models に記載されています。
クラウドサーバーの構成変更や回線の変更はできますか?
構成はオンラインでアップグレードできます。サーバーの Actions タブで大きいプランを選び、期限までの差額を支払います。すぐに反映され、サーバーは 1 回再起動し、期限日は変わりません。ダウングレードや地域・回線の変更はできません。別の回線が必要なら、もう 1 台注文します。トライアルのサーバーは先に月額プランへ切り替える必要があります。
サーバーには OpenCode 1 と OpenCode 2 のどちらを入れるべきですか?
どのドキュメントに従うかで決まります。opencode.ai/docs(server ページを含む)は OpenCode 1 のドキュメントで、curl -fsSL https://opencode.ai/install は OpenCode 1 をインストールします。OpenCode 2 のドキュメントは opencode.ai/v2/docs にあり、インストールスクリプトは curl -fsSL https://opencode.ai/v2/install | bash です。どちらも opencode コマンドを使い、既定のコマンドでは併存できません。OpenCode 2 の curl インストーラーは V1 のバイナリを置き換えます。QCode 向けの opencode.json の例は QCode の OpenCode 接続ページ(2026-10-20 確認)にあり、QCode ドキュメントによれば、その provider / options.baseURL の設定は OpenCode 1 でも OpenCode 2 でも使えます。
情報源
QCode のクラウドサーバードキュメント(2026-10-20 取得、地域、トライアル、アップグレード、スナップショット、SSH 公開鍵)、QCode の Cloud ページ(2026-10-20 取得)、QCode のクラウド課金ドキュメント(2026-10-20 取得)、QCode のクラウドサーバー Agent ドキュメント(2026-10-20 取得、tmux と画面言語)、OpenCode 公式 server とインストールのドキュメント(2026-10-20 取得)、QCode の OpenCode 接続ページとクォータパックページ(2026-10-20 取得)。
関連記事
Claude Code クォータパック:サブスク不要・7〜90日有効
枠を一度購入して 7〜90 日以内に使う方式で、サブスクではありません。追加購入分は同じキーに加算されます。
OpenCode セッション共有廃止(1.19.1)と 2.0 更新
セッション共有の廃止と OpenCode 2 への更新の説明です。
OpenCode 使い方 2026:OSS の AI Agent
OpenCode の概要、インストール、マルチエージェント、BYOK、QCode での接続方法。
暗号資産チャージガイド
9 通貨・56 ネットワーク、手数料 0 で AI コーディング API クレジットを購入。
このページのクラウドサーバーに関する事実は 2026-10-20 に qcode.cc/cloud と docs.qcode.cc で確認しました。OpenCode に関する事実は 2026-10-20 に公式インストールページと server ドキュメントで確認しました。モデルの可用性と単価は /models に従います。公式の変更は別途案内されません。