OpenCode 統合
OpenCode オープンソースターミナル AI コーディングアシスタントと QCode API の連携
OpenCode 統合¶
⚠️ 重要:API 直接アクセス権限が必要です
OpenCode を使用するには、API 直接アクセス権限を有効にする必要があります。直接 API 呼び出しには Claude Code のセッション機構がないため、トークン消費が大きくなります。そのため、この権限はデフォルトで無効になっています。
有効にするには、オンラインサポートに連絡するか、hi@qcode.cc にメールしてください。ご購入済みの API Key にこの権限を有効化いたします。
OpenCode は、Claude Code に似た 100% オープンソースのターミナル AI コーディングアシスタントですが、より柔軟性とカスタマイズ性を備えています。マルチモデル切り替え、LSP 統合、TUI インターフェースをサポートし、特定の AI プロバイダーに縛られません。

プロジェクト紹介¶
OpenCode¶
OpenCode は SST チームが開発したオープンソース AI コーディングエージェントです。主な特徴:
-
100% オープンソース - MIT ライセンス、完全に透明
-
マルチモデル対応 - Claude、OpenAI、Google Gemini など複数のモデルを同時に使用可能
-
ネイティブ LSP サポート - インテリジェントなコード分析のための組み込み言語サーバープロトコル
-
TUI ファースト - Neovim ユーザーによる、ターミナルユーザーのための設計
-
クライアント/サーバーアーキテクチャ - ローカルでサーバーを実行し、モバイルデバイスからリモート制御可能
-
2つの組み込みエージェント -
build(デフォルト、フルアクセス)とplan(読み取り専用、分析・計画用)
プロジェクト統計(2026年1月時点):
-
GitHub Stars: 46.1k+
-
コントリビューター: 490+
-
バージョン: v1.0.223+
oh-my-opencode¶
oh-my-opencode は OpenCode の拡張プラグインで、「OpenCode のステロイド」とも呼ばれ、プロフェッショナルグレードの AI コーディング体験を提供します:

