OpenCode 2.1.4 設定

OpenCode 2.1.4 で QCode.cc に接続。opencode.json で anthropic と openai の baseURL を設定します。

最終更新 2026-10-26

最終確認：2026-10-26 · 📄 公式ドキュメント準拠（OpenCode 2 v2.1.4、2026-10-23 公開；OpenCode 1 の最新は v1.19.4、2026-10-22 公開（リポジトリは anomalyco/opencode）。本ページは 2026-10-20 時点で v2.1.0 と v1.19.3 を確認していました）

概要¶

項目	内容
利用できるモデル	Claude ✅（anthropic provider）· GPT ✅ · 中国系モデル ⚠️（内蔵の openai provider は非対応。別途 `@ai-sdk/openai-compatible` provider を作成）· Gemini ❌（QCode は現在 Gemini を提供していません）
プロトコルと Base URL	Anthropic：`https://api.qcode.cc/claude/v1` · OpenAI：`https://api.qcode.cc/openai/v1`（各 provider の `options.baseURL`）
設定場所	`~/.config/opencode/opencode.json`。キーは `opencode auth login` で `auth.json` に保存
公式ドキュメント	opencode.ai/docs

⚠️ 重要：API 直接アクセス権限が必要です

OpenCode を使用するには、API 直接アクセス権限を有効にする必要があります。直接 API 呼び出しには Claude Code のセッション機構がないため、トークン消費が大きくなります。そのため、この権限はデフォルトで無効になっています。

有効にするには、オンラインサポートに連絡するか、hi@qcode.cc にメールしてください。ご購入済みの API Key にこの権限を有効化いたします。

OpenCode は、Claude Code に似た 100% オープンソースのターミナル AI コーディングアシスタントで、特定の AI プロバイダーに縛られません。QCode に接続するには、~/.config/opencode/opencode.json で Anthropic と OpenAI の baseURL を設定し、/connect で API Key を入力してから再起動します。本ページでは、設定ファイルの全文、マルチエージェント構成、確認方法を説明します。

プロジェクト紹介¶

OpenCode¶

OpenCode は SST チームが開発したオープンソース AI コーディングエージェントです。主な特徴：

100% オープンソース - MIT ライセンス、完全に透明
マルチモデル対応 - Claude、OpenAI など複数のモデルを同時に使用可能
ネイティブ LSP サポート - インテリジェントなコード分析のための組み込み言語サーバープロトコル
TUI ファースト - Neovim ユーザーによる、ターミナルユーザーのための設計
クライアント/サーバーアーキテクチャ - ローカルでサーバーを実行し、モバイルデバイスからリモート制御可能
2つの組み込みエージェント - build（デフォルト、フルアクセス）と plan（読み取り専用、分析・計画用）

OpenCode 2（2026-10-20）：OpenCode 2 は lsp 設定を受け取り保持しますが、言語サーバーを実行せず、LSP ツールを提供せず、LSP 診断も出力しません（公式ドキュメント）。

プロジェクト統計（2026-10-20 時点）：

GitHub Stars: 218,397（2026-10-20 時点。2026-10-15 時点は 213k+）
Repository: anomalyco/opencode (formerly sst/opencode; old URL redirects)
Version: OpenCode 2 v2.1.4（2026-10-23）、OpenCode 1 の最新は v1.19.4（2026-10-22）。以前記載した v2.1.0（2026-10-20）、v1.19.3（2026-10-16）、v1.19.0（2026-10-11）は現在では過去のリリースです。

oh-my-opencode¶

oh-my-opencode は、第三者が開発した OpenCode の拡張プラグインで、コミュニティでは「OpenCode のステロイド版」と呼ばれています。ご注意いただきたいのは、2026-10-15 時点でリポジトリが code-yeongyu/oh-my-openagent に改名され、README ではプロジェクト名が OmO になり、独立した omo コマンドが主な入口になっていることです。従来の OpenCode 版は README で「OpenCode edition」と呼ばれ、omo setup で移行できます（Migrating from OpenCode のガイド参照）。ultrawork キーワードも README に引き続き記載されています。

形態が変わったため、本ページでは旧版の組み込みエージェント役割表や、bunx oh-my-opencode install のような旧インストールコマンドは掲載しません。必要な場合は公式 README に従ってください：code-yeongyu/oh-my-openagent。以下の OpenCode の設定はこれに依存しません。

