From ddde7f13b3a021ac51dad290ec3f396c7c61a1bf Mon Sep 17 00:00:00 2001 From: Jason Date: Sat, 16 May 2026 20:58:51 +0800 Subject: [PATCH] - docs: update user manual for v3.15.0 - Sync zh/en/ja manuals with Claude Desktop and Hermes support - Update install requirements, official channels, and release asset guidance - Document Usage Hero, Codex OAuth live models, Save Anyway, Hermes sessions, and Warp launch - Correct tray and app-scope descriptions to match current implementation --- .../en/1-getting-started/1.1-introduction.md | 11 +++++--- .../en/1-getting-started/1.2-installation.md | 26 +++++++++++++------ .../en/1-getting-started/1.3-interface.md | 10 ++++--- docs/user-manual/en/2-providers/2.1-add.md | 22 ++++++++++++---- docs/user-manual/en/2-providers/2.2-switch.md | 6 ++--- docs/user-manual/en/2-providers/2.3-edit.md | 5 ++-- .../en/2-providers/2.4-sort-duplicate.md | 2 ++ .../en/3-extensions/3.4-sessions.md | 8 +++--- docs/user-manual/en/4-proxy/4.4-usage.md | 7 ++++- docs/user-manual/en/4-proxy/4.5-model-test.md | 2 +- docs/user-manual/en/README.md | 9 ++++--- .../ja/1-getting-started/1.1-introduction.md | 11 +++++--- .../ja/1-getting-started/1.2-installation.md | 26 +++++++++++++------ .../ja/1-getting-started/1.3-interface.md | 10 ++++--- docs/user-manual/ja/2-providers/2.1-add.md | 22 ++++++++++++---- docs/user-manual/ja/2-providers/2.2-switch.md | 6 ++--- docs/user-manual/ja/2-providers/2.3-edit.md | 5 ++-- .../ja/2-providers/2.4-sort-duplicate.md | 2 ++ .../ja/3-extensions/3.4-sessions.md | 8 +++--- docs/user-manual/ja/4-proxy/4.4-usage.md | 7 ++++- docs/user-manual/ja/4-proxy/4.5-model-test.md | 2 +- docs/user-manual/ja/README.md | 9 ++++--- .../zh/1-getting-started/1.1-introduction.md | 11 +++++--- .../zh/1-getting-started/1.2-installation.md | 26 +++++++++++++------ .../zh/1-getting-started/1.3-interface.md | 10 ++++--- docs/user-manual/zh/2-providers/2.1-add.md | 22 ++++++++++++---- docs/user-manual/zh/2-providers/2.2-switch.md | 6 ++--- docs/user-manual/zh/2-providers/2.3-edit.md | 5 ++-- .../zh/2-providers/2.4-sort-duplicate.md | 2 ++ .../zh/3-extensions/3.4-sessions.md | 8 +++--- docs/user-manual/zh/4-proxy/4.4-usage.md | 7 ++++- docs/user-manual/zh/4-proxy/4.5-model-test.md | 2 +- docs/user-manual/zh/README.md | 9 ++++--- 33 files changed, 222 insertions(+), 102 deletions(-) diff --git a/docs/user-manual/en/1-getting-started/1.1-introduction.md b/docs/user-manual/en/1-getting-started/1.1-introduction.md index ba96e598a..cb9c582e8 100644 --- a/docs/user-manual/en/1-getting-started/1.1-introduction.md +++ b/docs/user-manual/en/1-getting-started/1.1-introduction.md @@ -2,14 +2,14 @@ ## What is CC Switch -CC Switch is a cross-platform desktop application designed for developers who use AI coding tools. It helps you centrally manage configurations for five major AI coding tools: **Claude Code**, **Codex**, **Gemini CLI**, **OpenCode**, and **OpenClaw**. +CC Switch is a cross-platform desktop application designed for developers who use AI coding tools. It helps you centrally manage configurations for **Claude Code**, **Claude Desktop**, **Codex**, **Gemini CLI**, **OpenCode**, **OpenClaw**, and **Hermes**. ## What Problems Does It Solve In your daily development workflow, you may encounter these pain points: - **Tedious multi-provider switching**: Using different API providers (official, proxy services) requires manually editing configuration files -- **Scattered configurations**: Claude, Codex, Gemini, OpenCode, and OpenClaw each have independent configuration files in different formats +- **Scattered configurations**: Claude Code, Claude Desktop, Codex, Gemini, OpenCode, OpenClaw, and Hermes each have independent configuration files in different formats - **No usage monitoring**: No visibility into how many API calls were made or how much they cost - **Service instability**: When a single provider goes down, your entire workflow is interrupted @@ -21,6 +21,7 @@ CC Switch solves these problems through a unified interface. - One-click switching between multiple API provider configurations - Preset templates for quickly adding common providers - Universal provider feature for sharing configurations across apps +- Claude Desktop third-party providers, direct mode, and model mapping - Usage query and balance display - Endpoint speed testing @@ -40,16 +41,18 @@ CC Switch solves these problems through a unified interface. | Application | Description | |-------------|-------------| | **Claude Code** | Anthropic's official AI coding assistant | +| **Claude Desktop** | Claude desktop app with official sign-in and third-party 3P profiles | | **Codex** | OpenAI's code generation tool | | **Gemini CLI** | Google's AI command-line tool | | **OpenCode** | Open-source AI coding terminal tool | | **OpenClaw** | Open-source AI coding assistant (multi-provider gateway) | +| **Hermes** | Hermes Agent provider, MCP, Skills, and Memory management | ## Supported Platforms - **Windows** 10 and above -- **macOS** 10.15 (Catalina) and above -- **Linux** Ubuntu 22.04+ / Debian 11+ / Fedora 34+ +- **macOS** 12 (Monterey) and above +- **Linux** Ubuntu 22.04+ / Debian 11+ / Fedora 34+ (x64 / ARM64) ## Technical Architecture diff --git a/docs/user-manual/en/1-getting-started/1.2-installation.md b/docs/user-manual/en/1-getting-started/1.2-installation.md index f4425b0e4..8040a2cc2 100644 --- a/docs/user-manual/en/1-getting-started/1.2-installation.md +++ b/docs/user-manual/en/1-getting-started/1.2-installation.md @@ -1,5 +1,15 @@ # 1.2 Installation Guide +## Official Channels and System Requirements + +Only download CC Switch from **[ccswitch.io](https://ccswitch.io)**, **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)**, or the project source repository. Any "CC Switch" site or client that asks for payment, top-ups, or login credentials is not official. + +| System | Minimum Version | Architecture | +|--------|-----------------|--------------| +| Windows | Windows 10 or later | x64 | +| macOS | macOS 12 (Monterey) or later | Intel (x64) / Apple Silicon (arm64) | +| Linux | See distribution notes below | x64 / ARM64 | + ## Prerequisites ### Install Node.js @@ -127,8 +137,8 @@ brew upgrade --cask cc-switch ### Option 2: Manual Download -1. Download `CC-Switch-v{version}-macOS.zip` -2. Extract to get `CC Switch.app` +1. Download `CC-Switch-v{version}-macOS.dmg` (recommended) or `CC-Switch-v{version}-macOS.zip` +2. Open the DMG, or extract the zip to get `CC Switch.app` 3. Drag it to the Applications folder ### Signed and Notarized @@ -151,11 +161,11 @@ yay -S cc-switch-bin ### Debian / Ubuntu -1. Download `CC-Switch-v{version}-Linux.deb` +1. Download `CC-Switch-v{version}-Linux-x86_64.deb` or `CC-Switch-v{version}-Linux-arm64.deb` for your architecture 2. Install: ```bash -sudo dpkg -i CC-Switch-v{version}-Linux.deb +sudo dpkg -i CC-Switch-v{version}-Linux-*.deb # If there are dependency issues sudo apt-get install -f @@ -163,17 +173,17 @@ sudo apt-get install -f ### AppImage (Universal) -1. Download `CC-Switch-v{version}-Linux.AppImage` +1. Download `CC-Switch-v{version}-Linux-x86_64.AppImage` or `CC-Switch-v{version}-Linux-arm64.AppImage` for your architecture 2. Add execute permission: ```bash -chmod +x CC-Switch-v{version}-Linux.AppImage +chmod +x CC-Switch-v{version}-Linux-*.AppImage ``` 3. Run: ```bash -./CC-Switch-v{version}-Linux.AppImage +./CC-Switch-v{version}-Linux-*.AppImage ``` ## Verify Installation @@ -182,7 +192,7 @@ After installation, launch CC Switch: 1. The app window displays correctly 2. A CC Switch icon appears in the system tray -3. You can switch between Claude / Codex / Gemini apps +3. The app switcher shows enabled managed apps, and you can switch to the target app panel ## Auto Update diff --git a/docs/user-manual/en/1-getting-started/1.3-interface.md b/docs/user-manual/en/1-getting-started/1.3-interface.md index 70a26a132..1df69fc35 100644 --- a/docs/user-manual/en/1-getting-started/1.3-interface.md +++ b/docs/user-manual/en/1-getting-started/1.3-interface.md @@ -11,7 +11,7 @@ | 1 | Logo | Click to visit the GitHub project page | | 2 | Settings Button | Open the settings page (shortcut `Cmd/Ctrl + ,`) | | 3 | Proxy Toggle | Start/stop the local proxy service | -| 4 | App Switcher | Switch between Claude / Codex / Gemini / OpenCode / OpenClaw | +| 4 | App Switcher | Switch between Claude / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes | | 5 | Feature Area | Skills / Prompts / MCP entry points | | 6 | Add Button | Add a new provider | @@ -20,10 +20,12 @@ Click the dropdown menu to switch the currently managed application: - **Claude** - Manage Claude Code configuration +- **Claude Desktop** - Manage Claude Desktop third-party providers and official mode - **Codex** - Manage Codex configuration - **Gemini** - Manage Gemini CLI configuration - **OpenCode** - Manage OpenCode configuration - **OpenClaw** - Manage OpenClaw configuration +- **Hermes** - Manage Hermes Agent providers and Memory After switching, the provider list displays the configurations for the selected application. @@ -56,6 +58,8 @@ Each provider is displayed as a card, containing the following elements from lef > **Tip**: The action buttons area (5-10) appears on hover and is hidden by default to keep the interface clean. +Starting from v3.15.0, some Claude Code and Codex provider cards also show a **Local Routing support badge**, helping you quickly identify providers that can be served through local routing. + ### Button Details | Button | State Changes | Notes | @@ -100,12 +104,12 @@ CC Switch displays an icon in the system tray, providing quick access to operati | Menu Item | Function | |-----------|----------| | Open Main Window | Show and focus the main window | -| App Submenus | Collapsible submenus grouped by Claude/Codex/Gemini (e.g., "Claude · PackyCode") | +| App Submenus | Collapsible submenus grouped by Claude/Codex/Gemini (e.g., "Claude · PackyCode"), with current provider and cached usage summaries when available | | Provider List | Inside each submenu, click to switch; currently active shows a checkmark | | Lightweight Mode | Toggle checkbox to enter/exit tray-only mode | | Quit | Fully exit the application | -> **Note**: Each app submenu title shows the current provider name (e.g., "Claude · PackyCode"). Apps with no configured providers show a disabled "(no providers)" entry. App visibility is controlled by the App Visibility setting. +> **Note**: Each tray submenu title shows the current provider name (e.g., "Claude · PackyCode"). Apps with no configured providers show a disabled "(no providers)" entry. The tray currently focuses on Claude / Codex / Gemini, the apps that support proxy routing and usage summaries; main-window app visibility is still controlled by the App Visibility setting. ### Multi-language Support diff --git a/docs/user-manual/en/2-providers/2.1-add.md b/docs/user-manual/en/2-providers/2.1-add.md index 49960efdc..fc2d7cc00 100644 --- a/docs/user-manual/en/2-providers/2.1-add.md +++ b/docs/user-manual/en/2-providers/2.1-add.md @@ -5,7 +5,7 @@ Click the **+** button in the top-right corner of the main interface to open the Add Provider panel. The panel has two tabs: -- **App-specific Provider**: Only for the currently selected app (Claude/Codex/Gemini/OpenCode/OpenClaw) +- **App-specific Provider**: Only for the currently selected app (Claude Code / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes) - **Universal Provider**: Shared configuration across apps ## Add Using Presets @@ -56,6 +56,16 @@ Presets are pre-configured provider templates that only require an API Key to us > The preset list may be updated with new versions. Refer to the actual list shown in the app. +#### Claude Desktop Presets + +The Claude Desktop panel includes provider presets translated from the Claude Code preset catalog. When adding one, choose between: + +- **Direct mode**: the provider exposes a native Anthropic Messages API that Claude Desktop can reach directly +- **Model mapping mode**: non-Claude models are mapped through the CC Switch local gateway into Sonnet / Opus / Haiku routes +- **Claude Desktop Official**: restores Claude Desktop's official sign-in mode + +See [2.6 Claude Desktop](./2.6-claude-desktop.md) for the full workflow. + #### Codex Presets | Preset Name | Description | @@ -161,7 +171,7 @@ When adding or editing a provider, you can automatically discover available mode 3. CC Switch uses the configured API Key to call the OpenAI-compatible `/v1/models` endpoint 4. Select a model from the dropdown, grouped by category -This feature covers **all five apps** — **Claude / Codex / Gemini / OpenCode / OpenClaw** — and works for any provider that supports the `/v1/models` endpoint. +This feature is available in model-aware provider forms for **Claude Code / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes**, and works for providers that support the `/v1/models` endpoint. Codex OAuth providers fetch live model lists from the ChatGPT Codex backend on demand. **Common errors:** - **Authentication failed (401/403)**: Check your API Key @@ -259,7 +269,7 @@ requires_openai_auth = true ## Universal Provider -Universal providers can share configurations across Claude/Codex/Gemini/OpenCode/OpenClaw, suitable for proxy services that support multiple API formats. +Universal providers can share configurations across Claude Code / Codex / Gemini, suitable for proxy services that support multiple API formats. ### Create a Universal Provider @@ -269,7 +279,7 @@ Universal providers can share configurations across Claude/Codex/Gemini/OpenCode - Name - API Key - Endpoint URL -4. Check the apps to sync to (Claude/Codex/Gemini/OpenCode/OpenClaw) +4. Check the apps to sync to (Claude Code / Codex / Gemini) 5. Save ### Sync Mechanism @@ -403,6 +413,8 @@ The Codex OAuth preset's default model mapping: | Opus role | `gpt-5.4` | | Haiku role | `gpt-5.4-mini` | +Starting from v3.15.0, Codex OAuth model selection no longer relies only on a hardcoded list. When the model selector opens, CC Switch fetches available models from the ChatGPT Codex backend on demand; the default mapping can still be overridden. + You can override the `ANTHROPIC_MODEL` and related environment variables in the provider's JSON editor to customize. ### Multi-Account Management (OAuth Auth Center) @@ -523,7 +535,7 @@ When adding a Codex provider, an **Enable 1M Context Window** toggle is availabl - **When enabled**: Sets `model_context_window = 1000000` and auto-fills `model_auto_compact_token_limit = 900000` in config.toml - **When disabled**: Removes both fields -The auto-compact limit can be customized in the text field that appears when the toggle is on. +The auto-compact limit can be customized in the text field that appears when the toggle is on. Starting from v3.15.0, this toggle only appears when adding a new Codex provider; when editing an existing provider, adjust the fields directly in advanced configuration if needed. ### Custom Icon diff --git a/docs/user-manual/en/2-providers/2.2-switch.md b/docs/user-manual/en/2-providers/2.2-switch.md index 688597823..282f7d988 100644 --- a/docs/user-manual/en/2-providers/2.2-switch.md +++ b/docs/user-manual/en/2-providers/2.2-switch.md @@ -39,14 +39,12 @@ Starting from v3.13.0, the tray menu is refactored from a flat list into **per-a | Claude | All Claude providers (including Codex OAuth reverse proxy) | | Codex | All Codex providers | | Gemini | All Gemini providers | -| OpenCode | All OpenCode providers | -| OpenClaw | All OpenClaw providers | **Benefits of the refactor**: - **Prevents menu overflow**: With many providers, a flat list would exceed screen height; per-app submenus scale naturally -- **Submenu title shows the currently active provider**: You know at a glance which provider each app is using, without opening the submenu -- **Per-app isolation**: Switching Claude's provider doesn't disturb the Codex view +- **Submenu title shows the currently active provider and usage summary**: You know at a glance which provider Claude / Codex / Gemini is using, plus available cached usage information, without opening the submenu +- **Per-app isolation**: Switching Claude's provider doesn't disturb the Codex or Gemini view > **Tip**: The combination of background residency + Lightweight Mode + per-app submenus is especially suited for heavy users who frequently switch among multiple apps. See [1.5 Personalization → Lightweight Mode](../1-getting-started/1.5-settings.md). diff --git a/docs/user-manual/en/2-providers/2.3-edit.md b/docs/user-manual/en/2-providers/2.3-edit.md index 82e4693ba..f6b731f85 100644 --- a/docs/user-manual/en/2-providers/2.3-edit.md +++ b/docs/user-manual/en/2-providers/2.3-edit.md @@ -151,8 +151,9 @@ Configuration uses JSON format, and the editor provides: ## Save and Activate 1. Click the "Save" button -2. If this is the currently active provider, the configuration is immediately written to the live file -3. Restart the CLI tool for changes to take effect +2. If the form detects a non-blocking issue, a "save anyway" prompt appears; confirming still saves the provider +3. If this is the currently active provider, the configuration is immediately written to the live file +4. Restart the CLI tool for changes to take effect ## Cancel Editing diff --git a/docs/user-manual/en/2-providers/2.4-sort-duplicate.md b/docs/user-manual/en/2-providers/2.4-sort-duplicate.md index 3ec4d8db9..069db0a6e 100644 --- a/docs/user-manual/en/2-providers/2.4-sort-duplicate.md +++ b/docs/user-manual/en/2-providers/2.4-sort-duplicate.md @@ -24,6 +24,8 @@ Quickly create a copy of a provider, useful for: - Backing up current configurations - Creating test configurations +Starting from v3.15.0, universal providers also have a duplicate action, so you can create a copy first and then adjust enabled apps and models. + ### Steps 1. Hover over the provider card to reveal action buttons diff --git a/docs/user-manual/en/3-extensions/3.4-sessions.md b/docs/user-manual/en/3-extensions/3.4-sessions.md index 8dccbe19c..b7f03abf4 100644 --- a/docs/user-manual/en/3-extensions/3.4-sessions.md +++ b/docs/user-manual/en/3-extensions/3.4-sessions.md @@ -11,12 +11,13 @@ The Session Manager lets you browse, search, and manage conversation sessions fr | OpenCode | `~/.local/share/opencode/` (JSON or SQLite) | | OpenClaw | `~/.openclaw/agents//sessions/*.jsonl` | | Gemini CLI | `~/.cache/gemini/tmp//chats/` | +| Hermes | `~/.hermes/state.db` or `~/.hermes/sessions/*.jsonl` | ## Opening the Session Manager Click the **Sessions** button in the main navigation bar toolbar. -> **Note**: The Sessions button is visible for all five supported applications. +> **Note**: The Session Manager covers the six session sources listed above; the Claude Desktop entry reuses the Claude Code session view. ## Interface Layout @@ -63,6 +64,7 @@ Click the provider filter dropdown (top-right of left panel) to filter by applic - **OpenCode** - **OpenClaw** - **Gemini CLI** +- **Hermes** The filter can be combined with search. @@ -81,7 +83,7 @@ Click the **Resume** button (play icon) on a selected session to continue the co - The terminal opens in the session's project directory - If terminal launch fails, the command is copied to your clipboard instead -**Supported terminals (macOS):** Terminal.app, iTerm2, Ghostty, Kitty, WezTerm, Alacritty +**Supported terminals (macOS):** Terminal.app, iTerm2, Ghostty, Kitty, WezTerm, Alacritty, Warp **On other platforms:** - The resume command is copied to your clipboard @@ -103,7 +105,7 @@ Starting from v3.13.0, **Claude sessions** show a **directory picker** before re 2. In the popup directory picker, confirm the default directory or choose a new one 3. CC Switch launches the Claude terminal session in the selected directory -> **Note**: Codex / Gemini / OpenCode / OpenClaw session resume flows do not yet include the directory picker and still use the session's original project directory. +> **Note**: Codex / Gemini / OpenCode / OpenClaw / Hermes session resume flows do not yet include the directory picker and still use the session's original project directory. ### Delete Session diff --git a/docs/user-manual/en/4-proxy/4.4-usage.md b/docs/user-manual/en/4-proxy/4.4-usage.md index ca148c788..4f1c6ad50 100644 --- a/docs/user-manual/en/4-proxy/4.4-usage.md +++ b/docs/user-manual/en/4-proxy/4.4-usage.md @@ -50,10 +50,15 @@ Key metrics displayed at the top of the page: | Metric | Description | |--------|-------------| | Total Requests | Total number of requests in the time period | -| Total Tokens | Total input + output tokens | +| Real Total Tokens | Cache-normalized total of input + output + cache creation + cache read tokens | +| Cache Hit Rate | Cache read tokens as a share of cacheable input | | Estimated Cost | Cost calculated based on pricing configuration | | Success Rate | Percentage of successful requests | +Starting from v3.15.0, the top of the Usage page uses a filter-driven Hero card. When you change the date range, app, provider, or model filters, the Hero's real total tokens, cache hit rate, request count, and cost update together and stay aligned with the logs and stats below. + +> Note: v3.15.0 normalizes cache reads, cache creation, and OpenAI-style cache reporting. Historical token and cost numbers may differ from older estimates; the current numbers follow the normalized rules. + ### Time Range Select the time range for statistics: diff --git a/docs/user-manual/en/4-proxy/4.5-model-test.md b/docs/user-manual/en/4-proxy/4.5-model-test.md index fd606dee6..62b5c3f41 100644 --- a/docs/user-manual/en/4-proxy/4.5-model-test.md +++ b/docs/user-manual/en/4-proxy/4.5-model-test.md @@ -10,7 +10,7 @@ The model test feature (also known as **Stream Check**) verifies whether a provi - Whether the response latency is acceptable - Time to first token (TTFB) for streaming responses -Starting from v3.13.0, Stream Check coverage is extended to **all five apps** (Claude / Codex / Gemini / OpenCode / OpenClaw), including all OpenClaw protocol variants (such as `openai-completions`). OpenCode is auto-detected via npm package mapping; OpenClaw supports custom `auth-header` detection and handles edge cases like Bedrock error messages and `baseURL` fallback. +Starting from v3.13.0, Stream Check coverage is extended to **Claude / Codex / Gemini / OpenCode / OpenClaw**, including all OpenClaw protocol variants (such as `openai-completions`). OpenCode is auto-detected via npm package mapping; OpenClaw supports custom `auth-header` detection and handles edge cases like Bedrock error messages and `baseURL` fallback. ## Open Configuration diff --git a/docs/user-manual/en/README.md b/docs/user-manual/en/README.md index a1edd8737..619d13f35 100644 --- a/docs/user-manual/en/README.md +++ b/docs/user-manual/en/README.md @@ -1,6 +1,6 @@ # CC Switch User Manual -> All-in-One Assistant for Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw +> All-in-One Assistant for Claude Code / Claude Desktop / Codex / Gemini CLI / OpenCode / OpenClaw / Hermes ## Table of Contents @@ -115,13 +115,16 @@ CC Switch User Manual - **First-class Claude Desktop panel**: supports third-party providers, direct / model mapping modes, Copilot / Codex OAuth reuse, and 3P profile writing. See [2.6 Claude Desktop](./2-providers/2.6-claude-desktop.md) - **Role-based model mapping**: adapts Claude Desktop model validation with Sonnet / Opus / Haiku routes and `supports1m` - **Claude Desktop local routing**: provides a local gateway at `127.0.0.1:15721/claude-desktop` for providers that need conversion +- **Routing support badges**: Claude Code / Codex provider cards indicate whether a provider can be served through Local Routing +- **Codex OAuth live model discovery**: ChatGPT Codex providers fetch available models from the ChatGPT backend on demand +- **Filter-driven Usage Hero**: shows cache-normalized real total tokens and cache hit rate, updating with date / provider / model filters — see [4.4 Usage Statistics](./4-proxy/4.4-usage.md) - **Lightweight Mode**: Destroys the main window when minimizing to tray — near-zero idle footprint. See [1.5 Personalization](./1-getting-started/1.5-settings.md) - **Quota & Balance Display**: Official subscriptions (Claude/Codex/Gemini/Copilot/Codex OAuth) auto-display quotas; Token Plan and third-party balances use built-in templates with one-click enable — see [2.5 Usage Query](./2-providers/2.5-usage-query.md) - **Codex OAuth Reverse Proxy**: Reuse your ChatGPT account's Codex service inside Claude Code — see [2.1 Add Provider](./2-providers/2.1-add.md) -- **Per-App Tray Submenus**: Five independent app submenus to prevent tray overflow — see [2.2 Switch Provider](./2-providers/2.2-switch.md) +- **Per-App Tray Submenus**: Claude / Codex / Gemini submenus show the current provider and available usage summaries — see [2.2 Switch Provider](./2-providers/2.2-switch.md) - **Skills Discovery & Batch Updates**: SHA-256 update detection, batch updates, skills.sh public registry search — see [3.3 Skills Management](./3-extensions/3.3-skills.md) - **Full URL Endpoint Mode**: Advanced option to treat `base_url` as the full upstream endpoint — see [2.1 Add Provider](./2-providers/2.1-add.md) -- **OpenCode / OpenClaw Stream Check Coverage**: Stream Check panel extended to all five apps — see [4.5 Model Test](./4-proxy/4.5-model-test.md) +- **OpenCode / OpenClaw Stream Check Coverage**: Stream Check covers Claude / Codex / Gemini / OpenCode / OpenClaw — see [4.5 Model Test](./4-proxy/4.5-model-test.md) ## Contributing diff --git a/docs/user-manual/ja/1-getting-started/1.1-introduction.md b/docs/user-manual/ja/1-getting-started/1.1-introduction.md index a86241003..b21e5677b 100644 --- a/docs/user-manual/ja/1-getting-started/1.1-introduction.md +++ b/docs/user-manual/ja/1-getting-started/1.1-introduction.md @@ -2,14 +2,14 @@ ## CC Switch とは -CC Switch はクロスプラットフォームのデスクトップアプリケーションで、AI プログラミングツールを使用する開発者向けに設計されています。**Claude Code**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw** の 5 つの AI プログラミングツールの設定を統一的に管理できます。 +CC Switch はクロスプラットフォームのデスクトップアプリケーションで、AI プログラミングツールを使用する開発者向けに設計されています。**Claude Code**、**Claude Desktop**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw**、**Hermes** などの管理対象アプリの設定を統一的に管理できます。 ## どのような問題を解決するか 日常の開発で、以下のような課題に直面することがあります： - **複数プロバイダーの切り替えが面倒**：異なる API プロバイダー（公式、中継サービスなど）を使用する際、設定ファイルを手動で変更する必要がある -- **設定が分散して管理しづらい**：Claude、Codex、Gemini、OpenCode、OpenClaw がそれぞれ独立した設定ファイルを持ち、フォーマットも異なる +- **設定が分散して管理しづらい**：Claude Code、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes がそれぞれ独立した設定ファイルを持ち、フォーマットも異なる - **使用量を監視できない**：API をどれだけ呼び出したか、いくらかかったかが分からない - **サービスが不安定**：単一プロバイダーに問題が発生すると、ワークフロー全体が中断する @@ -21,6 +21,7 @@ CC Switch は統一されたインターフェースでこれらの問題を解 - ワンクリックで複数の API プロバイダー設定を切り替え - プリセットテンプレートで一般的なプロバイダーを素早く追加 - 統一プロバイダー機能で、アプリ間で設定を共有 +- Claude Desktop のサードパーティプロバイダー、直結モード、モデルマッピング - 使用量クエリと残額表示 - エンドポイント速度テスト @@ -40,16 +41,18 @@ CC Switch は統一されたインターフェースでこれらの問題を解 | アプリ | 説明 | |------|------| | **Claude Code** | Anthropic 公式の AI プログラミングアシスタント | +| **Claude Desktop** | Claude デスクトップアプリ。公式サインインとサードパーティ 3P profile に対応 | | **Codex** | OpenAI のコード生成ツール | | **Gemini CLI** | Google の AI コマンドラインツール | | **OpenCode** | オープンソース AI プログラミングターミナルツール | | **OpenClaw** | オープンソース AI プログラミングアシスタント（マルチプロバイダーゲートウェイ） | +| **Hermes** | Hermes Agent のプロバイダー、MCP、Skills、Memory 管理 | ## 対応プラットフォーム - **Windows** 10 以上 -- **macOS** 10.15 (Catalina) 以上 -- **Linux** Ubuntu 22.04+ / Debian 11+ / Fedora 34+ +- **macOS** 12 (Monterey) 以上 +- **Linux** Ubuntu 22.04+ / Debian 11+ / Fedora 34+（x64 / ARM64） ## 技術アーキテクチャ diff --git a/docs/user-manual/ja/1-getting-started/1.2-installation.md b/docs/user-manual/ja/1-getting-started/1.2-installation.md index 46a952cfd..a845191e0 100644 --- a/docs/user-manual/ja/1-getting-started/1.2-installation.md +++ b/docs/user-manual/ja/1-getting-started/1.2-installation.md @@ -1,5 +1,15 @@ # 1.2 インストールガイド +## 公式チャネルとシステム要件 + +CC Switch は **[ccswitch.io](https://ccswitch.io)**、**[GitHub Releases](https://github.com/farion1231/cc-switch/releases)**、またはプロジェクトのソースリポジトリからのみ入手してください。支払い、チャージ、ログイン情報の入力を求める「CC Switch」サイトやクライアントは公式ではありません。 + +| システム | 最低バージョン | アーキテクチャ | +|------|----------------|----------------| +| Windows | Windows 10 以上 | x64 | +| macOS | macOS 12 (Monterey) 以上 | Intel (x64) / Apple Silicon (arm64) | +| Linux | 下記ディストリビューション説明を参照 | x64 / ARM64 | + ## 前提条件 ### Node.js のインストール @@ -127,8 +137,8 @@ brew upgrade --cask cc-switch ### 方法 2：手動ダウンロード -1. `CC-Switch-v{バージョン}-macOS.zip` をダウンロード -2. 展開して `CC Switch.app` を取得 +1. `CC-Switch-v{バージョン}-macOS.dmg`（推奨）または `CC-Switch-v{バージョン}-macOS.zip` をダウンロード +2. DMG を開く、または zip を展開して `CC Switch.app` を取得 3. 「アプリケーション」フォルダにドラッグ ### 署名・公証済み @@ -151,11 +161,11 @@ yay -S cc-switch-bin ### Debian / Ubuntu -1. `CC-Switch-v{バージョン}-Linux.deb` をダウンロード +1. アーキテクチャに合わせて `CC-Switch-v{バージョン}-Linux-x86_64.deb` または `CC-Switch-v{バージョン}-Linux-arm64.deb` をダウンロード 2. インストール： ```bash -sudo dpkg -i CC-Switch-v{バージョン}-Linux.deb +sudo dpkg -i CC-Switch-v{バージョン}-Linux-*.deb # 依存関係に問題がある場合 sudo apt-get install -f @@ -163,17 +173,17 @@ sudo apt-get install -f ### AppImage（汎用） -1. `CC-Switch-v{バージョン}-Linux.AppImage` をダウンロード +1. アーキテクチャに合わせて `CC-Switch-v{バージョン}-Linux-x86_64.AppImage` または `CC-Switch-v{バージョン}-Linux-arm64.AppImage` をダウンロード 2. 実行権限を追加： ```bash -chmod +x CC-Switch-v{バージョン}-Linux.AppImage +chmod +x CC-Switch-v{バージョン}-Linux-*.AppImage ``` 3. 実行： ```bash -./CC-Switch-v{バージョン}-Linux.AppImage +./CC-Switch-v{バージョン}-Linux-*.AppImage ``` ## インストールの確認 @@ -182,7 +192,7 @@ chmod +x CC-Switch-v{バージョン}-Linux.AppImage 1. アプリウィンドウが正常に表示される 2. システムトレイに CC Switch のアイコンが表示される -3. Claude / Codex / Gemini の 3 つのアプリを切り替えられる +3. アプリ切り替えに有効化された管理対象アプリが表示され、目的のアプリパネルへ切り替えられる ## 自動更新 diff --git a/docs/user-manual/ja/1-getting-started/1.3-interface.md b/docs/user-manual/ja/1-getting-started/1.3-interface.md index c177bc55f..2ef89d2f8 100644 --- a/docs/user-manual/ja/1-getting-started/1.3-interface.md +++ b/docs/user-manual/ja/1-getting-started/1.3-interface.md @@ -11,7 +11,7 @@ | ① | Logo | クリックで GitHub プロジェクトページにアクセス | | ② | 設定ボタン | 設定ページを開く（ショートカット `Cmd/Ctrl + ,`） | | ③ | プロキシスイッチ | ローカルプロキシサービスの起動/停止 | -| ④ | アプリ切り替え | Claude / Codex / Gemini / OpenCode / OpenClaw を切り替え | +| ④ | アプリ切り替え | Claude / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes を切り替え | | ⑤ | 機能エリア | Skills / Prompts / MCP の入口 | | ⑥ | 追加ボタン | 新しいプロバイダーを追加 | @@ -20,10 +20,12 @@ ドロップダウンメニューをクリックして、現在管理するアプリを切り替えます： - **Claude** - Claude Code の設定を管理 +- **Claude Desktop** - Claude Desktop のサードパーティプロバイダーと公式モードを管理 - **Codex** - Codex の設定を管理 - **Gemini** - Gemini CLI の設定を管理 - **OpenCode** - OpenCode の設定を管理 - **OpenClaw** - OpenClaw の設定を管理 +- **Hermes** - Hermes Agent のプロバイダーと Memory を管理 切り替え後、プロバイダーリストに対応アプリの設定が表示されます。 @@ -56,6 +58,8 @@ > **ヒント**：操作ボタンエリア（⑤-⑩）はマウスホバー時に表示され、通常は非表示で画面をすっきり保ちます。 +v3.15.0 から、Claude Code と Codex の一部プロバイダーカードには **Local Routing 対応バッジ**も表示されます。ローカルルーティング経由で利用できるプロバイダーを素早く判別できます。 + ### ボタンの詳細説明 | ボタン | 状態変化 | 説明 | @@ -100,12 +104,12 @@ CC Switch はシステムトレイにアイコンを表示し、クイック操 | メニュー項目 | 機能 | |--------|------| | メインウィンドウを開く | メインウィンドウを表示してフォーカス | -| アプリサブメニュー | Claude/Codex/Gemini/OpenCode/OpenClaw ごとの折りたたみサブメニュー（例：「Claude · PackyCode」） | +| アプリサブメニュー | Claude/Codex/Gemini ごとの折りたたみサブメニュー（例：「Claude · PackyCode」）。利用可能な場合は現在のプロバイダーとキャッシュ済み使用量サマリーも表示 | | プロバイダーリスト | 各サブメニュー内でクリックして切り替え、現在有効なものにはチェックマークを表示 | | ライトウェイトモード | トグルチェックボックスでトレイ専用モードの開始/終了 | | 終了 | アプリを完全に終了 | -> **注意**：各アプリのサブメニュータイトルには現在のプロバイダー名が表示されます（例：「Claude · PackyCode」）。プロバイダーが設定されていないアプリでは、無効化された「(プロバイダーなし)」エントリが表示されます。アプリの表示はアプリの表示設定で制御されます。 +> **注意**：各トレイサブメニューのタイトルには現在のプロバイダー名が表示されます（例：「Claude · PackyCode」）。プロバイダーが設定されていないアプリでは、無効化された「(プロバイダーなし)」エントリが表示されます。トレイは現在、プロキシルーティングと使用量サマリーに対応する Claude / Codex / Gemini にフォーカスしています。メイン画面のアプリ表示はアプリの表示設定で制御されます。 ### 多言語対応 diff --git a/docs/user-manual/ja/2-providers/2.1-add.md b/docs/user-manual/ja/2-providers/2.1-add.md index d8bc7e058..30ab96d33 100644 --- a/docs/user-manual/ja/2-providers/2.1-add.md +++ b/docs/user-manual/ja/2-providers/2.1-add.md @@ -5,7 +5,7 @@ メイン画面右上の **+** ボタンをクリックして、プロバイダー追加パネルを開きます。 パネルは 2 つのタブに分かれています： -- **アプリ専用プロバイダー**：現在選択中のアプリ（Claude/Codex/Gemini/OpenCode/OpenClaw）専用 +- **アプリ専用プロバイダー**：現在選択中のアプリ（Claude Code / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes）専用 - **統一プロバイダー**：アプリ間で共有する設定 ## プリセットで追加 @@ -56,6 +56,16 @@ > ⭐ は公式パートナーを示します。プリセットリストはバージョンの更新に伴い変更される場合があります。アプリ内の実際の表示を基準にしてください。 +#### Claude Desktop プリセット + +Claude Desktop パネルには、Claude Code のプリセットカタログから変換されたプロバイダープリセットが含まれます。追加時には次のモードを選択できます： + +- **直結モード**：プロバイダーがネイティブの Anthropic Messages API を提供し、Claude Desktop から直接アクセスできる場合 +- **モデルマッピングモード**：非 Claude モデルを CC Switch ローカルゲートウェイ経由で Sonnet / Opus / Haiku ルートへマッピング +- **Claude Desktop Official**：Claude Desktop の公式サインインモードへ戻す + +詳しい手順は [2.6 Claude Desktop](./2.6-claude-desktop.md) を参照してください。 + #### Codex プリセット | プリセット名 | 説明 | @@ -161,7 +171,7 @@ 3. CC Switch が設定された API Key で OpenAI 互換の `/v1/models` エンドポイントを呼び出し 4. カテゴリ別にグループ化されたドロップダウンからモデルを選択 -この機能は **5 つのアプリ全対応** —— **Claude / Codex / Gemini / OpenCode / OpenClaw** のプロバイダーで利用可能で、`/v1/models` エンドポイントをサポートするすべてのプロバイダーに対応します。 +この機能は **Claude Code / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes** のうちモデル項目を持つプロバイダーフォームで利用でき、`/v1/models` エンドポイントをサポートするプロバイダーに対応します。Codex OAuth 系プロバイダーでは、必要に応じて ChatGPT Codex バックエンドからライブモデル一覧を取得します。 **よくあるエラー：** - **認証失敗（401/403）**：API Key が正しいか確認してください @@ -259,7 +269,7 @@ requires_openai_auth = true ## 統一プロバイダー -統一プロバイダーは Claude/Codex/Gemini/OpenCode/OpenClaw 間で設定を共有でき、複数の API 形式をサポートする中継サービスに適しています。 +統一プロバイダーは Claude Code / Codex / Gemini 間で設定を共有でき、複数の API 形式をサポートする中継サービスに適しています。 ### 統一プロバイダーの作成 @@ -269,7 +279,7 @@ requires_openai_auth = true - 名前 - API Key - エンドポイントアドレス -4. 同期するアプリにチェック（Claude/Codex/Gemini/OpenCode/OpenClaw） +4. 同期するアプリにチェック（Claude Code / Codex / Gemini） 5. 保存 ### 同期の仕組み @@ -403,6 +413,8 @@ Codex OAuth プリセットのデフォルトモデルマッピング： | Opus 役割 | `gpt-5.4` | | Haiku 役割 | `gpt-5.4-mini` | +v3.15.0 以降、Codex OAuth のモデル選択は固定リストだけに依存しません。モデルセレクターを開くと、CC Switch は必要に応じて ChatGPT Codex バックエンドから利用可能モデルを取得します。デフォルトマッピングは引き続き上書きできます。 + プロバイダーの JSON エディタで `ANTHROPIC_MODEL` などの環境変数を上書きしてカスタマイズできます。 ### マルチアカウント管理（OAuth 認証センター） @@ -523,7 +535,7 @@ Codex プロバイダーの追加時、**1M コンテキストウィンドウを - **有効時**：config.toml に `model_context_window = 1000000` を設定し、`model_auto_compact_token_limit = 900000` を自動入力 - **無効時**：両方のフィールドを削除 -トグルがオンの場合に表示されるテキストフィールドで、自動コンパクト制限をカスタマイズできます。 +トグルがオンの場合に表示されるテキストフィールドで、自動コンパクト制限をカスタマイズできます。v3.15.0 以降、このトグルは Codex プロバイダーの新規追加時のみ表示されます。既存プロバイダーの編集時は、必要に応じて高度な設定で該当フィールドを直接調整してください。 ### カスタムアイコン diff --git a/docs/user-manual/ja/2-providers/2.2-switch.md b/docs/user-manual/ja/2-providers/2.2-switch.md index 8b358ceee..bd0833295 100644 --- a/docs/user-manual/ja/2-providers/2.2-switch.md +++ b/docs/user-manual/ja/2-providers/2.2-switch.md @@ -39,14 +39,12 @@ v3.13.0 より、トレイメニューがフラットなリストから **アプ | Claude | Claude のすべてのプロバイダー（Codex OAuth リバースプロキシを含む） | | Codex | Codex のすべてのプロバイダー | | Gemini | Gemini のすべてのプロバイダー | -| OpenCode | OpenCode のすべてのプロバイダー | -| OpenClaw | OpenClaw のすべてのプロバイダー | **リファクタリングの利点**： - **メニューのオーバーフロー防止**：プロバイダーが多数ある場合、フラットなリストでは画面の高さを超えますが、アプリ別サブメニューは自然にスケールします -- **サブメニューのタイトルに現在有効なプロバイダーを表示**：サブメニューを開かなくても、各アプリがどのプロバイダーを使用中か一目でわかります -- **アプリ別の分離**：Claude のプロバイダーを切り替えても Codex のビューには影響しません +- **サブメニューのタイトルに現在有効なプロバイダーと使用量サマリーを表示**：サブメニューを開かなくても、Claude / Codex / Gemini がどのプロバイダーを使用中か、利用可能なキャッシュ済み使用量情報とあわせて確認できます +- **アプリ別の分離**：Claude のプロバイダーを切り替えても Codex や Gemini のビューには影響しません > **ヒント**：バックグラウンド常駐 + 軽量モード + アプリ別サブメニューの組み合わせは、複数のアプリを頻繁に切り替えるヘビーユーザーに特に適しています。[1.5 個人設定 → 軽量モード](../1-getting-started/1.5-settings.md) を参照してください。 diff --git a/docs/user-manual/ja/2-providers/2.3-edit.md b/docs/user-manual/ja/2-providers/2.3-edit.md index 68eb675ce..8aaa44ac3 100644 --- a/docs/user-manual/ja/2-providers/2.3-edit.md +++ b/docs/user-manual/ja/2-providers/2.3-edit.md @@ -151,8 +151,9 @@ Claude プロバイダーの編集時、JSON エディタの上部にツール ## 保存と反映 1. 「保存」ボタンをクリック -2. 現在有効なプロバイダーの場合、設定は即座に live ファイルに書き込まれる -3. CLI ツールを再起動して反映 +2. フォームが非ブロッキングな問題を検出した場合、「それでも保存」の確認が表示されます。確認すると保存できます +3. 現在有効なプロバイダーの場合、設定は即座に live ファイルに書き込まれる +4. CLI ツールを再起動して反映 ## 編集のキャンセル diff --git a/docs/user-manual/ja/2-providers/2.4-sort-duplicate.md b/docs/user-manual/ja/2-providers/2.4-sort-duplicate.md index afb1773b8..701599229 100644 --- a/docs/user-manual/ja/2-providers/2.4-sort-duplicate.md +++ b/docs/user-manual/ja/2-providers/2.4-sort-duplicate.md @@ -24,6 +24,8 @@ - 現在の設定をバックアップ - テスト用の設定を作成 +v3.15.0 以降、統一プロバイダー一覧にも複製アクションがあります。既存の統一プロバイダーをコピーしてから、有効化するアプリやモデルを調整できます。 + ### 操作手順 1. プロバイダーカードにマウスをホバーして操作ボタンを表示 diff --git a/docs/user-manual/ja/3-extensions/3.4-sessions.md b/docs/user-manual/ja/3-extensions/3.4-sessions.md index 71f1a3c9b..2e1b4e80a 100644 --- a/docs/user-manual/ja/3-extensions/3.4-sessions.md +++ b/docs/user-manual/ja/3-extensions/3.4-sessions.md @@ -11,12 +11,13 @@ | OpenCode | `~/.local/share/opencode/`（JSON または SQLite） | | OpenClaw | `~/.openclaw/agents//sessions/*.jsonl` | | Gemini CLI | `~/.cache/gemini/tmp//chats/` | +| Hermes | `~/.hermes/state.db` または `~/.hermes/sessions/*.jsonl` | ## セッションマネージャーを開く メインナビゲーションバーの **セッション** ボタンをクリックします。 -> **注意**：セッションボタンは対応する 5 つのアプリすべてで表示されます。 +> **注意**：セッションマネージャーは上表の 6 種類のセッションソースを対象にします。Claude Desktop 入口では Claude Code のセッションビューを再利用します。 ## インターフェースのレイアウト @@ -63,6 +64,7 @@ - **OpenCode** - **OpenClaw** - **Gemini CLI** +- **Hermes** フィルターは検索と組み合わせて使用できます。 @@ -81,7 +83,7 @@ - ターミナルはセッションのプロジェクトディレクトリで開きます - ターミナルの起動に失敗した場合、コマンドがクリップボードにコピーされます -**対応ターミナル（macOS）：** Terminal.app、iTerm2、Ghostty、Kitty、WezTerm、Alacritty +**対応ターミナル（macOS）：** Terminal.app、iTerm2、Ghostty、Kitty、WezTerm、Alacritty、Warp **その他のプラットフォーム：** - 再開コマンドがクリップボードにコピーされます @@ -103,7 +105,7 @@ v3.13.0 より、**Claude セッション** の再開前に **ディレクトリ 2. 表示されるディレクトリピッカーで、デフォルトのディレクトリを確認するか、新しいディレクトリを選択 3. CC Switch が選択したディレクトリで Claude ターミナルセッションを起動します -> **ヒント**：Codex / Gemini / OpenCode / OpenClaw のセッション再開フローには現在ディレクトリピッカーは含まれず、セッション元のプロジェクトディレクトリを使用します。 +> **ヒント**：Codex / Gemini / OpenCode / OpenClaw / Hermes のセッション再開フローには現在ディレクトリピッカーは含まれず、セッション元のプロジェクトディレクトリを使用します。 ### セッションの削除 diff --git a/docs/user-manual/ja/4-proxy/4.4-usage.md b/docs/user-manual/ja/4-proxy/4.4-usage.md index 3f90789d8..8a229c900 100644 --- a/docs/user-manual/ja/4-proxy/4.4-usage.md +++ b/docs/user-manual/ja/4-proxy/4.4-usage.md @@ -50,10 +50,15 @@ v3.13.0 より、使用量データの取得元は 2 つあります： | 指標 | 説明 | |------|------| | 総リクエスト数 | 統計期間内のリクエスト総数 | -| 総 Token | 入力 + 出力 Token の合計 | +| 実消費 Token | 入力 + 出力 + キャッシュ作成 + キャッシュ読取をキャッシュ正規化した合計 | +| キャッシュヒット率 | キャッシュ可能な入力に対するキャッシュ読取 Token の割合 | | 推定費用 | 料金設定に基づいて計算された費用 | | 成功率 | 成功したリクエストの割合 | +v3.15.0 以降、使用量ページ上部はフィルター連動の Hero カードになりました。日付範囲、アプリ、プロバイダー、モデルフィルターを変更すると、Hero の実消費 Token、キャッシュヒット率、リクエスト数、費用が同時に更新され、下部のログや統計一覧と整合します。 + +> 注意：v3.15.0 ではキャッシュ読取、キャッシュ作成、OpenAI 系プロトコルのキャッシュ報告方式を正規化しています。過去の Token や費用の数値は旧バージョンの推定値と一致しない場合があります。現在の数値は正規化後のルールに基づきます。 + ### 期間 統計の期間を選択できます： diff --git a/docs/user-manual/ja/4-proxy/4.5-model-test.md b/docs/user-manual/ja/4-proxy/4.5-model-test.md index c8daff054..9bad18faa 100644 --- a/docs/user-manual/ja/4-proxy/4.5-model-test.md +++ b/docs/user-manual/ja/4-proxy/4.5-model-test.md @@ -10,7 +10,7 @@ - 応答レイテンシが正常か - ストリーミングレスポンスの初回トークン時間（TTFB） -v3.13.0 より、Stream Check の対応範囲が **5 つのアプリ全対応**（Claude / Codex / Gemini / OpenCode / OpenClaw）に拡張され、OpenClaw の全プロトコルバリアント（`openai-completions` など）も含まれます。OpenCode は npm パッケージマッピングで自動識別、OpenClaw はカスタム `auth-header` 検出、Bedrock エラーメッセージ、`baseURL` フォールバックなどのエッジケースにも対応しています。 +v3.13.0 より、Stream Check の対応範囲が **Claude / Codex / Gemini / OpenCode / OpenClaw** に拡張され、OpenClaw の全プロトコルバリアント（`openai-completions` など）も含まれます。OpenCode は npm パッケージマッピングで自動識別、OpenClaw はカスタム `auth-header` 検出、Bedrock エラーメッセージ、`baseURL` フォールバックなどのエッジケースにも対応しています。 ## 設定を開く diff --git a/docs/user-manual/ja/README.md b/docs/user-manual/ja/README.md index 98d5f3c5a..296c4ffed 100644 --- a/docs/user-manual/ja/README.md +++ b/docs/user-manual/ja/README.md @@ -1,6 +1,6 @@ # CC Switch ユーザーマニュアル -> Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw オールインワンアシスタント +> Claude Code / Claude Desktop / Codex / Gemini CLI / OpenCode / OpenClaw / Hermes オールインワンアシスタント ## 目次構成 @@ -115,13 +115,16 @@ CC Switch ユーザーマニュアル - **Claude Desktop の一等管理パネル**：サードパーティプロバイダー、直結 / モデルマッピングの 2 モード、Copilot / Codex OAuth 再利用、3P profile 書き込みに対応 — 詳細は [2.6 Claude Desktop](./2-providers/2.6-claude-desktop.md) - **役割別モデルマッピング**：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 使用量統計](./4-proxy/4.4-usage.md) - **軽量モード**：トレイへ最小化時にメインウィンドウを破棄、アイドル時のリソース使用量をほぼゼロに — 詳細は [1.5 個人設定](./1-getting-started/1.5-settings.md) - **クォータ・残高表示**：公式サブスクリプション系（Claude/Codex/Gemini/Copilot/Codex OAuth）はカードに自動表示、Token Plan および第三者残高は内蔵テンプレートでワンクリック有効化 — 詳細は [2.5 使用量クエリ](./2-providers/2.5-usage-query.md) - **Codex OAuth リバースプロキシ**：ChatGPT アカウントで Claude Code 内から Codex サービスを再利用 — 詳細は [2.1 プロバイダーの追加](./2-providers/2.1-add.md) -- **アプリ別トレイサブメニュー**：5 アプリ独立サブメニュー、メニューのオーバーフローを防止 — 詳細は [2.2 プロバイダーの切り替え](./2-providers/2.2-switch.md) +- **アプリ別トレイサブメニュー**：Claude / Codex / Gemini のサブメニューで現在のプロバイダーと使用量サマリーを確認可能 — 詳細は [2.2 プロバイダーの切り替え](./2-providers/2.2-switch.md) - **Skills の発見と一括更新**：SHA-256 ハッシュによる更新検出、一括更新、skills.sh 公式レジストリ検索 — 詳細は [3.3 Skills スキル管理](./3-extensions/3.3-skills.md) - **完全URLエンドポイントモード**：高度なオプションで `base_url` を完全なアップストリームエンドポイントとして扱う — 詳細は [2.1 プロバイダーの追加](./2-providers/2.1-add.md) -- **OpenCode / OpenClaw ストリームチェック完全対応**：Stream Check パネルを 5 アプリ全対応に拡張 — 詳細は [4.5 モデルテスト](./4-proxy/4.5-model-test.md) +- **OpenCode / OpenClaw ストリームチェック対応**：Stream Check は Claude / Codex / Gemini / OpenCode / OpenClaw をカバー — 詳細は [4.5 モデルテスト](./4-proxy/4.5-model-test.md) ## コントリビュート diff --git a/docs/user-manual/zh/1-getting-started/1.1-introduction.md b/docs/user-manual/zh/1-getting-started/1.1-introduction.md index efcd3cefe..05fa318e2 100644 --- a/docs/user-manual/zh/1-getting-started/1.1-introduction.md +++ b/docs/user-manual/zh/1-getting-started/1.1-introduction.md @@ -2,14 +2,14 @@ ## 什么是 CC Switch -CC Switch 是一款跨平台桌面应用，专为使用 AI 编程工具的开发者设计。它帮助你统一管理 **Claude Code**、**Codex**、**Gemini CLI**、**OpenCode** 和 **OpenClaw** 五大 AI 编程工具的配置。 +CC Switch 是一款跨平台桌面应用，专为使用 AI 编程工具的开发者设计。它帮助你统一管理 **Claude Code**、**Claude Desktop**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw** 和 **Hermes** 等受管应用的配置。 ## 解决什么问题 在日常开发中，你可能会遇到这些痛点： - **多供应商切换麻烦**：使用不同的 API 供应商（官方、中转服务商），需要手动修改配置文件 -- **配置分散难管理**：Claude、Codex、Gemini、OpenCode、OpenClaw 各有独立的配置文件，格式不同 +- **配置分散难管理**：Claude Code、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes 各有独立的配置文件，格式不同 - **无法监控用量**：不知道 API 调用了多少次，花了多少钱 - **服务不稳定**：单一供应商出问题时，整个工作流中断 @@ -21,6 +21,7 @@ CC Switch 通过统一的界面解决这些问题。 - 一键切换多个 API 供应商配置 - 支持预设模板，快速添加常用供应商 - 统一供应商功能，跨应用共享配置 +- Claude Desktop 第三方供应商、直连模式与模型映射 - 用量查询与余额显示 - 端点速度测试 @@ -40,16 +41,18 @@ CC Switch 通过统一的界面解决这些问题。 | 应用 | 说明 | |------|------| | **Claude Code** | Anthropic 官方的 AI 编程助手 | +| **Claude Desktop** | Claude 桌面应用，支持官方登录与第三方 3P profile | | **Codex** | OpenAI 的代码生成工具 | | **Gemini CLI** | Google 的 AI 命令行工具 | | **OpenCode** | 开源 AI 编程终端工具 | | **OpenClaw** | 开源 AI 编程助手（多供应商网关） | +| **Hermes** | Hermes Agent，支持供应商、MCP、Skills 和 Memory 管理 | ## 支持的平台 - **Windows** 10 及以上 -- **macOS** 10.15 (Catalina) 及以上 -- **Linux** Ubuntu 22.04+ / Debian 11+ / Fedora 34+ +- **macOS** 12 (Monterey) 及以上 +- **Linux** Ubuntu 22.04+ / Debian 11+ / Fedora 34+（x64 / ARM64） ## 技术架构 diff --git a/docs/user-manual/zh/1-getting-started/1.2-installation.md b/docs/user-manual/zh/1-getting-started/1.2-installation.md index e6917fa6b..db89de103 100644 --- a/docs/user-manual/zh/1-getting-started/1.2-installation.md +++ b/docs/user-manual/zh/1-getting-started/1.2-installation.md @@ -1,5 +1,15 @@ # 1.2 安装指南 +## 官方渠道与系统要求 + +请只从 **[ccswitch.io](https://ccswitch.io)**、**[GitHub Releases](https://github.com/farion1231/cc-switch/releases)** 或项目源码仓库获取 CC Switch。任何要求付费、充值或索取登录凭据的“CC Switch”网站或客户端都不是官方渠道。 + +| 系统 | 最低版本 | 架构 | +|------|----------|------| +| Windows | Windows 10 及以上 | x64 | +| macOS | macOS 12 (Monterey) 及以上 | Intel (x64) / Apple Silicon (arm64) | +| Linux | 见下方发行版说明 | x64 / ARM64 | + ## 前置要求 ### 安装 Node.js @@ -141,8 +151,8 @@ brew upgrade --cask cc-switch ### 方式二：手动下载 -1. 下载 `CC-Switch-v{版本号}-macOS.zip` -2. 解压得到 `CC Switch.app` +1. 下载 `CC-Switch-v{版本号}-macOS.dmg`（推荐）或 `CC-Switch-v{版本号}-macOS.zip` +2. 打开 DMG，或解压 zip 得到 `CC Switch.app` 3. 拖动到「应用程序」文件夹 ### 已签名并公证 @@ -165,11 +175,11 @@ yay -S cc-switch-bin ### Debian / Ubuntu -1. 下载 `CC-Switch-v{版本号}-Linux.deb` +1. 根据架构下载 `CC-Switch-v{版本号}-Linux-x86_64.deb` 或 `CC-Switch-v{版本号}-Linux-arm64.deb` 2. 安装： ```bash -sudo dpkg -i CC-Switch-v{版本号}-Linux.deb +sudo dpkg -i CC-Switch-v{版本号}-Linux-*.deb # 如果有依赖问题 sudo apt-get install -f @@ -177,17 +187,17 @@ sudo apt-get install -f ### AppImage（通用） -1. 下载 `CC-Switch-v{版本号}-Linux.AppImage` +1. 根据架构下载 `CC-Switch-v{版本号}-Linux-x86_64.AppImage` 或 `CC-Switch-v{版本号}-Linux-arm64.AppImage` 2. 添加执行权限： ```bash -chmod +x CC-Switch-v{版本号}-Linux.AppImage +chmod +x CC-Switch-v{版本号}-Linux-*.AppImage ``` 3. 运行： ```bash -./CC-Switch-v{版本号}-Linux.AppImage +./CC-Switch-v{版本号}-Linux-*.AppImage ``` ## 验证安装 @@ -196,7 +206,7 @@ chmod +x CC-Switch-v{版本号}-Linux.AppImage 1. 应用窗口正常显示 2. 系统托盘出现 CC Switch 图标 -3. 能够切换 Claude / Codex / Gemini 三个应用 +3. 应用切换器中能看到已启用的受管应用，并能切换到目标应用面板 ## 自动更新 diff --git a/docs/user-manual/zh/1-getting-started/1.3-interface.md b/docs/user-manual/zh/1-getting-started/1.3-interface.md index e7a1eb252..2879ab441 100644 --- a/docs/user-manual/zh/1-getting-started/1.3-interface.md +++ b/docs/user-manual/zh/1-getting-started/1.3-interface.md @@ -11,7 +11,7 @@ | ① | Logo | 点击访问 GitHub 项目页 | | ② | 设置按钮 | 打开设置页面（快捷键 `Cmd/Ctrl + ,`） | | ③ | 代理开关 | 启动/停止本地代理服务 | -| ④ | 应用切换器 | 切换 Claude / Codex / Gemini / OpenCode / OpenClaw | +| ④ | 应用切换器 | 切换 Claude / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes | | ⑤ | 功能区 | Skills / Prompts / MCP 入口 | | ⑥ | 添加按钮 | 添加新供应商 | @@ -20,10 +20,12 @@ 点击下拉菜单切换当前管理的应用： - **Claude** - 管理 Claude Code 配置 +- **Claude Desktop** - 管理 Claude Desktop 第三方供应商与官方模式 - **Codex** - 管理 Codex 配置 - **Gemini** - 管理 Gemini CLI 配置 - **OpenCode** - 管理 OpenCode 配置 - **OpenClaw** - 管理 OpenClaw 配置 +- **Hermes** - 管理 Hermes Agent 供应商与 Memory 切换后，供应商列表会显示对应应用的配置。 @@ -56,6 +58,8 @@ > 💡 **提示**：操作按钮区域（⑤-⑩）在鼠标悬停时显示，平时隐藏以保持界面简洁。 +v3.15.0 起，Claude Code 与 Codex 的部分供应商卡片还会显示 **Local Routing 支持徽章**，用于快速判断该供应商是否适合通过本地路由转发。 + ### 按钮详细说明 | 按钮 | 状态变化 | 说明 | @@ -100,12 +104,12 @@ CC Switch 在系统托盘显示图标，提供快速操作入口。 | 菜单项 | 功能 | |--------|------| | 打开主界面 | 显示主窗口并聚焦 | -| 应用子菜单 | 按 Claude/Codex/Gemini/OpenCode/OpenClaw 分组的折叠子菜单（如 "Claude · PackyCode"） | +| 应用子菜单 | 按 Claude/Codex/Gemini 分组的折叠子菜单（如 "Claude · PackyCode"），可显示当前供应商与缓存用量摘要 | | 供应商列表 | 在每个子菜单内，点击切换，当前启用的显示勾选标记 | | 轻量模式 | 勾选框切换，进入/退出仅托盘运行模式 | | 退出 | 完全退出应用 | -> **注意**：每个应用子菜单的标题会显示当前供应商名称（如 "Claude · PackyCode"）。没有配置供应商的应用会显示禁用的"(无供应商)"条目。应用可见性由设置中的"应用可见性"选项控制。 +> **注意**：每个托盘子菜单的标题会显示当前供应商名称（如 "Claude · PackyCode"）。没有配置供应商的应用会显示禁用的"(无供应商)"条目。托盘目前聚焦 Claude / Codex / Gemini 三个可代理且可统计用量的应用；主界面应用可见性仍由设置中的"应用可见性"选项控制。 ### 多语言支持 diff --git a/docs/user-manual/zh/2-providers/2.1-add.md b/docs/user-manual/zh/2-providers/2.1-add.md index ea1fd02cb..39f2c887a 100644 --- a/docs/user-manual/zh/2-providers/2.1-add.md +++ b/docs/user-manual/zh/2-providers/2.1-add.md @@ -5,7 +5,7 @@ 点击主界面右上角的 **+** 按钮，打开添加供应商面板。 面板分为两个 Tab： -- **应用专属供应商**：仅用于当前选中的应用（Claude/Codex/Gemini/OpenCode/OpenClaw） +- **应用专属供应商**：仅用于当前选中的应用（Claude Code / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes） - **统一供应商**：跨应用共享的配置 ## 使用预设添加 @@ -56,6 +56,16 @@ > ⭐ 标注为官方合作伙伴。预设列表可能随版本更新，以应用内实际显示为准。 +#### Claude Desktop 预设 + +Claude Desktop 面板内置从 Claude Code 预设目录转换而来的供应商预设。添加时可选择： + +- **直连模式**：供应商原生支持 Anthropic Messages API，Claude Desktop 可直接访问 +- **模型映射模式**：非 Claude 模型通过 CC Switch 本地网关映射为 Sonnet / Opus / Haiku 路由 +- **Claude Desktop Official**：恢复 Claude Desktop 官方登录模式 + +完整操作请参阅 [2.6 Claude Desktop](./2.6-claude-desktop.md)。 + #### Codex 预设 | 预设名称 | 说明 | @@ -161,7 +171,7 @@ 3. CC Switch 使用配置的 API Key 调用 OpenAI 兼容的 `/v1/models` 端点 4. 从按类别分组的下拉菜单中选择模型 -此功能覆盖全部五个应用 —— **Claude / Codex / Gemini / OpenCode / OpenClaw**，适用于所有支持 `/v1/models` 端点的供应商。 +此功能覆盖 **Claude Code / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes** 中带模型字段的供应商表单，适用于支持 `/v1/models` 端点的供应商。Codex OAuth 类供应商会按需从 ChatGPT Codex 后端获取实时模型列表。 **常见错误**： - **认证失败（401/403）**：检查你的 API Key 是否正确 @@ -259,7 +269,7 @@ requires_openai_auth = true ## 统一供应商 -统一供应商可以跨 Claude/Codex/Gemini/OpenCode/OpenClaw 共享配置，适用于支持多种 API 格式的中转服务。 +统一供应商可以跨 Claude Code / Codex / Gemini 共享配置，适用于支持多种 API 格式的中转服务。 ### 创建统一供应商 @@ -269,7 +279,7 @@ requires_openai_auth = true - 名称 - API Key - 端点地址 -4. 勾选要同步的应用（Claude/Codex/Gemini/OpenCode/OpenClaw） +4. 勾选要同步的应用（Claude Code / Codex / Gemini） 5. 保存 ### 同步机制 @@ -403,6 +413,8 @@ Codex OAuth 预设的默认模型映射： | Opus 角色 | `gpt-5.4` | | Haiku 角色 | `gpt-5.4-mini` | +v3.15.0 起，Codex OAuth 模型选择不再只依赖硬编码列表。打开模型选择时，CC Switch 会按需从 ChatGPT Codex 后端拉取可用模型，默认映射仍可按需覆盖。 + 你可以在供应商的 JSON 编辑器中覆盖 `ANTHROPIC_MODEL` 等环境变量来自定义。 ### 多账号管理（OAuth 认证中心） @@ -523,7 +535,7 @@ v3.13.0 起新增的高级选项。默认情况下，CC Switch 会把配置的 ` - **启用时**：在 config.toml 中设置 `model_context_window = 1000000` 并自动填充 `model_auto_compact_token_limit = 900000` - **禁用时**：移除这两个字段 -开关开启后显示的文本框可自定义自动压缩限制值。 +开关开启后显示的文本框可自定义自动压缩限制值。v3.15.0 起，该开关仅在新增 Codex 供应商时显示；编辑已有供应商时可通过高级配置直接调整相关字段。 ### 自定义图标 diff --git a/docs/user-manual/zh/2-providers/2.2-switch.md b/docs/user-manual/zh/2-providers/2.2-switch.md index 78f2e6484..dd32c96d0 100644 --- a/docs/user-manual/zh/2-providers/2.2-switch.md +++ b/docs/user-manual/zh/2-providers/2.2-switch.md @@ -39,14 +39,12 @@ v3.13.0 起，托盘菜单从原来的扁平列表重构为**按应用分组的 | Claude | Claude 所有供应商（含 Codex OAuth 反向代理） | | Codex | Codex 所有供应商 | | Gemini | Gemini 所有供应商 | -| OpenCode | OpenCode 所有供应商 | -| OpenClaw | OpenClaw 所有供应商 | **重构带来的好处**： - **防止菜单溢出**：有大量供应商时，扁平列表会超出屏幕高度；分级子菜单天然支持无限扩展 -- **子菜单标题显示当前激活供应商**：无需打开子菜单即可知道每个应用当前用的是哪个供应商 -- **按应用隔离操作**：切换 Claude 的供应商不会干扰到 Codex 的视图 +- **子菜单标题显示当前激活供应商与用量摘要**：无需打开子菜单即可知道 Claude / Codex / Gemini 当前使用哪个供应商，以及可用的缓存用量信息 +- **按应用隔离操作**：切换 Claude 的供应商不会干扰到 Codex 或 Gemini 的视图 > 💡 **提示**：后台常驻 + 轻量模式 + 分级子菜单的组合特别适合频繁切换多个应用的重度用户。参考 [1.5 个性化配置 → 轻量模式](../1-getting-started/1.5-settings.md)。 diff --git a/docs/user-manual/zh/2-providers/2.3-edit.md b/docs/user-manual/zh/2-providers/2.3-edit.md index 4909c7a4b..c30bc58f2 100644 --- a/docs/user-manual/zh/2-providers/2.3-edit.md +++ b/docs/user-manual/zh/2-providers/2.3-edit.md @@ -151,8 +151,9 @@ JSON 格式的配置内容，包括： ## 保存与生效 1. 点击「保存」按钮 -2. 如果是当前启用的供应商，配置立即写入 live 文件 -3. 重启 CLI 工具生效 +2. 如果表单检测到非阻塞问题，会出现「先存上再说」确认提示；确认后仍可保存 +3. 如果是当前启用的供应商，配置立即写入 live 文件 +4. 重启 CLI 工具生效 ## 取消编辑 diff --git a/docs/user-manual/zh/2-providers/2.4-sort-duplicate.md b/docs/user-manual/zh/2-providers/2.4-sort-duplicate.md index 2612dcbae..1864ae69c 100644 --- a/docs/user-manual/zh/2-providers/2.4-sort-duplicate.md +++ b/docs/user-manual/zh/2-providers/2.4-sort-duplicate.md @@ -24,6 +24,8 @@ - 备份当前配置 - 创建测试用配置 +v3.15.0 起，统一供应商列表也提供复制按钮，可直接从现有统一供应商创建副本后再调整同步应用和模型。 + ### 操作步骤 1. 鼠标悬停在供应商卡片上，显示操作按钮 diff --git a/docs/user-manual/zh/3-extensions/3.4-sessions.md b/docs/user-manual/zh/3-extensions/3.4-sessions.md index 0e29dca65..35c1d2d57 100644 --- a/docs/user-manual/zh/3-extensions/3.4-sessions.md +++ b/docs/user-manual/zh/3-extensions/3.4-sessions.md @@ -11,12 +11,13 @@ | OpenCode | `~/.local/share/opencode/`（JSON 或 SQLite） | | OpenClaw | `~/.openclaw/agents//sessions/*.jsonl` | | Gemini CLI | `~/.cache/gemini/tmp//chats/` | +| Hermes | `~/.hermes/state.db` 或 `~/.hermes/sessions/*.jsonl` | ## 打开会话管理器 点击主导航栏中的 **会话** 按钮。 -> **注意**：会话按钮在所有五种应用模式下均可见。 +> **注意**：会话管理器覆盖上表六类会话来源；Claude Desktop 入口会复用 Claude Code 会话视图。 ## 界面布局 @@ -63,6 +64,7 @@ - **OpenCode** - **OpenClaw** - **Gemini CLI** +- **Hermes** 过滤可与搜索组合使用。 @@ -81,7 +83,7 @@ - 终端会在会话的项目目录中打开 - 如果终端启动失败，命令会被复制到剪贴板 -**支持的终端（macOS）**：Terminal.app、iTerm2、Ghostty、Kitty、WezTerm、Alacritty +**支持的终端（macOS）**：Terminal.app、iTerm2、Ghostty、Kitty、WezTerm、Alacritty、Warp **其他平台**： - 恢复命令会被复制到剪贴板 @@ -103,7 +105,7 @@ v3.13.0 起，**Claude 会话**恢复前会弹出**目录选择器**，让你可 2. 在弹出的目录选择器中，确认默认目录或选择新目录 3. CC Switch 会在所选目录下启动 Claude 终端会话 -> 💡 **提示**：Codex / Gemini / OpenCode / OpenClaw 会话的恢复流程暂不包含目录选择器，仍使用会话原始项目目录。 +> 💡 **提示**：Codex / Gemini / OpenCode / OpenClaw / Hermes 会话的恢复流程暂不包含目录选择器，仍使用会话原始项目目录。 ### 删除会话 diff --git a/docs/user-manual/zh/4-proxy/4.4-usage.md b/docs/user-manual/zh/4-proxy/4.4-usage.md index d3cec1982..c8ad42276 100644 --- a/docs/user-manual/zh/4-proxy/4.4-usage.md +++ b/docs/user-manual/zh/4-proxy/4.4-usage.md @@ -50,10 +50,15 @@ v3.13.0 起，用量数据有两个来源： | 指标 | 说明 | |------|------| | 总请求数 | 统计周期内的请求总数 | -| 总 Token | 输入 + 输出 Token 总数 | +| 真实消耗 Tokens | 输入 + 输出 + 缓存创建 + 缓存读取的缓存归一化总量 | +| 缓存命中率 | 缓存读取 Token 在可缓存输入中的占比 | | 估算费用 | 基于定价配置计算的费用 | | 成功率 | 成功请求的百分比 | +v3.15.0 起，用量页顶部改为筛选驱动的 Hero 卡。切换日期范围、应用、供应商或模型筛选时，Hero 中的真实消耗 Tokens、缓存命中率、请求数和费用会同步更新，并与下方日志和统计列表保持一致。 + +> 注意：由于缓存读取、缓存创建和 OpenAI 类协议的缓存上报方式在 v3.15.0 中做了归一化，历史 token 与费用数字可能与旧版估算不完全一致；新数字以当前归一化规则为准。 + ### 时间范围 可选择统计的时间范围： diff --git a/docs/user-manual/zh/4-proxy/4.5-model-test.md b/docs/user-manual/zh/4-proxy/4.5-model-test.md index 3cecea69b..331906609 100644 --- a/docs/user-manual/zh/4-proxy/4.5-model-test.md +++ b/docs/user-manual/zh/4-proxy/4.5-model-test.md @@ -10,7 +10,7 @@ - 响应延迟是否正常 - 流式响应首字节时间（TTFB） -v3.13.0 起，Stream Check 覆盖范围扩展到**全部五个应用**（Claude / Codex / Gemini / OpenCode / OpenClaw），包括 OpenClaw 的全部协议变体（`openai-completions` 等）。OpenCode 通过 npm 包映射自动识别；OpenClaw 支持自定义 `auth-header` 检测，并处理了 Bedrock 错误消息、`baseURL` 回退等边界情况。 +v3.13.0 起，Stream Check 覆盖范围扩展到 **Claude / Codex / Gemini / OpenCode / OpenClaw**，包括 OpenClaw 的全部协议变体（`openai-completions` 等）。OpenCode 通过 npm 包映射自动识别；OpenClaw 支持自定义 `auth-header` 检测，并处理了 Bedrock 错误消息、`baseURL` 回退等边界情况。 ## 打开配置 diff --git a/docs/user-manual/zh/README.md b/docs/user-manual/zh/README.md index defacb36c..59d22fae2 100644 --- a/docs/user-manual/zh/README.md +++ b/docs/user-manual/zh/README.md @@ -1,6 +1,6 @@ # CC Switch 用户手册 -> Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw 全方位辅助工具 +> Claude Code / Claude Desktop / Codex / Gemini CLI / OpenCode / OpenClaw / Hermes 全方位辅助工具 ## 目录结构 @@ -115,13 +115,16 @@ - **Claude Desktop 一等管理面板**：支持第三方供应商、直连 / 模型映射两种模式、Copilot / Codex OAuth 复用与 3P profile 写入 — 详见 [2.6 Claude Desktop](./2-providers/2.6-claude-desktop.md) - **按角色的模型映射**：用 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 后端拉取最新模型列表 +- **用量看板筛选驱动 Hero**：展示缓存归一化后的真实总 token 与缓存命中率，并跟随日期 / 供应商 / 模型筛选实时更新 — 详见 [4.4 用量统计](./4-proxy/4.4-usage.md) - **轻量模式**：退出到托盘时销毁主窗口，空闲占用接近零 — 详见 [1.5 个性化配置](./1-getting-started/1.5-settings.md) - **配额与余额展示**：官方订阅类（Claude/Codex/Gemini/Copilot/Codex OAuth）自动展示剩余额度；Token Plan 和第三方余额通过内置模板一键启用 — 详见 [2.5 用量查询](./2-providers/2.5-usage-query.md) - **Codex OAuth 反向代理**：用 ChatGPT 账号在 Claude Code 中复用 Codex 服务 — 详见 [2.1 添加供应商](./2-providers/2.1-add.md) -- **托盘按应用分级菜单**：五应用独立子菜单，防止菜单溢出 — 详见 [2.2 切换供应商](./2-providers/2.2-switch.md) +- **托盘按应用分级菜单**：Claude / Codex / Gemini 独立子菜单，标题展示当前供应商与可用用量摘要 — 详见 [2.2 切换供应商](./2-providers/2.2-switch.md) - **Skills 发现与批量更新**：SHA-256 更新检测、批量更新、skills.sh 公共注册表搜索 — 详见 [3.3 Skills 技能管理](./3-extensions/3.3-skills.md) - **完整 URL 端点模式**：高级选项支持将 base_url 视作完整上游端点 — 详见 [2.1 添加供应商](./2-providers/2.1-add.md) -- **OpenCode / OpenClaw 流式检测全覆盖**：Stream Check 面板扩展到全部五个应用 — 详见 [4.5 模型检查](./4-proxy/4.5-model-test.md) +- **OpenCode / OpenClaw 流式检测覆盖**：Stream Check 面板覆盖 Claude / Codex / Gemini / OpenCode / OpenClaw — 详见 [4.5 模型检查](./4-proxy/4.5-model-test.md) ## 贡献