docs: add OpenCode setup guide

messages/en/usage.json

@@ -473,6 +473,108 @@
     }
   },
 
+  "opencode": {
+    "title": "OpenCode Usage Guide",
+    "description": "OpenCode is a CLI + TUI AI coding agent that runs in your terminal and also provides IDE integrations. You can point OpenCode to cch as a single entry to access Claude, GPT, and Gemini models.",
+
+    "installation": {
+      "title": "Install",
+
+      "macos": {
+        "description": "On macOS, install OpenCode using one of the following methods:",
+        "homebrew": {
+          "title": "Option 2: Homebrew",
+          "description": "Install via Homebrew:"
+        }
+      },
+
+      "linux": {
+        "description": "On Linux, install OpenCode using one of the following methods:",
+        "homebrew": {
+          "title": "Option 2: Homebrew",
+          "description": "Install via Homebrew:"
+        },
+        "paru": {
+          "title": "Option 5: Paru (Arch Linux)",
+          "description": "Install via paru (AUR):"
+        }
+      },
+
+      "script": {
+        "title": "Option 1: Official install script",
+        "description": "Run the following command to install the latest version:"
+      },
+
+      "npm": {
+        "title": "Option 3: npm",
+        "description": "Install globally via npm:"
+      },
+
+      "bun": {
+        "title": "Option 4: Bun",
+        "description": "Install globally via Bun:"
+      },
+
+      "windows": {
+        "description": "On Windows, we recommend a package manager (Chocolatey/Scoop); npm also works:",
+        "choco": {
+          "title": "Option 1: Chocolatey",
+          "description": "Install via Chocolatey:",
+          "command": "choco install opencode"
+        },
+        "scoop": {
+          "title": "Option 2: Scoop",
+          "description": "Install via Scoop:",
+          "command": "scoop bucket add extras\nscoop install extras/opencode"
+        },
+        "note": "Note: Bun on Windows is still in progress. Use Chocolatey/Scoop/npm, or download a binary from GitHub Releases."
+      }
+    },
+
+    "configuration": {
+      "title": "Connect to cch service",
+
+      "configFile": {
+        "title": "Configure opencode.json",
+        "path": "Config file path:",
+        "instruction": "Edit the file and add the following content (one file covers all models):",
+
+        "important": "Important",
+        "importantPoints": [
+          "Create an API key in the cch console and set the CCH_API_KEY environment variable",
+          "All providers use ${resolvedOrigin}/v1 as baseURL (cch v1 API base URL)",
+          "When selecting models, use provider_id/model_id (e.g. cchClaude/claude-sonnet-4-5-20250929)"
+        ]
+      },
+
+      "modelSelection": {
+        "title": "Select a model",
+        "description": "After starting OpenCode, use the following command in the TUI to view/select models:",
+        "command": "/models"
+      }
+    },
+
+    "startup": {
+      "title": "Start opencode",
+      "description": "Run in your project directory:",
+      "initNote": "On first launch, opencode loads the config and creates a session."
+    },
+
+    "commonIssues": {
+      "title": "Common issues",
+
+      "commandNotFound": "1. Command not found",
+      "commandNotFoundWindows": [
+        "If installed via npm, make sure your global npm bin directory is on PATH",
+        "Open a new terminal and try again"
+      ],
+      "commandNotFoundUnix": "Check the install location and add it to PATH (e.g. ~/.local/bin or npm global bin)",
+
+      "connectionFailed": "2. API connection failed",
+      "updateCli": "3. Update opencode"
+    }
+  },
+
   "droid": {
     "title": "Droid CLI Usage Guide",
     "description": "Droid is an interactive terminal AI programming assistant developed by Factory AI that supports integration through the cch proxy service. You must register and log in to your Droid official account before use.",

messages/ja/usage.json

@@ -473,6 +473,108 @@
     }
   },
 
