docs: fix fallback model logic in installation instructions

Update all README files (English, Korean, Japanese, Chinese) to clarify that fallback models should depend on user's available credentials: - If Claude is available: use anthropic/claude-opus-4-5 as fallback - If Claude is NOT available: use opencode/big-pickle as fallback Previously, the fallback logic would hardcode claude-opus-4-5 for ChatGPT and Gemini questions, which would fail if users didn't have Claude access. 🤖 Generated with assistance of OhMyOpenCode
2025-12-19 19:16:42 +09:00
parent 2025f7e884
commit 346aba036f
4 changed files with 172 additions and 84 deletions
--- a/README.ja.md
+++ b/README.ja.md
@@ -156,12 +156,14 @@ Windows から Linux に初めて乗り換えた時のこと、自分の思い

 ### ステップ 0: セットアップについてユーザーに尋ねる

-OpenCode は様々なモデルをサポートしており、当プラグインは様々な最先端 LLM の使用を提案しています。そのため、ユーザーに以下の質問をする必要があります：
+OpenCode は様々なモデルをサポートしており、当プラグインは様々な最先端 LLM の使用を提案しています。そのため、ユーザーに以下の質問をする必要があります。
+
+**重要**: ユーザーがどのプロバイダーを持っているか追跡してください。ユーザーが Claude を持っていると確認した場合のみ、`anthropic/claude-opus-4-5` をフォールバックとして使用できます。Claude がない場合は、代わりに `opencode/big-pickle` をフォールバックとして使用してください。

 1. **Claude Pro/Max のサブスクリプションをお持ちですか？** お持ちでない場合、メインオーケストレーターモデルとして 'opencode/big-pickle' (GLM 4.6 として知られる) を使用することになります (非推奨)。
   - ユーザーが**「はい」**と答えた場合、追加質問: **max20 (20x モード) を使用していますか？**
-     - **「はい」 (max20)**: ToDo 追加: "ユーザーの Claude Pro/Max 認証設定" — librarian に Claude Sonnet 4.5 をフル使用
-     - **「いいえ」 (max20 ではない)**: ToDo 追加: "ユーザーの Claude Pro/Max 認証設定"、そして `~/.config/opencode/oh-my-opencode.json` に以下をマージ:
+     - **「はい」 (max20)**: ToDo 追加: "ユーザーの Claude Pro/Max 認証設定" — librarian に Claude Sonnet 4.5 をフル使用。**記憶: Claude がフォールバックとして使用可能。**
+     - **「いいえ」 (max20 ではない)**: ToDo 追加: "ユーザーの Claude Pro/Max 認証設定"、そして `~/.config/opencode/oh-my-opencode.json` に以下をマージ。**記憶: Claude がフォールバックとして使用可能。**
       ```json
       {
         "agents": {
@@ -169,7 +171,7 @@ OpenCode は様々なモデルをサポートしており、当プラグイン
         }
       }
       ```
-   - ユーザーが**「いいえ」** (Claude サブスクリプションなし) と答えた場合、`~/.config/opencode/oh-my-opencode.json` に以下を保存:
+   - ユーザーが**「いいえ」** (Claude サブスクリプションなし) と答えた場合、`~/.config/opencode/oh-my-opencode.json` に以下を保存。**記憶: Claude は使用不可 — すべてのフォールバックは `opencode/big-pickle` を使用する必要があります。**
     ```json
     {
       "agents": {
@@ -179,9 +181,10 @@ OpenCode は様々なモデルをサポートしており、当プラグイン
     }
     ```

-2. **ChatGPT のサブスクリプションをお持ちですか？** お持ちでない場合、oracle エージェントに 'anthropic/claude-opus-4-5' を使用することになります。
+2. **ChatGPT のサブスクリプションをお持ちですか？** お持ちでない場合、oracle エージェントにフォールバックモデルを使用することになります。
   - ユーザーが**「はい」**と答えた場合、ToDo 追加: "ユーザーの ChatGPT 認証設定"
