From 04bd15c9f86834c5e2acc46a973a7386994fb0bd Mon Sep 17 00:00:00 2001 From: Jason Date: Mon, 12 Oct 2026 00:20:53 +0800 Subject: [PATCH] =?UTF-8?q?fix(i18n):=20use=20=E8=A9=B3=E7=B4=B0=E3=82=AA?= =?UTF-8?q?=E3=83=97=E3=82=B7=E3=83=A7=E3=83=B3=20for=20the=20advanced=20o?= =?UTF-8?q?ptions=20toggle=20in=20Japanese?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 高級オプション reads as "luxury options" in Japanese. Rename the toggle and the docs that quote it (README_JA, the Japanese routing guides and the user manual FAQ). --- README_JA.md | 2 +- docs/guides/claude-codex-routing-guide-ja.md | 6 +++--- docs/guides/codex-claude-routing-guide-ja.md | 8 ++++---- docs/guides/codex-deepseek-routing-guide-ja.md | 4 ++-- docs/guides/codex-kimi-routing-guide-ja.md | 4 ++-- docs/guides/codex-official-auth-preservation-guide-ja.md | 4 ++-- docs/user-manual/ja/5-faq/5.2-questions.md | 2 +- src/i18n/locales/ja.json | 2 +- 8 files changed, 16 insertions(+), 16 deletions(-) diff --git a/README_JA.md b/README_JA.md index e98b29258..0d876c4f6 100644 --- a/README_JA.md +++ b/README_JA.md @@ -497,7 +497,7 @@ Codex では、CC Switch 内の「ChatGPT でログイン」から複数の Chat
Claude Code で OpenAI 互換 API、Gemini、ローカルモデルを使えますか？ -使えますが、ルーティングを使う必要があります。プロバイダを編集する際に、「高級オプション」の「上流フォーマット」でプロバイダに合った API 形式を選んでください。Chat Completions API のみを提供するサービス（多くのローカルモデルサービスがこれに当たります）は「OpenAI Chat Completions」、Responses API を提供するサービスは「OpenAI Responses API」、Gemini は「Gemini Native generateContent」を選びます。その後、Claude Code のページの「ルーティング」タブで「ルーティングを開始」をクリックしてください。形式の選択を誤ったり、ルーティングを開始していなかったりすると、通常は 404 または 405 エラーになります。 +使えますが、ルーティングを使う必要があります。プロバイダを編集する際に、「詳細オプション」の「上流フォーマット」でプロバイダに合った API 形式を選んでください。Chat Completions API のみを提供するサービス（多くのローカルモデルサービスがこれに当たります）は「OpenAI Chat Completions」、Responses API を提供するサービスは「OpenAI Responses API」、Gemini は「Gemini Native generateContent」を選びます。その後、Claude Code のページの「ルーティング」タブで「ルーティングを開始」をクリックしてください。形式の選択を誤ったり、ルーティングを開始していなかったりすると、通常は 404 または 405 エラーになります。 逆に、Codex や Grok Build の「上流フォーマット」で「Anthropic Messages」を選ぶと、Claude 形式のプロバイダを使えます。この場合もルーティングが必要です。詳しくは [Claude Code で GPT を使う](docs/guides/claude-codex-routing-guide-ja.md) と [Codex で Claude を使う](docs/guides/codex-claude-routing-guide-ja.md) をご覧ください。 diff --git a/docs/guides/claude-codex-routing-guide-ja.md b/docs/guides/claude-codex-routing-guide-ja.md index 40fda6a82..5227dc559 100644 --- a/docs/guides/claude-codex-routing-guide-ja.md +++ b/docs/guides/claude-codex-routing-guide-ja.md @@ -39,14 +39,14 @@ CC Switch を開き、上部の `Claude Code` タブへ切り替え、右上の - **API Key**: あなたのゲートウェイの Key。実際の Key は CC Switch 内にのみ保存され、ローカルルートが転送時に注入します。 - **API エンドポイント**: ゲートウェイのサービスルートアドレスを入力すれば十分です。たとえば `https://gpt-gateway.example.com`。末尾にスラッシュを付けないでください。ルートが自動的にそのゲートウェイの Responses エンドポイント（`/v1/responses`）へリクエストを送ります。ゲートウェイのパスが特殊な場合は、隣の `フル URL` スイッチをオンにして、完全なエンドポイントをそのまま貼り付けてください。 -続いて `高級オプション` を展開します： +続いて `詳細オプション` を展開します： - **API フォーマット**: デフォルトの `Anthropic Messages（ネイティブ）` から **`OpenAI Responses API（ルーティングが必要）`** に変更します。ゲートウェイが Chat Completions プロトコルしか提供していない場合は、ここで `OpenAI Chat Completions（ルーティングが必要）` を選びます。その他のステップはまったく同じです。 - **認証フィールド**: デフォルトの `ANTHROPIC_AUTH_TOKEN（デフォルト）` のままにします。ルートは `Authorization: Bearer ` を上流へ送ります——これはまさに OpenAI 互換ゲートウェイが期待する認証ヘッダーです。ゲートウェイのドキュメントが明確に `x-api-key` を要求している場合を除き、`ANTHROPIC_API_KEY` に変更しないでください。誤って変更した場合の典型的な症状は 401/403 です。 - **モデルマッピング**: Claude Code のモデル役割を、ゲートウェイが認識する実際のモデルへマッピングします。**少なくとも `既定フォールバックモデル` は入力してください**（たとえば `gpt-5.6`。ゲートウェイのドキュメントに従ってください）——空欄のままだと、一致しなかったリクエストは元の Claude モデル名のまま上流へ転送されてエラーになります。個別に設定していない役割はこのフォールバックへ回帰します。より細かく設定するには、行ごとに指定します：`Sonnet`/`Opus` に主力モデル、`Haiku` に安価で高速なモデル（Claude Code のバックグラウンド小タスクがこの区分を使います）。`表示名` は `/model` メニューでの表示にのみ影響し、空欄なら実際のモデル名がそのまま表示されます。 - **1M 対応を宣言**: モデルマッピングの各行にある `1M` チェックボックスは、その区分が 1M コンテキストに対応していることを Claude Code に宣言します。ゲートウェイが実際に 100 万トークン以上のウィンドウでそのモデルを提供している場合（たとえば API 仕様どおりに gpt-5.6 を提供するゲートウェイ）にのみチェックしてください。そうでないと、長い対話が上流の実際の上限で直接エラーになります。 -![方式 1: 高級オプションで API フォーマットを OpenAI Responses に設定し、認証フィールドはデフォルトのまま、上流の実際のモデルへマッピングする](../images/claude-codex-routing/02-responses-provider-form.png) +![方式 1: 詳細オプションで API フォーマットを OpenAI Responses に設定し、認証フィールドはデフォルトのまま、上流の実際のモデルへマッピングする](../images/claude-codex-routing/02-responses-provider-form.png) 保存すると、カードに `ルーティングが必要` のマークが表示されます——この種のプロバイダーは、ローカルルーティングが実行中でなければ正しく動作しません。 @@ -100,7 +100,7 @@ Claude Code に入ったら、段階的に確認できます： **上流が 401 または 403 を返す（方式 1）** -まず高級オプションの `認証フィールド` がデフォルトの `ANTHROPIC_AUTH_TOKEN（デフォルト）` になっているか確認してください——`ANTHROPIC_API_KEY` に変更すると `x-api-key` で送信され、大多数の OpenAI 互換ゲートウェイはこれを受け付けません。あわせて、Key 自体が有効で残高があることも確認してください。 +まず詳細オプションの `認証フィールド` がデフォルトの `ANTHROPIC_AUTH_TOKEN（デフォルト）` になっているか確認してください——`ANTHROPIC_API_KEY` に変更すると `x-api-key` で送信され、大多数の OpenAI 互換ゲートウェイはこれを受け付けません。あわせて、Key 自体が有効で残高があることも確認してください。 **`gpt-5.6-luna` などの新しいモデルをリクエストすると 404 Model not found が出る（方式 2）** diff --git a/docs/guides/codex-claude-routing-guide-ja.md b/docs/guides/codex-claude-routing-guide-ja.md index b1d28b169..39e43be71 100644 --- a/docs/guides/codex-claude-routing-guide-ja.md +++ b/docs/guides/codex-claude-routing-guide-ja.md @@ -38,13 +38,13 @@ CC Switch を開き、上部の `Codex` タブへ切り替え、右上のプラ - **API エンドポイント**: ゲートウェイのルートアドレスを入力すれば十分です。たとえば `https://claude-gateway.example.com`。`/v1` は付けても付けなくても正しく処理され、ルートが自動的に `/v1/messages` へリクエストを送ります。自分で `/v1/messages` を組み立てないでください（ゲートウェイのドキュメントが完全な messages URL を指定している場合は、隣の `フル URL` スイッチをオンにしてそのまま貼り付けても構いません）。アドレス欄の下に表示される「OpenAI Response 互換」という黄色のヒントは Responses 直結向けの汎用文言です。Anthropic フォーマットを選ぶ場合は本記事のとおりに入力してください。 - **デフォルトモデル**: ゲートウェイが認識する Claude モデル ID を入力します。たとえば `claude-sonnet-5`。ゲートウェイのドキュメントにあるモデル名に従ってください。 -続いて `高級オプション` を展開し、`上流フォーマット` をデフォルトの `Responses（ネイティブ）` から **`Anthropic Messages（ルーティング必須）`** に変更します。 +続いて `詳細オプション` を展開し、`上流フォーマット` をデフォルトの `Responses（ネイティブ）` から **`Anthropic Messages（ルーティング必須）`** に変更します。 ![Claude ゲートウェイの Codex プロバイダーフォーム](../images/codex-claude-routing/02-claude-codex-provider-form.png) Anthropic Messages を選ぶと、下に 3 つの関連フィールドが追加で表示されます： -![Anthropic 上流の高級オプション](../images/codex-claude-routing/03-anthropic-advanced-options.png) +![Anthropic 上流の詳細オプション](../images/codex-claude-routing/03-anthropic-advanced-options.png) - **認証フィールド**: API Key をどのヘッダーで上流へ送るかを決めます。送信されるのはどちらか一方のみで、ゲートウェイのドキュメントに従って選びます。 - `ANTHROPIC_AUTH_TOKEN（Authorization）`: `Authorization: Bearer ` を送信します。デフォルト値で、多くの Claude 系中継ゲートウェイがこの方式を使います。 @@ -103,7 +103,7 @@ API エンドポイントを確認してください。ゲートウェイのル **回答が途中で切り詰められることが多い** -これはデフォルトの 8192 出力上限の現れです。プロバイダーフォームの高級オプションにある `最大出力トークン` で引き上げ（モデル / ゲートウェイの実際の上限を超えないように）、保存してから再試行してください。 +これはデフォルトの 8192 出力上限の現れです。プロバイダーフォームの詳細オプションにある `最大出力トークン` で引き上げ（モデル / ゲートウェイの実際の上限を超えないように）、保存してから再試行してください。 **`/model` に Claude モデルが表示されない** @@ -115,7 +115,7 @@ API エンドポイントを確認してください。ゲートウェイのル **Claude Code でしか使えないというエラーが出る** -一部のプロバイダーは、その Claude API を Claude Code クライアント内でのみ利用できるよう制限しており、本ガイドの経路で Codex から使うと拒否されます。高級オプションの `Claude Code クライアントを模倣` スイッチをオンにして試すことはできますが、それでもエラーになる場合、制限はプロバイダーのサーバー側にあります。その Key を Claude Code 以外で使えるかどうか、プロバイダーへ問い合わせて確認してください。通常のゲートウェイでは、このスイッチはオフのままにしてください。 +一部のプロバイダーは、その Claude API を Claude Code クライアント内でのみ利用できるよう制限しており、本ガイドの経路で Codex から使うと拒否されます。詳細オプションの `Claude Code クライアントを模倣` スイッチをオンにして試すことはできますが、それでもエラーになる場合、制限はプロバイダーのサーバー側にあります。その Key を Claude Code 以外で使えるかどうか、プロバイダーへ問い合わせて確認してください。通常のゲートウェイでは、このスイッチはオフのままにしてください。 ## コンプライアンスに関する注意 diff --git a/docs/guides/codex-deepseek-routing-guide-ja.md b/docs/guides/codex-deepseek-routing-guide-ja.md index 263fc2b29..d47cff180 100644 --- a/docs/guides/codex-deepseek-routing-guide-ja.md +++ b/docs/guides/codex-deepseek-routing-guide-ja.md @@ -55,7 +55,7 @@ CC Switch を開き、上部の `Codex` タブへ切り替え、右上のプラ **プリセットを使う**（推奨）: プリセット一覧から対象プロバイダーを選び、API Key を入力して保存するだけです。プリセットにはリクエスト先、デフォルトモデル、モデルメニューがすでに含まれ、上流フォーマットも自動的に設定されます。Chat 形式のプリセットは保存するとカードに `ルーティングが必要` バッジが表示されます。thinking / reasoning パラメータもプリセットで設定済みのため、手動入力は不要です。 -**カスタム設定を使う**: 相手側のドキュメントに従って API Key と base URL を入力し、フォーム下部の `高級オプション` を展開して、`上流フォーマット` を `Chat Completions（ルーティング必須）` に設定します。このドロップダウンには 3 つの選択肢があります： +**カスタム設定を使う**: 相手側のドキュメントに従って API Key と base URL を入力し、フォーム下部の `詳細オプション` を展開して、`上流フォーマット` を `Chat Completions（ルーティング必須）` に設定します。このドロップダウンには 3 つの選択肢があります： - `Responses（ネイティブ）`——上流が Responses API をネイティブにサポートしている場合。変換なしで直結でき、ルーティングは不要です。 - `Chat Completions（ルーティング必須）`——本記事が扱うケースです。 @@ -65,7 +65,7 @@ CC Switch を開き、上部の `Codex` タブへ切り替え、右上のプラ > **既存の DeepSeek プロバイダーを移行する場合**: `上流フォーマット` を `Responses（ネイティブ）` に変更するだけでよく、削除して作り直す必要はありません。次回そのプロバイダーへ切り替えたとき、CC Switch が `deepseek.com` のアドレスを認識して DeepSeek 公式のモデルカタログを適用するため、freeform `apply_patch`、GPT-5 harness、low/high/max の思考レベル、web_search はいずれも通常どおり有効になります。 > -> 唯一わずかに異なるのはコンテキストウィンドウです。プロバイダー自身が保存したモデル行のほうが優先されるため、3.19.1 より前に保存された `1000000` が公式宣言の `1048576` を上書きし、4 万トークン強が失われます。気になる場合は `高級オプション` → `モデルマッピング` でその行の `コンテキストウィンドウ` を `1048576` に変更するか、いっそプリセットから新規作成してください。 +> 唯一わずかに異なるのはコンテキストウィンドウです。プロバイダー自身が保存したモデル行のほうが優先されるため、3.19.1 より前に保存された `1000000` が公式宣言の `1048576` を上書きし、4 万トークン強が失われます。気になる場合は `詳細オプション` → `モデルマッピング` でその行の `コンテキストウィンドウ` を `1048576` に変更するか、いっそプリセットから新規作成してください。 > > なお、直結で使われる公式モデルカタログは Codex CLI **0.144.0 以降**を必要とします（カタログに含まれる freeform `apply_patch` の登録がこのバージョンを要求します）。CC Switch はこれを検証しません。また、生成されるカタログファイルは GPT-5 harness の全文を含むため 75 KB 程度まで大きくなります。 diff --git a/docs/guides/codex-kimi-routing-guide-ja.md b/docs/guides/codex-kimi-routing-guide-ja.md index fe56864ec..af0a5759e 100644 --- a/docs/guides/codex-kimi-routing-guide-ja.md +++ b/docs/guides/codex-kimi-routing-guide-ja.md @@ -55,7 +55,7 @@ CC Switch を開き、上部の `Codex` タブへ切り替え、右上のプラ ![Kimi Codex プロバイダーフォームの上流フォーマット設定](../images/codex-kimi-routing/02-kimi-codex-routing-form.png) -プリセットには Kimi のリクエスト先、デフォルトモデル、モデルメニュー、thinking/reasoning パラメータがすでに含まれており、`高級オプション` の `上流フォーマット` も `Chat Completions（ルーティング必須）` にプリセットされています。必要に応じてデフォルトモデルやモデル表示名を調整できます。たとえばオープンプラットフォームのプリセットはデフォルトが `kimi-k2.7-code` で、公式ドキュメントに従って `kimi-k2.7-code-highspeed` に変更することもできます。プロトコル変換はルーティング層に任せれば十分です。 +プリセットには Kimi のリクエスト先、デフォルトモデル、モデルメニュー、thinking/reasoning パラメータがすでに含まれており、`詳細オプション` の `上流フォーマット` も `Chat Completions（ルーティング必須）` にプリセットされています。必要に応じてデフォルトモデルやモデル表示名を調整できます。たとえばオープンプラットフォームのプリセットはデフォルトが `kimi-k2.7-code` で、公式ドキュメントに従って `kimi-k2.7-code-highspeed` に変更することもできます。プロトコル変換はルーティング層に任せれば十分です。 ## Step 2: ローカルルーティングを有効にして Codex をルーティングする @@ -81,7 +81,7 @@ Codex に入ったら、`/model` で現在のモデルが Kimi プリセット ## 他の Chat プロバイダーの場合 -SiliconFlow、ModelScope など一般的な Chat 形式プロバイダーは CC Switch にプリセットがあるため、まずはプリセットを使ってください。プリセットにないプロバイダーだけ、カスタム設定を選びます。その場合は相手側のドキュメントに従って API Key、base URL、モデルを入力し、`高級オプション` の `上流フォーマット` を `Chat Completions（ルーティング必須）` に設定します。 +SiliconFlow、ModelScope など一般的な Chat 形式プロバイダーは CC Switch にプリセットがあるため、まずはプリセットを使ってください。プリセットにないプロバイダーだけ、カスタム設定を選びます。その場合は相手側のドキュメントに従って API Key、base URL、モデルを入力し、`詳細オプション` の `上流フォーマット` を `Chat Completions（ルーティング必須）` に設定します。 上流が OpenAI Responses API を直接サポートしている場合は、`上流フォーマット` を `Responses` にすれば、CC Switch は Responses のまま直結でき、Chat 変換は行いません。 diff --git a/docs/guides/codex-official-auth-preservation-guide-ja.md b/docs/guides/codex-official-auth-preservation-guide-ja.md index fab2dcf74..903e89b72 100644 --- a/docs/guides/codex-official-auth-preservation-guide-ja.md +++ b/docs/guides/codex-official-auth-preservation-guide-ja.md @@ -83,7 +83,7 @@ Codex パネルに戻り、右上のプラスボタンからプロバイダー - **バッジなし**: 上流が OpenAI Responses API をネイティブにサポートしており、直結できるため、ローカルルーティングは不要です。DeepSeek、Kimi、MiniMax、Zhipu GLM、千问AI平台 のプリセット、そして GPT モデルを提供する中継サービスは、いずれもこちらに当たります。 - **`ルーティングが必要` バッジあり**: 上流フォーマットが `Chat Completions（ルーティング必須）` のもので、たとえば SiliconFlow、ModelScope です。この種のプロバイダーはローカルルーティングを必ず有効化し、CC Switch が Codex の Responses リクエストを Chat Completions リクエストへ変換できるようにしてください。 -カスタムプロバイダーの上流フォーマットは、フォーム下部の `高級オプション` → `上流フォーマット` で選択します。 +カスタムプロバイダーの上流フォーマットは、フォーム下部の `詳細オプション` → `上流フォーマット` で選択します。 ## Step 4: 必要に応じてローカルルーティングと Codex ルーティングを有効化する @@ -196,7 +196,7 @@ Codex のモデルカタログは起動時に読み込まれます。CC Switch **サードパーティリクエストが 404 になる、モデル一覧が違う、ストリーミング応答がおかしい場合は？** -そのプロバイダーが Chat Completions プロトコルの場合、プロバイダーフォームの `高級オプション` にある `上流フォーマット` が `Chat Completions（ルーティング必須）` になっていること、さらに `設定 → ルーティング` でルーティング総スイッチと Codex ルーティングがオンになっていることを確認してください。 +そのプロバイダーが Chat Completions プロトコルの場合、プロバイダーフォームの `詳細オプション` にある `上流フォーマット` が `Chat Completions（ルーティング必須）` になっていること、さらに `設定 → ルーティング` でルーティング総スイッチと Codex ルーティングがオンになっていることを確認してください。 **ローカルルーティング中に OpenAI Official へ戻せますか？** diff --git a/docs/user-manual/ja/5-faq/5.2-questions.md b/docs/user-manual/ja/5-faq/5.2-questions.md index 71f8768b1..3c9b2324f 100644 --- a/docs/user-manual/ja/5-faq/5.2-questions.md +++ b/docs/user-manual/ja/5-faq/5.2-questions.md @@ -82,7 +82,7 @@ Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build は同時に 1 ### Claude Code で OpenAI 互換インターフェース、Gemini、ローカルモデルを使うには -ルーティングが必要です。プロバイダーを編集し、「高級オプション」の「上流フォーマット」でプロバイダーのインターフェースに合うフォーマットを選びます。Chat Completions インターフェースしか提供しないサービスは「OpenAI Chat Completions」、Responses インターフェースを提供するものは「OpenAI Responses API」、Gemini は「Gemini Native generateContent」を選択します。そのうえで、Claude Code ページの「ルーティング」タブで「ルーティングを開始」をクリックします。フォーマットを間違えたり、ルーティングを開始していなかったりすると、通常は 404 または 405 エラーになります。 +ルーティングが必要です。プロバイダーを編集し、「詳細オプション」の「上流フォーマット」でプロバイダーのインターフェースに合うフォーマットを選びます。Chat Completions インターフェースしか提供しないサービスは「OpenAI Chat Completions」、Responses インターフェースを提供するものは「OpenAI Responses API」、Gemini は「Gemini Native generateContent」を選択します。そのうえで、Claude Code ページの「ルーティング」タブで「ルーティングを開始」をクリックします。フォーマットを間違えたり、ルーティングを開始していなかったりすると、通常は 404 または 405 エラーになります。 ### API Key が無効 diff --git a/src/i18n/locales/ja.json b/src/i18n/locales/ja.json index a896a7c00..66459cd00 100644 --- a/src/i18n/locales/ja.json +++ b/src/i18n/locales/ja.json @@ -1679,7 +1679,7 @@ "fallbackModelMissing": "未設定です。どの枠にも当たらないリクエストが元の Claude モデル名で上流へ送られ、エラーになることがあります。", "quickSetModels": "一括設定", "quickSetSuccess": "モデル名をすべての役割に適用しました", - "advancedOptionsToggle": "高級オプション", + "advancedOptionsToggle": "詳細オプション", "categoryOfficial": "公式", "categoryCnOfficial": "オープンソース公式", "categoryAggregation": "アグリゲーター",