+  "opencode": {
+    "title": "OpenCode 利用ガイド",
+    "description": "OpenCode はターミナルで動作する CLI + TUI の AI コーディングエージェントで、IDE 連携も提供します。OpenCode の接続先を cch に設定することで、Claude / GPT / Gemini の各モデルを利用できます。",
+
+    "installation": {
+      "title": "インストール",
+
+      "macos": {
+        "description": "macOS では以下のいずれかの方法で OpenCode をインストールできます：",
+        "homebrew": {
+          "title": "方法2：Homebrew",
+          "description": "Homebrew でインストール："
+        }
+      },
+
+      "linux": {
+        "description": "Linux では以下のいずれかの方法で OpenCode をインストールできます：",
+        "homebrew": {
+          "title": "方法2：Homebrew",
+          "description": "Homebrew でインストール："
+        },
+        "paru": {
+          "title": "方法5：Paru（Arch Linux）",
+          "description": "Arch Linux の場合、paru（AUR）でインストール："
+        }
+      },
+
+      "script": {
+        "title": "方法1：公式インストールスクリプト",
+        "description": "最新版をインストールするには次のコマンドを実行します："
+      },
+
+      "npm": {
+        "title": "方法3：npm",
+        "description": "npm でグローバルにインストール："
+      },
+
+      "bun": {
+        "title": "方法4：Bun",
+        "description": "Bun でグローバルにインストール："
+      },
+
+      "windows": {
+        "description": "Windows ではパッケージマネージャ（Chocolatey/Scoop）を推奨します。npm でもインストールできます：",
+        "choco": {
+          "title": "方法1：Chocolatey",
+          "description": "Chocolatey でインストール：",
+          "command": "choco install opencode"
+        },
+        "scoop": {
+          "title": "方法2：Scoop",
+          "description": "Scoop でインストール：",
+          "command": "scoop bucket add extras\nscoop install extras/opencode"
+        },
+        "note": "注: Windows での Bun インストールは現在対応中です。Chocolatey/Scoop/npm を使用するか、GitHub Releases からバイナリを取得してください。"
+      }
+    },
+
+    "configuration": {
+      "title": "cch サービスに接続",
+
+      "configFile": {
+        "title": "opencode.json を設定",
+        "path": "設定ファイルのパス：",
+        "instruction": "設定ファイルを編集し、以下を追加します（1 つの設定ファイルで全モデルをカバーします）：",
+
+        "important": "重要",
+        "importantPoints": [
+          "cch の管理画面で API Key を作成し、環境変数 CCH_API_KEY を設定してください",
+          "3 つの provider すべてで baseURL は ${resolvedOrigin}/v1（cch の v1 API ベース URL）",
+          "モデル選択は provider_id/model_id 形式（例：cchClaude/claude-sonnet-4-5-20250929）"
+        ]
+      },
+
+      "modelSelection": {
+        "title": "モデルを選択",
+        "description": "OpenCode を起動したら、TUI で次のコマンドを入力してモデルを表示/選択します：",
+        "command": "/models"
+      }
+    },
+
+    "startup": {
+      "title": "opencode を起動",
+      "description": "プロジェクトディレクトリで次を実行します：",
+      "initNote": "初回起動時に、opencode は設定を読み込み、セッションを作成します。"
+    },
+
+    "commonIssues": {
+      "title": "よくある問題",
+
+      "commandNotFound": "1. コマンドが見つからない",
+      "commandNotFoundWindows": [
+        "npm でインストールした場合、npm のグローバル bin パスが PATH に含まれているか確認してください",
+        "新しいターミナルを開いて再試行してください"
+      ],
+      "commandNotFoundUnix": "インストール先を確認し、PATH に追加してください（例：~/.local/bin または npm のグローバル bin）",
+
+      "connectionFailed": "2. API 接続に失敗",
+      "updateCli": "3. opencode を更新"
+    }
+  },
+
   "droid": {
     "title": "Droid CLI 使用ガイド",
     "description": "Droid は Factory AI が開発したインタラクティブターミナル AI プログラミングアシスタントで、cch プロキシサービスを通じた統合をサポートしています。使用する前に、Droid 公式アカウントに登録してログインする必要があります。",

messages/ru/usage.json

@@ -473,6 +473,108 @@
     }
   },
 