-   - ユーザーが**「いいえ」**と答えた場合、`oh-my-opencode.json` に以下をマージ:
+   - ユーザーが**「いいえ」**と答えた場合:
+     - **Claude が使用可能な場合**: `oh-my-opencode.json` に以下をマージ:
       ```json
       {
         "agents": {
@@ -189,10 +192,19 @@ OpenCode は様々なモデルをサポートしており、当プラグイン
         }
       }
       ```
+     - **Claude が使用不可の場合**: `oh-my-opencode.json` に以下をマージ:
+       ```json
+       {
+         "agents": {
+           "oracle": { "model": "opencode/big-pickle" }
+         }
+       }
+       ```

 3. **Gemini モデルを統合しますか？** 統合しない場合、美しいデザインを享受できません。
   - ユーザーが**「はい」**と答えた場合、ToDo 追加: "Google OAuth 設定"
-   - ユーザーが**「いいえ」**と答えた場合、`oh-my-opencode.json` に以下をマージ:
+   - ユーザーが**「いいえ」**と答えた場合:
+     - **Claude が使用可能な場合**: `oh-my-opencode.json` に以下をマージ:
       ```json
       {
         "agents": {
@@ -202,6 +214,16 @@ OpenCode は様々なモデルをサポートしており、当プラグイン
         }
       }
       ```
+     - **Claude が使用不可の場合**: `oh-my-opencode.json` に以下をマージ:
+       ```json
+       {
+         "agents": {
+           "frontend-ui-ux-engineer": { "model": "opencode/big-pickle" },
+           "document-writer": { "model": "opencode/big-pickle" },
+           "multimodal-looker": { "model": "opencode/big-pickle" }
+         }
+       }
+       ```

 ### ステップ 1: OpenCode インストール確認

--- a/README.ko.md
+++ b/README.ko.md
@@ -153,12 +153,14 @@ OpenCode 가 낭만이 사라진것같은 오늘날의 시대에, 당신에게

 ### 0단계: 사용자에게 설정에 대해 물어보세요.

-OpenCode는 다양한 모델을 지원하며, 이 플러그인은 다양한 프론티어 LLM 사용을 제안합니다. 따라서 사용자에게 다음 질문을 해야 합니다:
+OpenCode는 다양한 모델을 지원하며, 이 플러그인은 다양한 프론티어 LLM 사용을 제안합니다. 따라서 사용자에게 다음 질문을 해야 합니다.
+
+**중요**: 사용자가 어떤 프로바이더를 가지고 있는지 추적하세요. 사용자가 Claude가 있다고 확인한 경우에만 `anthropic/claude-opus-4-5`를 폴백으로 사용할 수 있습니다. Claude가 없다면 `opencode/big-pickle`을 폴백으로 사용해야 합니다.

 1. **Claude Pro/Max 구독이 있으신가요?** 그렇지 않다면 메인 오케스트레이터 모델로 'opencode/big-pickle'(GLM 4.6으로 알려짐)을 사용하게 됩니다 (권장하지 않음).
   - 사용자가 **'예'**라고 답하면, 추가 질문: **max20 (20x 모드)를 사용하고 계신가요?**
-     - **'예' (max20)**: 할 일 추가: "사용자 Claude Pro/Max 인증 설정" — librarian에 Claude Sonnet 4.5 전체 사용
-     - **'아니오' (max20 아님)**: 할 일 추가: "사용자 Claude Pro/Max 인증 설정", 그리고 `~/.config/opencode/oh-my-opencode.json`에 다음을 병합:
+     - **'예' (max20)**: 할 일 추가: "사용자 Claude Pro/Max 인증 설정" — librarian에 Claude Sonnet 4.5 전체 사용. **기억: Claude를 폴백으로 사용 가능.**
+     - **'아니오' (max20 아님)**: 할 일 추가: "사용자 Claude Pro/Max 인증 설정", 그리고 `~/.config/opencode/oh-my-opencode.json`에 다음을 병합. **기억: Claude를 폴백으로 사용 가능.**
       ```json
       {
         "agents": {
@@ -166,7 +168,7 @@ OpenCode는 다양한 모델을 지원하며, 이 플러그인은 다양한 프
         }
       }
       ```
