クイックスタート

このガイドでは、Oh My OpenCodeを数分でインストールして構成し、マルチエージェント・コラボレーションの力を体験する方法を説明します。

前提条件

開始する前に、以下を確認してください：

✅ OpenCode がインストールされていること
✅ 以下のサブスクリプションのいずれかを持っていること：
- Claude Max20 (推奨) - 最も強力なマルチエージェント体験
- ChatGPT Plus/Pro - パフォーマンスとコストのバランスが良い
- Gemini Advanced - 非常に高いコストパフォーマンス
✅ 基本的な OpenCode 設定（APIキーなど）が構成されていること

インストール手順

方法 1：人間によるインストール

人間であるユーザーの場合は、以下のステップに従ってインストールしてください：

# 1. Oh My OpenCode リポジトリをクローンする
git clone https://github.com/code-yeongyu/oh-my-opencode.git ~/.oh-my-opencode

# 2. 依存関係をインストールする
cd ~/.oh-my-opencode
npm install  # または yarn install / pnpm install

# 3. インストールスクリプトを実行する
npm run install

インストールスクリプトは自動的に以下を行います：

OpenCode 設定ファイルの場所を検出
既存の設定をバックアップ
Oh My OpenCode の設定を OpenCode の設定にマージ

方法 2：AI エージェントによるインストール

AI エージェントを使用してインストールする場合は、エージェントが直接以下を使用できます：

# AI エージェントはインストールスクリプトを直接実行できます
opencode "ultrawork モードを使用して oh-my-opencode をインストールして"

AI エージェントは以下を自動的に処理します：

ダウンロードと構成
依存関係のインストール
設定ファイルのマージ

サブスクリプションプランの構成

サブスクリプションサービスに基づいて構成を選択します：

Claude Max20 (推奨)

{
  "subscription": "claude-max20",
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 3
  },
  "agents": {
    "oracle": { "enabled": true },
    "librarian": { "enabled": true },
    "frontend-engineer": { "enabled": true },
    "backend-engineer": { "enabled": true },
    "explore": { "enabled": true }
  }
}

特徴:

最大の同時タスク数（3つのバックグラウンドタスク）
すべてのエージェントが完全に有効
最高のマルチエージェント・コラボレーション体験

ChatGPT Plus/Pro

{
  "subscription": "chatgpt-plus",
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2
  },
  "agents": {
    "oracle": { "enabled": true },
    "librarian": { "enabled": true },
    "frontend-engineer": { "enabled": true }
  }
}

特徴:

中程度の同時タスク数（2つのバックグラウンドタスク）
コアエージェントが有効
パフォーマンスとコストのバランスが良い

Gemini Advanced

{
  "subscription": "gemini-advanced",
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2
  },
  "agents": {
    "oracle": { "enabled": false },
    "librarian": { "enabled": true },
    "explore": { "enabled": true }
  }
}

特徴:

中程度の同時タスク数（2つのバックグラウンドタスク）
選択されたエージェントが有効
高いコストパフォーマンス

インストールの検証

インストール後、Oh My OpenCode が正しく動作していることを確認します：

1. 設定ファイルの確認

# Oh My OpenCode 設定ファイルを表示
cat .opencode/oh-my-opencode.json  # プロジェクトレベルの設定
# または
cat ~/.config/opencode/oh-my-opencode.json  # ユーザーレベルの設定 (macOS/Linux)
# または
type %APPDATA%\opencode\oh-my-opencode.json  # ユーザーレベルの設定 (Windows)

設定ファイルに Oh My OpenCode 関連の設定が含まれていることを確認してください。

2. 基本機能のテスト

# Sisyphus エージェントをテスト
opencode "@oracle を使用して現在のプロジェクトのアーキテクチャを分析して"

# ultrawork モードをテスト
opencode "ulw: プロジェクト内のすべての設定ファイルをリストして"

3. エージェントリストの確認

# 利用可能なすべてのエージェントを表示
opencode "利用可能なすべての専門エージェントをリストして"