+  "opencode": {
+    "title": "Руководство по OpenCode",
+    "description": "OpenCode — это CLI + TUI агент для программирования в терминале, также есть интеграции для IDE. Вы можете настроить OpenCode на cch как единый вход для доступа к моделям Claude, GPT и Gemini.",
+
+    "installation": {
+      "title": "Установка",
+
+      "macos": {
+        "description": "В macOS установите OpenCode одним из следующих способов:",
+        "homebrew": {
+          "title": "Способ 2: Homebrew",
+          "description": "Установка через Homebrew:"
+        }
+      },
+
+      "linux": {
+        "description": "В Linux установите OpenCode одним из следующих способов:",
+        "homebrew": {
+          "title": "Способ 2: Homebrew",
+          "description": "Установка через Homebrew:"
+        },
+        "paru": {
+          "title": "Способ 5: Paru (Arch Linux)",
+          "description": "Для Arch Linux можно установить через paru (AUR):"
+        }
+      },
+
+      "script": {
+        "title": "Способ 1: Официальный install-скрипт",
+        "description": "Выполните команду для установки последней версии:"
+      },
+
+      "npm": {
+        "title": "Способ 3: npm",
+        "description": "Глобальная установка через npm:"
+      },
+
+      "bun": {
+        "title": "Способ 4: Bun",
+        "description": "Глобальная установка через Bun:"
+      },
+
+      "windows": {
+        "description": "В Windows рекомендуем использовать пакетный менеджер (Chocolatey/Scoop), либо npm:",
+        "choco": {
+          "title": "Способ 1: Chocolatey",
+          "description": "Установка через Chocolatey:",
+          "command": "choco install opencode"
+        },
+        "scoop": {
+          "title": "Способ 2: Scoop",
+          "description": "Установка через Scoop:",
+          "command": "scoop bucket add extras\nscoop install extras/opencode"
+        },
+        "note": "Примечание: поддержка установки через Bun в Windows пока в процессе. Используйте Chocolatey/Scoop/npm или скачайте бинарник из GitHub Releases."
+      }
+    },
+
+    "configuration": {
+      "title": "Подключение к cch",
+
+      "configFile": {
+        "title": "Настройка opencode.json",
+        "path": "Путь к конфигурационному файлу:",
+        "instruction": "Отредактируйте файл и добавьте следующий контент (один файл покрывает все модели):",
+
+        "important": "Важно",
+        "importantPoints": [
+          "Создайте API key в панели cch и задайте переменную окружения CCH_API_KEY",
+          "Все provider используют ${resolvedOrigin}/v1 как baseURL (базовый URL cch v1 API)",
+          "При выборе модели используйте provider_id/model_id (например, cchClaude/claude-sonnet-4-5-20250929)"
+        ]
+      },
+
+      "modelSelection": {
+        "title": "Выбор модели",
+        "description": "После запуска OpenCode в TUI выполните команду для просмотра/выбора моделей:",
+        "command": "/models"
+      }
+    },
+
+    "startup": {
+      "title": "Запуск opencode",
+      "description": "В каталоге проекта выполните:",
+      "initNote": "При первом запуске opencode загрузит конфигурацию и создаст сессию."
+    },
+
+    "commonIssues": {
+      "title": "Типичные проблемы",
+
+      "commandNotFound": "1. Команда не найдена",
+      "commandNotFoundWindows": [
+        "Если установили через npm, убедитесь, что глобальный npm bin добавлен в PATH",
+        "Откройте новый терминал и повторите"
+      ],
+      "commandNotFoundUnix": "Проверьте путь установки и добавьте его в PATH (например, ~/.local/bin или глобальный npm bin)",
+
+      "connectionFailed": "2. Сбой подключения API",
+      "updateCli": "3. Обновление opencode"
+    }
+  },
+
   "droid": {
     "title": "Руководство по использованию Droid CLI",
     "description": "Droid - это интерактивный помощник программирования на основе ИИ, разработанный Factory AI, поддерживающий интеграцию через прокси-сервис cch. Перед использованием вы должны зарегистрировать и войти в свой официальный аккаунт Droid.",