2026-10-20 時点で、README はプロジェクトを OmO 5.0 と表記し、インストールコマンドとして curl -fsSL https://get.omo.dev/install.sh | bash を案内しています。また、OmO はこのプロジェクトによる pi のフォークである senpi 上で動作すると記載しています。

インストールと設定¶

ステップ 1：OpenCode のインストール¶

OpenCode は非常に速いペースで更新されています。公式のインストールガイドを参照してください：

公式ドキュメント：https://opencode.ai/docs

一般的なインストール方法：

# curl でインストール（推奨）
curl -fsSL https://opencode.ai/install | bash

# パッケージマネージャーを使用
npm install -g opencode-ai  # または bun/pnpm/yarn

# macOS Homebrew
brew install anomalyco/tap/opencode

2026-10-20 時点で、このスクリプトは OpenCode 1 のみをインストールします。OpenCode 2 は別のインストールコマンドを使用します。下の OpenCode 2 を参照してください。

ステップ 2：oh-my-opencode（任意）¶

oh-my-opencode は必須ではありません。使いたい場合は、上のリンク先の公式 README に従ってインストールしてください。以下の OpenCode の設定はこれに依存しません。

ステップ 3：QCode API の設定¶

これが重要なステップです！設定ファイル ~/.config/opencode/opencode.json を作成または編集します：

モデル選択について：以下の設定では、QCode の Claude 5.5 系と GPT 系を使います。日常のデフォルトは claude-sonnet-5-5 / claude-opus-5-5、軽いタスクには claude-haiku-5-5、GPT は gpt-6.1-sol / gpt-6-sol / gpt-5.6-terra を使います。呼び出せるモデルは qcode.cc/models を参照してください。QCode は現在 Gemini も Grok も提供していないため、設定には anthropic と openai の 2 つの provider だけを置いています。中国系モデルの id は国産モデルの接続を参照。

baseURL について：OpenCode 公式ドキュメントの Anthropic の baseURL の例は /v1 まで書かれている（https://api.anthropic.com/v1）ので、ここでも同様に /v1 まで書きます。Anthropic は https://api.qcode.cc/claude/v1、OpenAI は https://api.qcode.cc/openai/v1 で、エンドポイントと API パスのパスと一致します。

中国系モデルについて：OpenCode の内蔵 openai provider（@ai-sdk/openai）は Responses インターフェースを使い、QCode の Responses インターフェースは中国系モデルに対応していません。中国系モデルは別途 @ai-sdk/openai-compatible provider（chat/completions、baseURL は https://api.qcode.cc/openai/v1）を作成してください。モデル id は国産モデルの接続を参照。OpenCode 公式の providers ドキュメントには、/v1/responses なら @ai-sdk/openai、/v1/chat/completions なら @ai-sdk/openai-compatible を使うと書かれています。

