cc-switch/docs/user-manual/ja/2-providers/2.3-edit.md

2.3 プロバイダーの編集

編集パネルを開く

1. 編集したいプロバイダーカードを見つける
2. カードにマウスをホバーして操作ボタンを表示
3. 「編集」ボタンをクリック

編集可能な内容

基本情報

フィールド	説明
名前	プロバイダーの表示名
メモ	付加情報
Web サイトリンク	プロバイダーの公式サイトまたはコンソールアドレス
アイコン	カスタムアイコンと色

アイコンのカスタマイズ

CC Switch は豊富なアイコンカスタマイズ機能を提供しています：

アイコン選択画面

1. アイコンエリアをクリックしてアイコン選択画面を開く
2. 検索ボックスで名前からアイコンを検索
3. クリックしてアイコンを選択

アイコンライブラリには一般的な AI サービスプロバイダーと技術アイコンが含まれており、以下をサポートします：

• 名前によるあいまい検索
• アイコン名のツールチップ表示
• 選択結果のリアルタイムプレビュー

設定情報

JSON 形式の設定内容（以下を含む）：

• API Key
• エンドポイントアドレス
• その他の環境変数

現在有効なプロバイダーの編集

現在有効なプロバイダーを編集する場合、特別な「バックフィル」機能があります：

1. 編集パネルを開くと、live 設定ファイルから最新の内容を読み取る
2. CLI ツールで手動で設定を変更した場合、その変更が同期される
3. 保存すると、変更が live 設定ファイルに書き込まれる

これにより、CC Switch と CLI ツールの設定が常に同期されます。

API Key の変更

プロバイダーの編集時に、API Key 入力ボックスから直接変更できます：

1. プロバイダーカードの「編集」ボタンをクリック
2. 「API Key」入力ボックスに新しいキーを入力
3. 「保存」をクリック

ヒント：API Key 入力ボックスは表示/非表示の切り替えに対応しています。右側の目のアイコンをクリックするとキーの全文を確認できます。

エンドポイントアドレスの変更

プロバイダーの編集時に、エンドポイントアドレス 入力ボックスから直接変更できます：

1. プロバイダーカードの「編集」ボタンをクリック
2. 「エンドポイントアドレス」入力ボックスに新しい URL を入力
3. 「保存」をクリック

エンドポイントアドレスの形式

アプリ	形式の例
Claude	https://api.example.com
Codex	https://api.example.com/v1
Gemini	https://api.example.com

カスタムエンドポイントの追加

プロバイダーには複数のエンドポイントを設定でき、以下の用途に使用します：

• 速度テスト時に複数のアドレスをテスト
• フェイルオーバー時のバックアップエンドポイント

自動収集

プロバイダーの追加時に、CC Switch は設定からエンドポイントアドレスを自動抽出します。

手動追加

プロバイダーの編集時に、「エンドポイント管理」エリアで以下の操作が可能です：

• 新しいエンドポイントの追加
• 既存のエンドポイントの削除
• デフォルトエンドポイントの設定

JSON エディタ

設定は JSON 形式を使用し、エディタは以下を提供します：

• シンタックスハイライト
• フォーマット検証
• エラー通知

よくあるエラー

引用符の欠落：

// ❌ 間違い
{ env: { KEY: "value" } }

// ✅ 正しい
{ "env": { "KEY": "value" } }

余分なカンマ：

// ❌ 間違い
{ "env": { "KEY": "value", } }

// ✅ 正しい
{ "env": { "KEY": "value" } }

閉じ括弧の欠落：

// ❌ 間違い
{ "env": { "KEY": "value" }

// ✅ 正しい
{ "env": { "KEY": "value" } }

保存と反映

1. 「保存」ボタンをクリック
2. 現在有効なプロバイダーの場合、設定は即座に live ファイルに書き込まれる
3. CLI ツールを再起動して反映

編集のキャンセル

「キャンセル」ボタンをクリックするか Esc キーを押して編集パネルを閉じると、すべての変更は保存されません。