-   - 사용자가 **'아니오'** (Claude 구독 없음)라고 답하면, `~/.config/opencode/oh-my-opencode.json`에 다음을 저장:
+   - 사용자가 **'아니오'** (Claude 구독 없음)라고 답하면, `~/.config/opencode/oh-my-opencode.json`에 다음을 저장. **기억: Claude 사용 불가 — 모든 폴백은 `opencode/big-pickle`을 사용해야 함.**
     ```json
     {
       "agents": {
@@ -176,9 +178,10 @@ OpenCode는 다양한 모델을 지원하며, 이 플러그인은 다양한 프
     }
     ```

-2. **ChatGPT 구독이 있으신가요?** 그렇지 않다면 oracle 에이전트에 'anthropic/claude-opus-4-5'를 사용하게 됩니다.
+2. **ChatGPT 구독이 있으신가요?** 그렇지 않다면 oracle 에이전트에 폴백 모델을 사용하게 됩니다.
   - 사용자가 **'예'**라고 답하면, 할 일 추가: "사용자 ChatGPT 인증 설정"
-   - 사용자가 **'아니오'**라고 답하면, `oh-my-opencode.json`에 다음을 병합:
+   - 사용자가 **'아니오'**라고 답하면:
+     - **Claude가 사용 가능한 경우**: `oh-my-opencode.json`에 다음을 병합:
       ```json
       {
         "agents": {
@@ -186,10 +189,19 @@ OpenCode는 다양한 모델을 지원하며, 이 플러그인은 다양한 프
         }
       }
       ```
+     - **Claude가 사용 불가능한 경우**: `oh-my-opencode.json`에 다음을 병합:
+       ```json
+       {
+         "agents": {
+           "oracle": { "model": "opencode/big-pickle" }
+         }
+       }
+       ```

 3. **Gemini 모델을 통합하시겠습니까?** 그렇지 않다면 아름다운 디자인을 즐길 수 없습니다.
   - 사용자가 **'예'**라고 답하면, 할 일 추가: "Google OAuth 설정"
-   - 사용자가 **'아니오'**라고 답하면, `oh-my-opencode.json`에 다음을 병합:
+   - 사용자가 **'아니오'**라고 답하면:
+     - **Claude가 사용 가능한 경우**: `oh-my-opencode.json`에 다음을 병합:
       ```json
       {
         "agents": {
@@ -199,6 +211,16 @@ OpenCode는 다양한 모델을 지원하며, 이 플러그인은 다양한 프
         }
       }
       ```
+     - **Claude가 사용 불가능한 경우**: `oh-my-opencode.json`에 다음을 병합:
+       ```json
+       {
+         "agents": {
+           "frontend-ui-ux-engineer": { "model": "opencode/big-pickle" },
+           "document-writer": { "model": "opencode/big-pickle" },
+           "multimodal-looker": { "model": "opencode/big-pickle" }
+         }
+       }
+       ```

 ### 1단계: OpenCode 설치 확인

--- a/README.md
+++ b/README.md
@@ -181,12 +181,14 @@ follow these steps:

 ### Step 0: Ask user about the setup.

-Since OpenCode Supports various models, and our plugin suggests various frontier LLMs. Thus, you must ask user, following questions:
+Since OpenCode supports various models, and our plugin suggests various frontier LLMs, you must ask user the following questions.
+
+**IMPORTANT**: Track which providers the user has. Only use `anthropic/claude-opus-4-5` as fallback when the user confirmed they have Claude. If they don't have Claude, use `opencode/big-pickle` as fallback instead.

 1. **Do you have a Claude Pro/Max Subscription?** Otherwise, we'll use 'opencode/big-pickle' (known for GLM 4.6) as a main orchestrator model (not recommended)
   - If user said **yes**, ask follow-up: **Are you on max20 (20x mode)?**