{
  "$schema": "https://opencode.ai/config.json",

  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.qcode.cc/claude/v1"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://api.qcode.cc/openai/v1"
      }
    }
  },

  "model": "anthropic/claude-opus-5-5",
  "small_model": "anthropic/claude-haiku-5-5",
  "default_agent": "build",

  "permission": {
    "read": "allow",
    "list": "allow",
    "glob": "allow",
    "grep": "allow",
    "lsp": "allow",

    "edit": "ask",
    "bash": "ask",
    "webfetch": "ask",
    "websearch": "ask",

    "external_directory": "deny",
    "doom_loop": "ask"
  },

  "agent": {
    "plan": {
      "mode": "primary",
      "description": "計画/分解/技術設計（読み取り専用、コードの誤変更を防止）",
      "model": "anthropic/claude-opus-5-5",
      "prompt": "あなたはシニア技術リーダーです。目標：要件を実行可能なステップに分解する（受け入れ基準/リスク/ロールバックを含む）。デフォルトで読み取り専用、ファイルの変更やコマンドの実行はしない；実行が本当に必要な場合は、理由を説明し build/codex への切り替えを提案してください。",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "build": {
      "mode": "primary",
      "description": "メイン開発（エンドツーエンド実装/デバッグ/テスト修正）- Claude Opus 5.5",
      "model": "anthropic/claude-opus-5-5",
      "prompt": "あなたはメインのソフトウェアエンジニアリングエージェントです。優先事項：最小限の実行可能な変更、可読性、テスト可能性。変更前に簡単にアプローチを説明；変更後は必ず提供：主要な diff ポイント、ローカルでの検証方法（コマンド）、潜在的なエッジケース。",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "allow",
        "bash": "allow",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "ask"
      }
    },

    "codex": {
      "mode": "primary",
      "description": "リファクタリング/移行/大規模変更（Codex）- GPT-6.1 Sol",
      "model": "openai/gpt-6.1-sol",
      "prompt": "あなたは Codex スタイルのエンジニアリングエージェントで、大規模リファクタリング、移行、コードレビュー、複雑なツールチェーン連携に長けています。優先事項：プロジェクトを実行可能に保つ：ステップバイステップのコミット、各ステップが検証可能；不確かな場合は、まずセーフガードとテストを追加。",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "allow",
        "bash": "allow",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "ask"
      }
    },

    "review": {
      "mode": "subagent",
      "description": "コードレビュー/セカンドブレイン（読み取り専用）- GPT-5.6 Terra",
      "model": "openai/gpt-5.6-terra",
      "prompt": "あなたは厳格なコードレビュアーです。出力：1) 主要なリスク（バグ/セキュリティ/並行性/エッジケース）2) 保守性の提案 3) 最小限の修正提案（疑似 diff 可）4) 必要なテストポイント。デフォルトで読み取り専用、ファイルの変更/コマンドの実行はしない。",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "explore": {
      "mode": "subagent",
      "description": "クイックコードスキャン/ファイル特定/コンテキスト要約（読み取り専用）- Claude Haiku 5.5",
      "model": "anthropic/claude-haiku-5-5",
      "prompt": "あなたはクイック探索サブエージェントです：最小限のステップで関連ファイル/関数/コールチェーンを特定し、明確なパスと要約を提供。デフォルトで読み取り専用、ファイルの変更/コマンドの実行はしない。",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "general": {
      "mode": "subagent",
      "description": "一般的な調査/ドキュメント/アプローチ比較（中コスト）- Claude Sonnet 5.5",
      "model": "anthropic/claude-sonnet-5-5",
      "prompt": "あなたは一般的な分析サブエージェントです：説明、トレードオフ、ドキュメント、アプローチ比較に重点を置く；デフォルトで読み取り専用、コードの変更は極力しない。",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "think": {
      "mode": "subagent",
      "description": "思考支援/エッジケース推論（読み取り専用）- GPT-6.1 Sol",
      "model": "openai/gpt-6.1-sol",
      "prompt": "あなたは推論とエッジケース分析のサブエージェントです：設計、例外パス、並行性/一貫性、パフォーマンスボトルネックについて構造化された分析と提案を提供。デフォルトで読み取り専用。",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    }
  }
}

API エンドポイントの選択¶

ネットワーク状況に応じて、設定の provider の baseURL を変更できます：

接続先	Anthropic (Claude)	OpenAI (Codex)	使用ケース
グローバルの入口（推奨）	`https://api.qcode.cc/claude/v1`	`https://api.qcode.cc/openai/v1`	グローバルユーザー
アジア	`https://asia.qcode.cc/claude/v1`	`https://asia.qcode.cc/openai/v1`	中国本土・アジアのユーザー
北米・欧州	`https://us.qcode.cc/claude/v1`	`https://us.qcode.cc/openai/v1`	北米・欧州のユーザー

中国本土ユーザー向け：asia.qcode.cc（アジアの接続先）を使い、baseURL を上表のアジアの行の 2 つのアドレスに変更してください。

利用可能なモデル¶

QCode は現在、以下の人気モデルをサポートしています（全一覧と単価は qcode.cc/models を参照）：

Claude シリーズ（パス：/claude/v1）：

claude-opus-5-5 - 現行の主力フラッグシップ（claude-opus-5、claude-opus-4-8 も引き続き呼び出し可能）
claude-sonnet-5-5 - 日常の既定（claude-sonnet-5、claude-sonnet-4-6 も引き続き呼び出し可能）
claude-haiku-5-5 - Haiku 5.5、超高速レスポンス

OpenAI/Codex シリーズ（パス：/openai/v1）：

gpt-6.1-sol - 主力フラッグシップ、1.05M コンテキスト
gpt-6-sol - GPT-6 Sol、1.05M コンテキスト
gpt-5.6-terra - プログラミング / Codex CLI
gpt-5.6-sol - 5.6 の同格モデル

QCode は Gemini シリーズも gpt-6-luna / gpt-5.6-luna も現在は提供していません。

設定の概要¶

上記の設定には完全なマルチエージェントワークフローが含まれています：

エージェント	モデル	モード	用途
plan	Claude Opus 5.5	primary	計画/分解/技術設計（読み取り専用）
build	Claude Opus 5.5	primary	メイン開発、エンドツーエンド実装
codex	GPT-6.1 Sol	primary	リファクタリング/移行/大規模変更
review	GPT-5.6 Terra	subagent	コードレビュー（読み取り専用）
explore	Claude Haiku 5.5	subagent	クイックコードスキャン/ファイル特定（読み取り専用）
general	Claude Sonnet 5.5	subagent	一般的な調査/ドキュメント（読み取り専用）
think	GPT-6.1 Sol	subagent	思考支援/エッジケース推論（読み取り専用）

各エージェントの model、prompt、permission 設定は好みに合わせてカスタマイズできます。

ステップ 4：API Key の設定¶

OpenCode を開いた後、/connect コマンドを使用して API Key を設定します：

Anthropic (Claude) の設定¶

OpenCode で /connect と入力
Anthropic を選択
Manually enter API Key を選択
QCode で購入した API Key を入力
Enter を押して保存

OpenAI (Codex) の設定¶

/connect と入力
OpenAI を選択
Manually enter API Key を選択
QCode で購入した API Key を入力
Enter を押して保存

保存と再起動¶

設定完了後：

/exit と入力して OpenCode を終了
OpenCode を再度開く

API Key は ~/.local/share/opencode/auth.json に保存され、将来の調整のために直接編集できます。

OpenCode 2 では、保存された API Key と OAuth トークンはサーバーの SQLite データベースに保存されます。V2 はデータベース移行時に、旧 auth.json から対応する認証情報をインポートします（2026-10-20 公式ドキュメント）。

設定の確認¶

OpenCode を再度開いた後、以下のようにテストして設定を確認できます：

# OpenCode を起動
opencode

# OpenCode でテスト
> こんにちは、自己紹介をしてください

会話が正常に動作すれば、設定は成功です！

使用のヒント¶

ultrawork モード¶

旧版の oh-my-opencode（OpenCode edition）では、プロンプトに ultrawork または ulw を追加すると並列マルチモデルのオーケストレーションを有効にできます。新版の OmO は独立した omo コマンドなので、使い方はその README に従ってください。旧版の例：

ultrawork このプロジェクトの認証モジュールをリファクタリングしてください

Tab でエージェントを切り替え¶

Tab キーを押して build と plan エージェントを切り替えます：

build - フル権限、開発作業用
plan - 読み取り専用モード、分析と計画用

OpenCode 2 でエージェントを切り替える既定のキーは Shift+Tab です（2026-10-20 公式ドキュメント）。

OpenCode 2¶

OpenCode 2 は同じプロジェクトの別のメジャーバージョンです。既定のインストーラーは引き続き OpenCode 1 のみをインストールし、両バージョンは opencode コマンドを共用するため、その既定コマンドの下では併存できません（2026-10-20 の公式インストーラーと移行ガイド）。

OpenCode 2 のインストール¶

V2 ドキュメントには次のインストールコマンドが掲載されています：

# OpenCode 2
curl -fsSL https://opencode.ai/v2/install | bash
npm install -g @opencode/cli
brew install anomalyco/tap/opencode-v2
bun install -g --trust @opencode/cli
pnpm add -g --allow-build=@opencode/cli @opencode/cli
yarn global add @opencode/cli

V2 をインストールする前に、パッケージマネージャーで入れた V1 を削除してください。V2 の curl インストーラーは V1 のバイナリを置き換えます。既存の OpenCode 1 をアップグレードするには opencode upgrade --major を実行します（2026-10-20 公式ドキュメント）。

設定は 1 と 2 の両方で使えます¶

OpenCode 2 は、V1 と同じ場所からシステム、グローバル、プロジェクトの設定を読み取ります。その中には ~/.config/opencode/opencode.json(c) も含まれます。対応する既存の V1 設定は引き続き動作するよう意図されており、V1 の設定形式は引き続きサポートされます。ネイティブな V2 形式は任意です。OpenCode 2 は対応する V1 とネイティブ V2 のフィールドをメモリ上で正規化し、元のファイルは書き換えません。移行ガイドは、ファイルをネイティブ V2 専用の形に変換した後に V1 からそのファイルを指さないよう注意しています。

したがって、上記の provider / options.baseURL 設定は OpenCode 1 と OpenCode 2 の両方で使用できます。OpenCode 2 のみを使い、ネイティブな V2 形式を選ぶ場合、同じエンドポイントは次のように書きます：

{
  "providers": {
    "anthropic": { "settings": { "baseURL": "https://api.qcode.cc/claude/v1" } },
    "openai": { "settings": { "baseURL": "https://api.qcode.cc/openai/v1" } }
  }
}

このネイティブ形式は OpenCode 2 専用です。

上記の設定に影響する動作の違い¶

プロジェクト外のディレクトリ：V1 はプロジェクト外のパスにアクセスする前に確認しますが、V2 は external_directory を既定で許可します。移行ガイドには、上記の V1 形式の external_directory ルール（本ページでは deny）を V2 がどう扱うかの記載がないため、V2 での実際の効果はご自身で確認してください。ネイティブ V2 で V1 の動作を保つには、移行ガイドにあるとおり、effect が ask の external_directory ルールを追加します。
権限アクション：lsp と doom_loop は現在の V2 Core の権限アクションではありません。
言語サーバー：OpenCode 2 は lsp 設定を受け取り保持しますが、言語サーバーを実行せず、LSP ツールを提供せず、LSP 診断も出力しません。
認証情報：保存された API Key と OAuth トークンはサーバーの SQLite データベースにあります。V2 はデータベース移行時に旧 auth.json から対応する認証情報をインポートします。新規および更新された認証情報は SQLite に保存され、このファイルには書き戻されません。
エージェントの切り替え：agent.cycle の既定のキーは Shift+Tab です。
プラグイン：V1 のプラグイン実装は V2 では動作しません。プラグインは新しいプラグイン API を使用します。

qcode.cc の OpenCode 2 アップグレードに関する説明（1.19.1 のセッション共有廃止を含む）は OpenCode 2 へのアップグレードとセッション共有の廃止を参照してください。

2.1.3–2.1.4 と 1.19.4 の変更（2026-10-26）¶

OpenCode 2.1.4 は 2026-10-23、2.1.3 は 2026-10-22、1.x の最新 1.19.4 は 2026-10-22 に公開されました。上記の設定に関係する項目は次のとおりです。

2.1.3：カスタム provider の baseURL 設定が、カタログ上のモデルエンドポイントを想定どおり上書きするようになりました。
2.1.3：同梱の Bun ランタイムを 1.4.4 に更新しました。Brotli、TLS、HTTP/1.1、HTTP/2、HTTP/3、WebSocket、fetch のセキュリティ修正を含み、ルート証明書を NSS 3.131.1 に更新します。
2.1.4：MCP サーバーがツール呼び出し中に入力を求めたとき、呼び出しがタイムアウトまで待つのではなくフォームが表示されるようになりました。実験的なバックグラウンド圧縮は experimental.background_compaction で有効にします。
1.19.4：1.x 系にも同じ Bun 1.4.4 のセキュリティ修正が入りました。

上記の V2 インストールコマンドは、2026-10-26 に確認したドキュメントで変わっていません。

トラブルシューティング¶

API 接続に失敗¶

API エンドポイントの設定が正しいか確認
API Key が正しく保存されているか確認
別の API エンドポイント（例：asia.qcode.cc / us）に切り替えてみる
ネットワークにプロキシが必要か確認

モデルが利用できない¶

opencode.json でモデル定義が正しく設定されていること、モデル ID が QCode がサポートするモデル名と一致していることを確認してください。

oh-my-opencode 設定の問題¶

公式ドキュメントを参照してください：https://github.com/code-yeongyu/oh-my-openagent#configuration

次のステップ¶

VS Code 統合で IDE での使用方法を確認
Codex 統合で OpenAI Codex モデルを使用
CLI テクニックでターミナル効率を向上

← 前のページ

Claude Desktop 接続設定

OpenClaw 接続

QCode を始める

API キーひとつで Claude Code・Codex などに対応。トークン単位の課金で、各モデルの単価は qcode.cc/models に掲載

アカウント登録料金プランを見る →

企業版 →