admin/CC-Switch
1
0
Fork 0
mirror of https://github.com/farion1231/cc-switch.git synced 2026-07-24 21:30:17 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
60343cec2c80767c09d192e1af2c3f6243b99740
CC-Switch/docs/user-manual/ja
T
History
Jason 94cc3d103a Align Claude Desktop model mapping with Claude Code three-role tiers 
Claude Desktop's 3P validation only accepts claude-{sonnet,opus,haiku}-*
role IDs, so providers must map every tier. Bring the Desktop mapping flow
in line with Claude Code and fix the fallout that broke sub-agent Haiku calls.

- Proxy form: replace the dynamic route list with fixed Sonnet/Opus/Haiku
  tiers; blank tiers backfill from the first filled tier (Sonnet first) on
  submit and inherit its supports1m flag
- Backend: add a role-keyword fallback in map_proxy_request_model so dated
  official names (e.g. claude-haiku-4-5-20251001) resolve to the right tier,
  guarded by is_claude_safe_model_id so [1m]-suffixed IDs stay rejected
- Tighten is_claude_safe_model_id / isClaudeSafeRoute to reject degenerate
  role IDs like "claude-sonnet-"
- Fix the seed-effect race where normalizing empty routes to three blank
  tiers blocked the default-route backfill
- Sync switch hints, placeholders, and the zh/en/ja/zh-TW locales to the
  three-role-ID rule
- Update zh/en/ja user manual (2.1, 2.6), calling out legacy Claude IDs
  (claude-3-5-sonnet-...) as a rejected example

Tests: 282 frontend + 34 backend claude_desktop; typecheck, clippy, fmt clean.
2026-05-29 22:52:25 +08:00
..
1-getting-started
docs: update settings manual for tool management and Hermes
2026-05-25 22:20:34 +08:00
2-providers
Align Claude Desktop model mapping with Claude Code three-role tiers
2026-05-29 22:52:25 +08:00
3-extensions
- docs: update user manual for v3.15.0
2026-05-18 16:59:13 +08:00
4-proxy
Upgrade default Claude Opus model to 4.8
2026-05-29 22:52:25 +08:00
5-faq
docs(user-manual): update to v3.13.0 across en/zh/ja
2026-04-09 16:49:14 +08:00
README.md
- docs: update user manual for v3.15.0
2026-05-18 16:59:13 +08:00

README.md

CC Switch ユーザーマニュアル

Claude Code / Claude Desktop / Codex / Gemini CLI / OpenCode / OpenClaw / Hermes オールインワンアシスタント

目次構成

CC Switch ユーザーマニュアル
│
├── 1. はじめに
│   ├── 1.1 ソフトウェア紹介
│   ├── 1.2 インストールガイド
│   ├── 1.3 インターフェース概要
│   ├── 1.4 クイックスタート
│   └── 1.5 個人設定
│
├── 2. プロバイダー管理
│   ├── 2.1 プロバイダーの追加
│   ├── 2.2 プロバイダーの切り替え
│   ├── 2.3 プロバイダーの編集
│   ├── 2.4 並べ替えと複製
│   ├── 2.5 使用量クエリ
│   └── 2.6 Claude Desktop
│
├── 3. 拡張機能
│   ├── 3.1 MCP サーバー管理
│   ├── 3.2 Prompts プロンプト管理
│   ├── 3.3 Skills スキル管理
│   ├── 3.4 セッションマネージャー
│   └── 3.5 ワークスペースとメモリー
│
├── 4. プロキシと高可用性
│   ├── 4.1 プロキシサービス
│   ├── 4.2 アプリケーション接管
│   ├── 4.3 フェイルオーバー
│   ├── 4.4 使用量統計
│   └── 4.5 モデルテスト
│
└── 5. よくある質問
    ├── 5.1 設定ファイルの説明
    ├── 5.2 FAQ
    ├── 5.3 ディープリンクプロトコル
    └── 5.4 環境変数の競合

ファイル一覧

1. はじめに

ファイル 内容
1.1-introduction.md ソフトウェア紹介、主要機能、対応プラットフォーム
1.2-installation.md Windows/macOS/Linux インストールガイド
1.3-interface.md インターフェースレイアウト、ナビゲーションバー、プロバイダーカードの説明
1.4-quickstart.md 5 分でできるクイックスタートチュートリアル
1.5-settings.md 言語、テーマ、ディレクトリ、クラウド同期の設定

2. プロバイダー管理

