# OpenCode 統合

> **最終確認**：2026-09-18 · 📄 公式ドキュメント準拠（OpenCode v1.18.31、2026-09-14 公開（リポジトリは anomalyco/opencode））

## 概要

| 項目 | 内容 |
|---|---|
| 利用できるモデル | Claude ✅（anthropic provider）· GPT ✅ · 中国系モデル ✅（openai provider）· Gemini ✅（google provider） |
| プロトコルと Base URL | Anthropic：`https://api.qcode.cc/claude/v1` · OpenAI：`https://api.qcode.cc/openai/v1` · Gemini：`https://api.qcode.cc/gemini/v1beta`（各 provider の `options.baseURL`） |
| 設定場所 | `~/.config/opencode/opencode.json`。キーは `opencode auth login` で `auth.json` に保存 |
| 公式ドキュメント | [opencode.ai/docs](https://opencode.ai/docs) |

> ⚠️ **重要：API 直接アクセス権限が必要です**
>
> OpenCode を使用するには、API 直接アクセス権限を有効にする必要があります。直接 API 呼び出しには Claude Code のセッション機構がないため、トークン消費が大きくなります。そのため、この権限は**デフォルトで無効**になっています。
>
> 有効にするには、オンラインサポートに連絡するか、**hi@qcode.cc** にメールしてください。ご購入済みの API Key にこの権限を有効化いたします。

[OpenCode](https://github.com/anomalyco/opencode) は、Claude Code に似た 100% オープンソースのターミナル AI コーディングアシスタントですが、より柔軟性とカスタマイズ性を備えています。マルチモデル切り替え、LSP 統合、TUI インターフェースをサポートし、特定の AI プロバイダーに縛られません。

## プロジェクト紹介

### OpenCode

[OpenCode](https://github.com/anomalyco/opencode) は SST チームが開発したオープンソース AI コーディングエージェントです。主な特徴：

- **100% オープンソース** - MIT ライセンス、完全に透明

- **マルチモデル対応** - Claude、OpenAI、Google Gemini など複数のモデルを同時に使用可能

- **ネイティブ LSP サポート** - インテリジェントなコード分析のための組み込み言語サーバープロトコル

- **TUI ファースト** - Neovim ユーザーによる、ターミナルユーザーのための設計

- **クライアント/サーバーアーキテクチャ** - ローカルでサーバーを実行し、モバイルデバイスからリモート制御可能

- **2つの組み込みエージェント** - `build`（デフォルト、フルアクセス）と `plan`（読み取り専用、分析・計画用）

**プロジェクト統計**（2026年1月時点）：

- GitHub Stars: 208k+ (as of 2026-09)

- Repository: `anomalyco/opencode` (formerly `sst/opencode`; old URL redirects)

- Version: v1.18.31 (released 2026-09-14)

### oh-my-opencode

[oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) は OpenCode の拡張プラグインで、「OpenCode のステロイド」とも呼ばれ、プロフェッショナルグレードの AI コーディング体験を提供します：

**主要機能**：

- **非同期サブエージェント** - Claude Code に似た並列タスク処理機能

- **厳選されたエージェント設定** - 事前設定されたプロフェッショナルエージェントロール（Oracle、Librarian、Explore など）

- **LSP/AST ツール** - インテリジェントなリファクタリング、コード分析、シンボル検索などの高度な機能

- **Claude Code 互換レイヤー** - Claude Code の hooks、commands、skills 設定をサポート

- **Sisyphus メインエージェント** - バックグラウンド並列タスクをサポートする Claude Opus 4.8 ベースの強力なオーケストレーションエージェント

- **ultrawork モード** - プロンプトに `ultrawork` を追加するだけで、最強の並列オーケストレーションモードを有効化

**組み込みエージェントロール**：

| エージェント名 | モデル | 用途 |
|---------------|--------|------|
| **Sisyphus** | Claude Opus 4.8 | メインオーケストレーター、タスクの計画と委譲 |
| **Oracle** | GPT 5.4 | アーキテクチャ設計、コードレビュー、戦略分析 |
| **Librarian** | Claude Sonnet 4.6 | マルチリポジトリ分析、ドキュメント検索、実装例 |
| **Explore** | Grok Code | 高速コードベース探索とパターンマッチング |
| **Frontend UI/UX** | Gemini 2.5 Pro | フロントエンド開発、美しい UI の作成に優れる |

## インストールと設定

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

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

**公式ドキュメント**：[https://opencode.ai/docs](https://opencode.ai/docs)

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

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

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

# macOS Homebrew
brew install anomalyco/tap/opencode
```

### ステップ 2：oh-my-opencode のインストール（推奨）

oh-my-opencode はすぐに使えるプロフェッショナルな設定を提供します。強くお勧めします：

```bash
bunx oh-my-opencode install
```

**公式ドキュメント**：[https://github.com/code-yeongyu/oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode)

> **ヒント**：インストール時に、お持ちの AI サブスクリプション（Claude、ChatGPT、Gemini）を確認されます。実際のサブスクリプションに基づいて選択してください。

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

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

> **モデル選択について**：以下の設定は QCode の Claude 5 系と GPT Codex です。日常の既定は `claude-sonnet-5` / `claude-opus-5`。4.x は販売継続。QCode は **Gemini を販売**（[qcode.cc/models](https://qcode.cc/models)）、**grok は販売しない**。国内系 id は [国内系モデルの接続](/docs/usage/cn-models)。

> **Google プロバイダーブロックについて**：設定内の `google` プロバイダーブロックは Gemini（例：`gemini-2.5-pro`、`gemini-3.5-flash`）への接続に使用します。注意：公式 Gemini CLI の Pro／無料プランは 2026-06-18 にサポート終了しました（[Google 発表](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)）。後継は **Google Antigravity CLI**。エンタープライズ有料 Key は影響を受けません。Google モデルのツールチェーンが必要な場合は、Antigravity CLI への移行をお勧めします。

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

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

  "model": "anthropic/claude-opus-5",
  "small_model": "anthropic/claude-haiku-4-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",
      "temperature": 0.1,
      "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",
      "model": "anthropic/claude-opus-5",
      "temperature": 0.2,
      "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-5.4",
      "model": "openai/gpt-5.4",
      "temperature": 0.2,
      "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.3-Codex",
      "model": "openai/gpt-5.6-terra",
      "temperature": 0.1,
      "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 4.5",
      "model": "anthropic/claude-haiku-4-5",
      "temperature": 0.1,
      "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",
      "model": "anthropic/claude-sonnet-5",
      "temperature": 0.2,
      "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-5.4-Mini",
      "model": "openai/gpt-5.6-mini",
      "temperature": 0.2,
      "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` | グローバルユーザー、最適なノードを自動選択 |

> **中国本土ユーザー向け**：最高のパフォーマンスを得るには、`baseURL` を `https://api.qcode.cc/claude/v1` と `https://api.qcode.cc/openai` に変更してください。

#### 利用可能なモデル

QCode は現在、以下の人気モデルをサポートしています：

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

- `claude-opus-5` - 現行旗艦（`claude-opus-4-8` は販売継続）

- `claude-sonnet-5` - 日常の既定（`claude-sonnet-4-6` は販売継続）

- `claude-haiku-4-5` - Haiku 4.5、超高速レスポンス

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

- `gpt-5.6-terra` - プログラミング／Codex CLI（推奨）

- `gpt-5.6-sol` / `gpt-5.6-luna` - 5.6 の同列

- `gpt-5.5` / `gpt-5.4` - 前世代、まだ使える

- `gpt-5.6-mini` - 軽量／コストパフォーマンス

#### 設定の概要

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

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

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

### ステップ 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 を再度開いた後、以下のようにテストして設定を確認できます：

```bash
# OpenCode を起動
opencode

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

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

## 使用のヒント

### ultrawork モード

oh-my-opencode がインストールされている場合、プロンプトに `ultrawork` または `ulw` を追加するだけで、最強の並列マルチモデルオーケストレーションモードを有効にできます：

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

### バックグラウンドタスク

`@` 構文を使用して、特定のタスク用の専門エージェントを呼び出します：

```text
@oracle このコードのアーキテクチャ設計をレビューしてください
@librarian 類似のオープンソース実装を探してください
@explore プロジェクト内のすべての API エンドポイントを検索してください
```

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

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

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

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

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

### API 接続に失敗

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

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

3. 別の API エンドポイント（例：`asia.qcode.cc` / `us` / `eu`）に切り替えてみる

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

### モデルが利用できない

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

### oh-my-opencode 設定の問題

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

## 関連リンク

- [OpenCode 公式サイト](https://opencode.ai)

- [OpenCode GitHub](https://github.com/anomalyco/opencode)

- [oh-my-opencode GitHub](https://github.com/code-yeongyu/oh-my-opencode)

- [OpenCode 公式ドキュメント](https://opencode.ai/docs)

## 次のステップ

- [VS Code 統合](/docs/ide/vscode) で IDE での使用方法を確認

- [Codex 統合](/docs/ide/codex) で OpenAI Codex モデルを使用

- [CLI テクニック](/docs/usage/cli-tips) でターミナル効率を向上