fix(i18n): use 詳細オプション for the advanced options toggle in Japanese

高級オプション 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).
2026-10-25 17:22:27 +08:00 · 2026-10-12 00:20:53 +08:00
1 parent 3302cc2dfd
commit 04bd15c9f8
@@ -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 <key>` を上流へ送ります——これはまさに 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）**

@@ -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 <key>` を送信します。デフォルト値で、多くの 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 以外で使えるかどうか、プロバイダーへ問い合わせて確認してください。通常のゲートウェイでは、このスイッチはオフのままにしてください。

 ## コンプライアンスに関する注意

@@ -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 程度まで大きくなります。

@@ -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 変換は行いません。

@@ -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 へ戻せますか？**

@@ -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 が無効