ファイル 内容
2.1-add.md プリセットの使用、カスタム設定、統一プロバイダー
2.2-switch.md メイン画面での切り替え、トレイでの切り替え、反映方法
2.3-edit.md 設定の編集、API Key の変更、バックフィル機能
2.4-sort-duplicate.md ドラッグで並べ替え、プロバイダーの複製、削除
2.5-usage-query.md 使用量クエリ、残額表示、複数プラン表示
2.6-claude-desktop.md Claude Desktop サードパーティプロバイダー、直結モード、モデルマッピング

3. 拡張機能

ファイル 内容
3.1-mcp.md MCP プロトコル、サーバーの追加、アプリバインド
3.2-prompts.md プリセットの作成、有効化の切り替え、スマートバックフィル
3.3-skills.md スキルの発見、インストール・アンインストール、リポジトリ管理
3.4-sessions.md セッションマネージャー：閲覧、検索、再開、削除
3.5-workspace.md ワークスペースファイルとデイリーメモリー（OpenClaw）

4. プロキシと高可用性

ファイル 内容
4.1-service.md プロキシの起動、設定項目、実行状態
4.2-routing.md アプリケーションルーティング、設定変更、ステータス表示
4.3-failover.md フェイルオーバーキュー、サーキットブレーカー、ヘルスステータス
4.4-usage.md 使用量統計、トレンドグラフ、料金設定
4.5-model-test.md モデルテスト、ヘルスチェック、レイテンシテスト

5. よくある質問

ファイル 内容
5.1-config-files.md CC Switch のストレージ、CLI 設定ファイル形式
5.2-questions.md よくある質問と回答
5.3-deeplink.md ディープリンクプロトコル、生成と使用方法
5.4-env-conflict.md 環境変数の競合検出と対処

クイックリンク

バージョン情報

  • ドキュメントバージョン：v3.15.0
  • 最終更新：2026-05-16
  • CC Switch v3.15.0+ 対応

v3.15.0 の注目機能

  • Claude Desktop の一等管理パネル：サードパーティプロバイダー、直結 / モデルマッピングの 2 モード、Copilot / Codex OAuth 再利用、3P profile 書き込みに対応 — 詳細は 2.6 Claude Desktop
  • 役割別モデルマッピング：Sonnet / Opus / Haiku ルートと supports1m フラグで Claude Desktop のモデル検証に対応
  • Claude Desktop ローカルルーティング：変換が必要なプロバイダー向けに 127.0.0.1:15721/claude-desktop のローカルゲートウェイを提供
  • ルーティング対応バッジ：Claude Code / Codex のプロバイダーカードで Local Routing 対応可否を確認可能
  • Codex OAuth ライブモデル検出：ChatGPT Codex 系プロバイダーは必要に応じて ChatGPT バックエンドから利用可能モデルを取得
  • フィルター連動 Usage Hero：キャッシュ正規化後の実消費 Token とキャッシュヒット率を表示し、日付 / プロバイダー / モデルフィルターに追従 — 詳細は 4.4 使用量統計
  • 軽量モード：トレイへ最小化時にメインウィンドウを破棄、アイドル時のリソース使用量をほぼゼロに — 詳細は 1.5 個人設定
  • クォータ・残高表示：公式サブスクリプション系（Claude/Codex/Gemini/Copilot/Codex OAuth）はカードに自動表示、Token Plan および第三者残高は内蔵テンプレートでワンクリック有効化 — 詳細は 2.5 使用量クエリ
  • Codex OAuth リバースプロキシ：ChatGPT アカウントで Claude Code 内から Codex サービスを再利用 — 詳細は 2.1 プロバイダーの追加
  • アプリ別トレイサブメニュー：Claude / Codex / Gemini のサブメニューで現在のプロバイダーと使用量サマリーを確認可能 — 詳細は 2.2 プロバイダーの切り替え
  • Skills の発見と一括更新：SHA-256 ハッシュによる更新検出、一括更新、skills.sh 公式レジストリ検索 — 詳細は 3.3 Skills スキル管理
  • 完全URLエンドポイントモード：高度なオプションで base_url を完全なアップストリームエンドポイントとして扱う — 詳細は 2.1 プロバイダーの追加
  • OpenCode / OpenClaw ストリームチェック対応：Stream Check は Claude / Codex / Gemini / OpenCode / OpenClaw をカバー — 詳細は 4.5 モデルテスト

コントリビュート

Issue や PR でドキュメントの改善にご協力ください：

Reference in New Issue View Git Blame Copy Permalink