以下のような出力が表示されるはずです：

利用可能なエージェント:
- @oracle - システムアーキテクチャ設計
- @librarian - ドキュメント調査
- @frontend-engineer - フロントエンド開発
- @backend-engineer - バックエンド開発
- @explore - コードベース分析

基本構成

ultrawork モードを有効にする

タスクの説明に ultrawork または ulw キーワードを追加します：

opencode "ultrawork: ユーザー認証モジュールをリファクタリングして"

これにより、以下が自動的に有効になります：

✅ すべての構成済みエージェント
✅ バックグラウンドタスクの並列化
✅ LSPツール統合
✅ インテリジェントなコンテキスト管理

エージェントの動作をカスタマイズする

OpenCode 設定ファイルを編集して、エージェント固有の設定を追加します：

{
  "agents": {
    "oracle": {
      "enabled": true,
      "model": "claude-sonnet-4",
      "temperature": 0.7,
      "prompt_append": "詳細な技術的決定の理由を提供してください"
    }
  }
}

バックグラウンドタスクの同時実行を構成する

同時に実行されるバックグラウンドタスクの数を制御します：

{
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2,
    "task_timeout": 300
  }
}

よくある質問

インストールに失敗した

問題: インストールスクリプトのエラー、または OpenCode 設定が見つからない

解決策:

OpenCode が正しくインストールされていることを確認：opencode --version

設定ファイルのパスを手動で指定：

export OPENCODE_CONFIG_PATH=/path/to/your/config.json
npm run install

エージェントが応答しない

問題: @oracle などのエージェントを使用しても応答がない

解決策:

エージェントが有効になっているか確認：
```
opencode "現在の設定を表示して"
```
サブスクリプションプランがそのエージェントをサポートしているか確認
API クォータが使い果たされていないか確認

設定の競合

問題: Oh My OpenCode の設定が既存の設定と競合する

解決策:

バックアップファイルを確認：
- プロジェクトレベル：.opencode/oh-my-opencode.json.backup
- ユーザーレベル (macOS/Linux)：~/.config/opencode/oh-my-opencode.json.backup

手動で設定をマージ：

# バックアップを復元（プロジェクトレベルの例）
cp .opencode/oh-my-opencode.json.backup .opencode/oh-my-opencode.json

# またはユーザーレベルのバックアップを復元 (macOS/Linux)
cp ~/.config/opencode/oh-my-opencode.json.backup ~/.config/opencode/oh-my-opencode.json

# 手動で Oh My OpenCode の設定を追加
# 設定ファイルを編集し、必要な agents と sisyphus セクションを追加

LSP ツールが動作しない

問題: エージェントがホバーやジャンプなどの LSP 機能を使用できない

解決策:

プロジェクトが LSP サーバーを初期化しているか確認：

# TypeScript プロジェクトの場合
npm install -D typescript

# Python プロジェクトの場合
pip install python-lsp-server

LSP 設定を確認：

{
  "lsp": {
    "enabled": true,
    "languages": ["typescript", "python", "go"]
  }
}

同時実行タスクが多すぎる

問題: バックグラウンドタスクが多すぎてパフォーマンスが低下するか、API レート制限が発生する

解決策: 同時実行タスクの数を減らします：

{
  "sisyphus": {
    "max_concurrent_tasks": 1  // 1に減らす
  }
}

次のステップ

インストール後、以下のことをお勧めします：

📖 主な機能を読んで、すべての機能について学ぶ
🎯 ベストプラクティスをチェックして、効率的な使用のヒントを学ぶ
⚙️ 高度な設定で深いカスタマイズを行う
💡 ユースケースを参照してインスピレーションを得る

ヘルプを得る

問題が発生しましたか？

📖 GitHub README を確認
🐛 Issue を送信
💬 コミュニティのディスカッションに参加

マルチエージェント・コラボレーションの力を体験する準備はできましたか？このコマンドを試してみてください：

opencode "ultrawork: 現在のプロジェクトを分析し、改善案を提案して"