主要機能:
-
非同期サブエージェント - Claude Code に似た並列タスク処理機能
-
厳選されたエージェント設定 - 事前設定されたプロフェッショナルエージェントロール(Oracle、Librarian、Explore など)
-
LSP/AST ツール - インテリジェントなリファクタリング、コード分析、シンボル検索などの高度な機能
-
Claude Code 互換レイヤー - Claude Code の hooks、commands、skills 設定をサポート
-
Sisyphus メインエージェント - バックグラウンド並列タスクをサポートする Claude Opus 4.6 ベースの強力なオーケストレーションエージェント
-
ultrawork モード - プロンプトに
ultraworkを追加するだけで、最強の並列オーケストレーションモードを有効化
組み込みエージェントロール:
| エージェント名 | モデル | 用途 |
|---|---|---|
| Sisyphus | Claude Opus 4.6 | メインオーケストレーター、タスクの計画と委譲 |
| Oracle | GPT 5.2 | アーキテクチャ設計、コードレビュー、戦略分析 |
| Librarian | Claude Sonnet 4.6 | マルチリポジトリ分析、ドキュメント検索、実装例 |
| Explore | Grok Code | 高速コードベース探索とパターンマッチング |
| Frontend UI/UX | Gemini 3 Pro | フロントエンド開発、美しい UI の作成に優れる |
インストールと設定¶
ステップ 1:OpenCode のインストール¶
OpenCode は非常に速いペースで更新されています。公式のインストールガイドを参照してください:
公式ドキュメント:https://opencode.ai/docs
一般的なインストール方法:
# curl でインストール(推奨)
curl -fsSL https://opencode.ai/install | bash
# パッケージマネージャーを使用
npm install -g opencode # または bun/pnpm/yarn
# macOS Homebrew
brew install opencode
ステップ 2:oh-my-opencode のインストール(推奨)¶
oh-my-opencode はすぐに使えるプロフェッショナルな設定を提供します。強くお勧めします:
bunx oh-my-opencode install
公式ドキュメント:https://github.com/code-yeongyu/oh-my-opencode
ヒント:インストール時に、お持ちの AI サブスクリプション(Claude、ChatGPT、Gemini)を確認されます。実際のサブスクリプションに基づいて選択してください。
ステップ 3:QCode API の設定¶
これが重要なステップです!設定ファイル ~/.config/opencode/opencode.json を作成または編集します:
モデル選択について:以下の設定は QCode が提供する Claude シリーズと GPT Codex シリーズのモデルを使用しています。これら 2 つのモデルファミリーの組み合わせで開発することをお勧めします。各種コーディングベンチマークで優れた性能を発揮しています。当サイトでは Gemini や Grok モデルは販売していません。必要な場合は、以下の設定形式を参考に他のプロバイダーを設定できます(ただし、Gemini と Grok はコーディングベンチマークで Claude と Codex に劣るため、あまりお勧めしません)。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"baseURL": "https://asia.qcode.cc/claude/v1"
}
},
"openai": {
"options": {
"baseURL": "https://asia.qcode.cc/openai"
}
}
},
"model": "anthropic/claude-opus-4-5-20251101",
"small_model": "anthropic/claude-haiku-4-5-20251001",
"default_agent": "build",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "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-4-5-20251101",
"temperature": 0.1,
"prompt": "あなたはシニア技術リーダーです。目標:要件を実行可能なステップに分解する(受け入れ基準/リスク/ロールバックを含む)。デフォルトで読み取り専用、ファイルの変更やコマンドの実行はしない;実行が本当に必要な場合は、理由を説明し build/codex への切り替えを提案してください。",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "allow",
"lsp": "allow",
"edit": "deny",
"bash": "deny",
"webfetch": "deny",
"websearch": "deny",
"external_directory": "deny",
"doom_loop": "deny"
}
},
"build": {
"mode": "primary",
"description": "メイン開発(エンドツーエンド実装/デバッグ/テスト修正)- Claude Opus 4.6",
"model": "anthropic/claude-opus-4-5-20251101",
"temperature": 0.2,
"prompt": "あなたはメインのソフトウェアエンジニアリングエージェントです。優先事項:最小限の実行可能な変更、可読性、テスト可能性。変更前に簡単にアプローチを説明;変更後は必ず提供:主要な diff ポイント、ローカルでの検証方法(コマンド)、潜在的なエッジケース。",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "allow",
"lsp": "allow",
"edit": "allow",
"bash": "allow",
"webfetch": "ask",
"websearch": "ask",
"external_directory": "deny",
"doom_loop": "ask"
}
},
"codex": {
"mode": "primary",
"description": "リファクタリング/移行/大規模変更(Codex)- GPT-5.2",
"model": "openai/gpt-5.2-2025-12-11",
"temperature": 0.2,
"prompt": "あなたは Codex スタイルのエンジニアリングエージェントで、大規模リファクタリング、移行、コードレビュー、複雑なツールチェーン連携に長けています。優先事項:プロジェクトを実行可能に保つ:ステップバイステップのコミット、各ステップが検証可能;不確かな場合は、まずセーフガードとテストを追加。",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "allow",
"lsp": "allow",
"edit": "allow",
"bash": "allow",
"webfetch": "ask",
"websearch": "ask",
"external_directory": "deny",
"doom_loop": "ask"
}
},
"review": {
"mode": "subagent",
"description": "コードレビュー/セカンドブレイン(読み取り専用)- GPT-5.1-Codex-Max",
"model": "openai/gpt-5.1-codex-max",
"temperature": 0.1,
"prompt": "あなたは厳格なコードレビュアーです。出力:1) 主要なリスク(バグ/セキュリティ/並行性/エッジケース)2) 保守性の提案 3) 最小限の修正提案(疑似 diff 可)4) 必要なテストポイント。デフォルトで読み取り専用、ファイルの変更/コマンドの実行はしない。",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "allow",
"lsp": "allow",
"edit": "deny",
"bash": "deny",
"webfetch": "deny",
"websearch": "deny",
"external_directory": "deny",
"doom_loop": "deny"
}
},
"explore": {
"mode": "subagent",
"description": "クイックコードスキャン/ファイル特定/コンテキスト要約(読み取り専用)- Claude Haiku 4.5",
"model": "anthropic/claude-haiku-4-5-20251001",
"temperature": 0.1,
"prompt": "あなたはクイック探索サブエージェントです:最小限のステップで関連ファイル/関数/コールチェーンを特定し、明確なパスと要約を提供。デフォルトで読み取り専用、ファイルの変更/コマンドの実行はしない。",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "allow",
"lsp": "allow",
"edit": "deny",
"bash": "deny",
"webfetch": "deny",
"websearch": "deny",
"external_directory": "deny",
"doom_loop": "deny"
}
},
"general": {
"mode": "subagent",
"description": "一般的な調査/ドキュメント/アプローチ比較(中コスト)- Claude Sonnet 4.6",
"model": "anthropic/claude-sonnet-4-5-20250929",
"temperature": 0.2,
"prompt": "あなたは一般的な分析サブエージェントです:説明、トレードオフ、ドキュメント、アプローチ比較に重点を置く;デフォルトで読み取り専用、コードの変更は極力しない。",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "allow",
"lsp": "allow",
"edit": "deny",
"bash": "deny",
"webfetch": "ask",
"websearch": "ask",
"external_directory": "deny",
"doom_loop": "deny"
}
},
"think": {
"mode": "subagent",
"description": "思考支援/エッジケース推論(読み取り専用)- GPT-5.2",
"model": "openai/gpt-5.2-2025-12-11",
"temperature": 0.2,
"prompt": "あなたは推論とエッジケース分析のサブエージェントです:設計、例外パス、並行性/一貫性、パフォーマンスボトルネックについて構造化された分析と提案を提供。デフォルトで読み取り専用。",
"permission": {
"read": "allow",
"list": "allow",
"glob": "allow",
"grep": "allow",
"codesearch": "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://asia.qcode.cc/claude/v1 |
https://asia.qcode.cc/openai |
グローバルユーザー、最適なノードを自動選択 |
| 香港 IP 直接接続 | http://103.218.243.5/claude/v1 |
http://103.218.243.5/openai |
中国のユーザー向け代替 |
| 深圳 IP 直接接続 | http://103.236.53.153/claude/v1 |
http://103.236.53.153/openai |
中国本土ユーザー向け推奨 |
中国本土ユーザー向け:最高のパフォーマンスを得るには、
baseURLをhttp://103.236.53.153/claude/v1とhttp://103.236.53.153/openaiに変更してください。
利用可能なモデル¶
QCode は現在、以下の人気モデルをサポートしています:
Claude シリーズ(パス:/claude/v1):
-
claude-sonnet-4-5-20250929- Sonnet 4.6、コストパフォーマンス最高 -
claude-opus-4-5-20251101- Opus 4.6、最強の推論能力 -
claude-haiku-4-5-20251001- Haiku 4.5、超高速レスポンス
OpenAI/Codex シリーズ(パス:/openai):
-
gpt-5.2-2025-12-11- GPT 5.2 最新版(推奨) -
gpt-5.1-codex-max- Codex Max、コーディング専用 -
gpt-5.1-codex- Codex スタンダード
設定の概要¶
上記の設定には完全なマルチエージェントワークフローが含まれています:
| エージェント | モデル | モード | 用途 |
|---|---|---|---|
| plan | Claude Opus 4.6 | primary | 計画/分解/技術設計(読み取り専用) |
| build | Claude Opus 4.6 | primary | メイン開発、エンドツーエンド実装 |
| codex | GPT-5.2 | primary | リファクタリング/移行/大規模変更 |
| review | GPT-5.1-Codex-Max | subagent | コードレビュー(読み取り専用) |
| explore | Claude Haiku 4.5 | subagent | クイックコードスキャン/ファイル特定(読み取り専用) |
| general | Claude Sonnet 4.6 | subagent | 一般的な調査/ドキュメント(読み取り専用) |
| think | GPT-5.2 | 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 を再度開いた後、以下のようにテストして設定を確認できます:
# OpenCode を起動
opencode
# OpenCode でテスト
> こんにちは、自己紹介をしてください
会話が正常に動作すれば、設定は成功です!
使用のヒント¶
ultrawork モード¶
oh-my-opencode がインストールされている場合、プロンプトに ultrawork または ulw を追加するだけで、最強の並列マルチモデルオーケストレーションモードを有効にできます:
ultrawork このプロジェクトの認証モジュールをリファクタリングしてください
バックグラウンドタスク¶
@ 構文を使用して、特定のタスク用の専門エージェントを呼び出します:
@oracle このコードのアーキテクチャ設計をレビューしてください
@librarian 類似のオープンソース実装を探してください
@explore プロジェクト内のすべての API エンドポイントを検索してください
Tab でエージェントを切り替え¶
Tab キーを押して build と plan エージェントを切り替えます:
-
build - フル権限、開発作業用
-
plan - 読み取り専用モード、分析と計画用
トラブルシューティング¶
API 接続に失敗¶
-
API エンドポイントの設定が正しいか確認
-
API Key が正しく保存されているか確認
-
別の API エンドポイント(例:深圳直接接続)に切り替えてみる
-
ネットワークにプロキシが必要か確認
モデルが利用できない¶
opencode.json でモデル定義が正しく設定されていること、モデル ID が QCode がサポートするモデル名と一致していることを確認してください。
oh-my-opencode 設定の問題¶
公式ドキュメントを参照してください:https://github.com/code-yeongyu/oh-my-opencode#configuration
関連リンク¶
次のステップ¶
-
VS Code 統合 で IDE での使用方法を確認
-
Codex 統合 で OpenAI Codex モデルを使用
-
CLI テクニック でターミナル効率を向上