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

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 コーディング体験を提供します:

oh-my-opencode インターフェース

主要機能

  • 非同期サブエージェント - 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 エンドポイントの選択

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

エンドポイント 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 中国本土ユーザー向け推奨

中国本土ユーザー向け:最高のパフォーマンスを得るには、baseURLhttp://103.236.53.153/claude/v1http://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 思考支援/エッジケース推論(読み取り専用)

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

ステップ 4:API Key の設定

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

Anthropic (Claude) の設定
  1. OpenCode で /connect と入力

  2. Anthropic を選択

  3. Manually enter API Key を選択

  4. QCode で購入した API Key を入力

  5. Enter を押して保存

OpenAI (Codex) の設定
  1. /connect と入力

  2. OpenAI を選択

  3. Manually enter API Key を選択

  4. QCode で購入した API Key を入力

  5. Enter を押して保存

保存と再起動

設定完了後:

  1. /exit と入力して OpenCode を終了

  2. 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 キーを押して buildplan エージェントを切り替えます:

  • build - フル権限、開発作業用

  • plan - 読み取り専用モード、分析と計画用

トラブルシューティング

API 接続に失敗

  1. API エンドポイントの設定が正しいか確認

  2. API Key が正しく保存されているか確認

  3. 別の API エンドポイント(例:深圳直接接続)に切り替えてみる

  4. ネットワークにプロキシが必要か確認

モデルが利用できない

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

oh-my-opencode 設定の問題

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

関連リンク

次のステップ

🚀
QCode を始めよう — AI プログラミングアシスタント
Claude Code 公式リレー、高速・安定・すぐに使える
料金プランを見る → アカウント登録