-     - If **yes (max20)**: Add ToDo: "Setup user Claude Pro/Max Auth" — full Claude Sonnet 4.5 for librarian
-     - If **no (not max20)**: Add ToDo: "Setup user Claude Pro/Max Auth", then merge the following to `~/.config/opencode/oh-my-opencode.json`:
+     - If **yes (max20)**: Add ToDo: "Setup user Claude Pro/Max Auth" — full Claude Sonnet 4.5 for librarian. **Remember: Claude is available for fallbacks.**
+     - If **no (not max20)**: Add ToDo: "Setup user Claude Pro/Max Auth", then merge the following to `~/.config/opencode/oh-my-opencode.json`. **Remember: Claude is available for fallbacks.**
       ```json
       {
         "agents": {
@@ -194,7 +196,7 @@ Since OpenCode Supports various models, and our plugin suggests various frontier
         }
       }
       ```
-   - If user said **no** (no Claude subscription), merge the following to `~/.config/opencode/oh-my-opencode.json`:
+   - If user said **no** (no Claude subscription), merge the following to `~/.config/opencode/oh-my-opencode.json`. **Remember: Claude is NOT available — all fallbacks must use `opencode/big-pickle`.**
     ```json
     {
       "agents": {
@@ -204,9 +206,10 @@ Since OpenCode Supports various models, and our plugin suggests various frontier
     }
     ```

-2. **Do you have a ChatGPT Subscription?** Otherwise, we'll use 'anthropic/claude-opus-4-5' with 32k thinking option for oracle agent.
+2. **Do you have a ChatGPT Subscription?** Otherwise, we'll use a fallback model for oracle agent.
   - If user said **yes**, add ToDo: "Setup user ChatGPT Auth"
-   - If user said **no**, merge the following to `oh-my-opencode.json`:
+   - If user said **no**:
+     - **If Claude is available**: merge the following to `oh-my-opencode.json`:
       ```json
       {
         "agents": {
@@ -214,10 +217,19 @@ Since OpenCode Supports various models, and our plugin suggests various frontier
         }
       }
       ```
+     - **If Claude is NOT available**: merge the following to `oh-my-opencode.json`:
+       ```json
+       {
+         "agents": {
+           "oracle": { "model": "opencode/big-pickle" }
+         }
+       }
+       ```

 3. **Will you integrate Gemini models?** Otherwise, you cannot enjoy the beautiful design.
   - If user said **yes**, add ToDo: "Setup Google OAuth"
-   - If user said **no**, merge the following to `oh-my-opencode.json`:
+   - If user said **no**:
+     - **If Claude is available**: merge the following to `oh-my-opencode.json`:
       ```json
       {
         "agents": {
@@ -227,6 +239,16 @@ Since OpenCode Supports various models, and our plugin suggests various frontier
         }
       }
       ```
+     - **If Claude is NOT available**: merge the following to `oh-my-opencode.json`:
+       ```json
+       {
+         "agents": {
+           "frontend-ui-ux-engineer": { "model": "opencode/big-pickle" },
+           "document-writer": { "model": "opencode/big-pickle" },
+           "multimodal-looker": { "model": "opencode/big-pickle" }
+         }
+       }
+       ```

 ### Step 1: Install OpenCode, if not

--- a/README.zh-cn.md
+++ b/README.zh-cn.md
@@ -162,12 +162,14 @@ Install and configure by following the instructions here https://raw.githubuserc

 ### 步骤 0：摸清用户底细

