WSL環境におけるopencodeとoh-my-opencodeの導入ガイド

はじめに

AI支援開発環境の充実により、開発者の生産性は飛躍的に向上しています。特に、GitHub Copilotを活用した開発支援ツールの需要が高まっており、その中でもopencodeとoh-my-opencodeは注目すべきツールです。

本記事では、WSL環境においてopencodeおよびその拡張ツールであるoh-my-opencodeを導入し、Claude Sonnet 4.5やGPT-5.2などの各種AIモデルをエージェントとして活用する方法について解説します。これにより、複数のAIモデルを用途に応じて使い分け、開発効率を最大化できます。

opencodeとは

opencodeは、AIアシスタントをターミナルから直接利用できるコマンドラインツールです。GitHub CopilotをはじめとするさまざまなAIプロバイダーと連携し、コード生成やリファクタリング、ドキュメント作成などの作業を支援します。

oh-my-opencodeの特徴

oh-my-opencodeは、opencodeを拡張し、複数のAIエージェントを管理・カスタマイズできるフレームワークです。プロジェクトの性質や作業内容に応じて、最適なAIモデルを自動的に選択・実行できます。

主な機能として以下が挙げられます。

• マルチエージェント管理: 複数のAIモデルを用途別に設定可能
• 自動タスク実行: プランニングからコード生成までを自動化
• 柔軟な権限設定: ファイル編集やコマンド実行の権限を細かく制御

導入手順

前提条件

本手順では、以下の環境を前提としています。

• WSL (Windows Subsystem for Linux) がインストールされていること
• GitHub Copilotのサブスクリプションが有効であること
• インターネット接続が可能であること

1. opencodeのインストール

WSLのターミナルを開き、以下のコマンドを実行してください。

curl -fsSL https://opencode.ai/install | bash

このスクリプトは、必要な依存関係をインストールし、opencodeコマンドをシステムに追加します。インストールが完了したら、新しいシェルセッションを開始するか、以下のコマンドでパスを再読み込みしてください。

source ~/.bashrc

次に、opencodeを起動します。

opencode

起動後、プロンプトが表示されたら、/connectコマンドを入力し、プロバイダーとしてGitHub Copilotを選択してください。画面の指示に従い、認証を完了させることで、GitHub Copilotとの連携が確立されます。

2. oh-my-opencodeの導入

opencodeの起動状態で、以下のコマンドを入力してください。

Install and configure by following the instructions here https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md

このコマンドにより、oh-my-opencodeのREADMEに記載された自動セットアップが実行されます。プロンプトに従い、必要な設定を行ってください。

3. AIモデルの個別設定

oh-my-opencodeでは、エージェントごとに使用するAIモデルを指定できます。これにより、タスクに応じて最適なモデルを活用できます。

設定ファイルのパスは以下の通りです。

~/.config/opencode/oh-my-opencode.json

このファイルをテキストエディタで開き、以下の内容を参考に編集してください。

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  "experimental": {
    "auto_resume": true
  },
  "google_auth": false,
  "sisyphus_agent": {
    "default_builder_enabled": true,
    "planner_enabled": true
  },
  "agents": {
    "Sisyphus": {
      "model": "github-copilot/claude-opus-4.5"
    },
    "oracle": {
      "model": "github-copilot/gpt-5.2"
    },
    "librarian": {
      "model": "github-copilot/grok-code-fast-1"
    },
    "explore": {
      "model": "github-copilot/gemini-3-flash-preview"
    },
    "frontend-ui-ux-engineer": {
      "model": "github-copilot/gemini-3-pro-preview"
    },
    "document-writer": {
      "model": "github-copilot/gemini-3-pro-preview"
    },
    "multimodal-looker": {
      "model": "github-copilot/gemini-3-flash-preview"
    },
    "*": {
      "permission": {
        "edit": "allow",
        "webfetch": "allow",
        "doom_loop": "allow",
        "external_directory": "allow",
        "bash": {
          "*": "allow",
          "git": "allow",
          "rm": "ask"
        }
      }
    }
  }
}

各エージェントの設定内容について説明します。

• Sisyphus: 複雑な開発タスクやプランニングを担当。Claude Opus 4.5を使用
• oracle: 高度な推論や問題解決を担当。GPT-5.2を使用
• librarian: コードの検索やドキュメント参照を担当。Grok Code Fast 1を使用
• explore: 探索的な調査や検証を担当。Gemini 3 Flash Previewを使用
• frontend-ui-ux-engineer: フロントエンド開発やUI/UX設計を担当
• document-writer: ドキュメント作成や記事執筆を担当

権限設定（permission）では、各エージェントがファイル編集やWeb取得、外部コマンド実行を行う際のルールを定義しています。rmコマンドのみaskに設定することで、誤った削除を防止できます。

4. 依存ツールの導入

oh-my-opencodeのエージェントは、ターミナルセッションを管理するためにtmuxを使用します。以下のコマンドでインストールしてください。

sudo apt install tmux

tmuxをインストールすることで、エージェントが複数のターミナルセッションを並行して実行し、効率的にタスクを処理できるようになります。

動作確認

導入が完了したら、以下の手順で動作を確認してください。

1. opencodeを起動します。

opencode

2. プロンプトで、エージェントを呼び出すコマンドを入力します（例: @Sisyphus タスクを実行してください）。

3. エージェントが正常に応答し、設定したモデル（例: github-copilot/claude-opus-4.5）が使用されているか確認します。

4. ログを確認し、エラーが発生していないことを確認してください。

トラブルシューティング

モデルが見つからない場合

設定ファイルで指定したモデル識別子が正しいか確認してください。GitHub Copilot経由で利用可能なモデルは随時更新されるため、最新の情報を確認する必要があります。

Models.devにアクセスし、github-copilotで検索して、最新のモデル識別子を取得してください。その後、oh-my-opencode.jsonファイルを更新し、再度opencodeを起動してください。

認証エラーが発生する場合

GitHub Copilotとの認証が失敗している可能性があります。以下の手順で再認証を試してください。

1. opencodeを起動し、/disconnectコマンドでプロバイダーを切断します。
2. 再度/connectコマンドを実行し、GitHub Copilotを選択して認証を完了させます。

tmuxが見つからない場合

tmuxがインストールされていない場合、エージェントが正常に動作しません。前述のコマンドでインストールを完了させてください。

まとめ

本記事では、WSL環境におけるopencodeとoh-my-opencodeの導入手順について解説しました。これらのツールを活用することで、GitHub Copilot経由で複数のAIモデルを使い分け、開発効率を大幅に向上させることが可能です。

各エージェントに適切なモデルを割り当てることで、タスクに応じた最適な支援を受けられます。ぜひ、実際のプロジェクトで活用してみてください。

関連リンク

• oh-my-opencode (GitHub)
• opencode公式サイト
• Models.dev - GitHub Copilotモデル一覧