-OpenCode 支持各种模型，我们这个插件也建议用各种前沿 LLM。所以先问清楚：
+OpenCode 支持各种模型，我们这个插件也建议用各种前沿 LLM。所以先问清楚。
+
+**重要**：追踪用户有哪些 provider。只有用户确认有 Claude 的情况下，才能用 `anthropic/claude-opus-4-5` 做 fallback。没有 Claude 就用 `opencode/big-pickle` 做 fallback。

 1. **有 Claude Pro/Max 订阅吗？** 没有的话，主编排模型只能用 'opencode/big-pickle'（也就是 GLM 4.6），这体验可不太好（不推荐）。
   - 用户说**有**，继续问：**你用的是 max20 (20x 模式) 吗？**
-     - **是 (max20)**：加个待办："配置用户 Claude Pro/Max 认证" — librarian 用完整的 Claude Sonnet 4.5
-     - **不是 (没有 max20)**：加个待办："配置用户 Claude Pro/Max 认证"，然后把这个合并到 `~/.config/opencode/oh-my-opencode.json`：
+     - **是 (max20)**：加个待办："配置用户 Claude Pro/Max 认证" — librarian 用完整的 Claude Sonnet 4.5。**记住：Claude 可以做 fallback。**
+     - **不是 (没有 max20)**：加个待办："配置用户 Claude Pro/Max 认证"，然后把这个合并到 `~/.config/opencode/oh-my-opencode.json`。**记住：Claude 可以做 fallback。**
       ```json
       {
         "agents": {
@@ -175,7 +177,7 @@ OpenCode 支持各种模型，我们这个插件也建议用各种前沿 LLM。
         }
       }
       ```
-   - 用户说**没有** (没有 Claude 订阅)，把这坨配置写到 `~/.config/opencode/oh-my-opencode.json`：
+   - 用户说**没有** (没有 Claude 订阅)，把这坨配置写到 `~/.config/opencode/oh-my-opencode.json`。**记住：没有 Claude — 所有 fallback 都得用 `opencode/big-pickle`。**
     ```json
     {
       "agents": {
@@ -185,9 +187,10 @@ OpenCode 支持各种模型，我们这个插件也建议用各种前沿 LLM。
     }
     ```

-2. **有 ChatGPT 订阅吗？** 没有的话，oracle Agent 就用 'anthropic/claude-opus-4-5' 带 32k thinking 了。
+2. **有 ChatGPT 订阅吗？** 没有的话，oracle Agent 就用 fallback 模型了。
   - 用户说**有**，加个待办："配置用户 ChatGPT 认证"
-   - 用户说**没有**，把这个合并到 `oh-my-opencode.json`：
+   - 用户说**没有**：
+     - **有 Claude 的情况下**：把这个合并到 `oh-my-opencode.json`：
       ```json
       {
         "agents": {
@@ -195,10 +198,19 @@ OpenCode 支持各种模型，我们这个插件也建议用各种前沿 LLM。
         }
       }
       ```
+     - **没有 Claude 的情况下**：把这个合并到 `oh-my-opencode.json`：
+       ```json
+       {
+         "agents": {
+           "oracle": { "model": "opencode/big-pickle" }
+         }
+       }
+       ```

 3. **要接 Gemini 模型吗？** 不接的话，那么漂亮的 UI 设计你就无福消受了。
   - 用户说**要**，加个待办："配置 Google OAuth"
-   - 用户说**不要**，把这个合并到 `oh-my-opencode.json`：
+   - 用户说**不要**：
+     - **有 Claude 的情况下**：把这个合并到 `oh-my-opencode.json`：
       ```json
       {
         "agents": {
@@ -208,6 +220,16 @@ OpenCode 支持各种模型，我们这个插件也建议用各种前沿 LLM。
         }
       }
       ```
+     - **没有 Claude 的情况下**：把这个合并到 `oh-my-opencode.json`：
+       ```json
+       {
+         "agents": {
+           "frontend-ui-ux-engineer": { "model": "opencode/big-pickle" },
+           "document-writer": { "model": "opencode/big-pickle" },
+           "multimodal-looker": { "model": "opencode/big-pickle" }
+         }
+       }
+       ```

 ### 步骤 1：确认 OpenCode 装没装