npm - @musistudio/claude-code-router - Versions diffs - 3.0.4 → 3.0.5 - Mend

@musistudio/claude-code-router 3.0.4 → 3.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md +178 -369
package/README_zh.md +178 -368
package/dist/main/cli.js +2818 -343
package/dist/main/fusion-vision-mcp.js +6 -6
package/dist/renderer/assets/main.css +1 -1
package/dist/renderer/assets/main.js +40 -40
package/dist/renderer/assets/tray.js +8 -8
package/package.json +2 -2

package/README.md CHANGED Viewed

@@ -1,375 +1,184 @@
-<h1 align="center">Claude Code Router Desktop</h1>
-<p align="center">
-  <a href="README_zh.md"><img alt="Chinese README" src="https://img.shields.io/badge/%F0%9F%87%A8%F0%9F%87%B3-%E4%B8%AD%E6%96%87%E7%89%88-ff0000?style=flat" /></a>
-  <a href="https://discord.gg/rdftVMaUcS"><img alt="Discord" src="https://img.shields.io/badge/Discord-%235865F2.svg?&logo=discord&logoColor=white" /></a>
-  <a href="https://x.com/musistudio2026"><img alt="X" src="https://img.shields.io/badge/X-@musistudio2026-000000?logo=x&logoColor=white" /></a>
-  <a href="https://github.com/musistudio/claude-code-router/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/musistudio/claude-code-router" /></a>
-  <a href="https://ccrdesk.top/"><img alt="Documentation" src="https://img.shields.io/badge/Docs-ccrdesk.top-0ea5e9?style=flat" /></a>
-</p>
-<div align="center">
-<table width="100%">
-  <tr>
-    <td align="center">
-      <a href="https://www.kimi.com/code?aff=ccr">
-        <img src="https://gcdn.moonshot.cn/growth-cdn/sponsor/kimi-en.png" width="960" alt="Kimi K2.7 Code sponsor banner" />
-      </a>
-      <br />
-      <sub>
-        <a href="https://www.kimi.com/code?aff=ccr"><strong>Kimi Code Subscription</strong></a>
-        &nbsp;·&nbsp;
-        <a href="https://platform.kimi.ai?aff=ccr"><strong>API Global</strong></a>
-        &nbsp;·&nbsp;
-        <a href="https://platform.kimi.com?aff=ccr">API China</a>
-      </sub>
-    </td>
-  </tr>
-  <tr>
-    <td align="left">
-      <p>
-        <strong>Thanks to Kimi for sponsoring this project!</strong> Kimi K2.7 Code is an open-source, coding-focused agentic model developed by Moonshot AI, with substantial gains on real-world long-horizon coding tasks and higher end-to-end success across complex software engineering workflows. It also cuts thinking-token usage by approximately 30% compared with K2.6. Inside CCR, Kimi ships as built-in provider presets: import the pay-as-you-go API or the Kimi Code subscription in one click and route your coding agent's requests to Kimi, the subscription endpoint passes straight through natively with no protocol conversion, API endpoints are adapted automatically, and your balance and subscription usage show up right in the CCR dashboard.
-      </p>
-      <p align="center">
-        CCR already supports Kimi. Visit the Kimi Open Platform (<a href="https://platform.kimi.com?aff=ccr">中文站</a> | <a href="https://platform.kimi.ai?aff=ccr">Global</a>) to try the API, or explore the <a href="https://www.kimi.com/code?aff=ccr">cost-effective Coding Plan</a>.
-      </p>
-    </td>
-  </tr>
-</table>
-</div>
-Claude Code Router Desktop is a local gateway and desktop control panel for routing agent requests from Claude Code, Codex, ZCode, and compatible clients to the model provider you actually want to use.
-<p align="center">
-  <img src="blog/images/claude-code-router.png" width="720" alt="Claude Code Router Desktop screenshot" />
-</p>
-## Why Use CCR
-- Use one local endpoint for multiple agent tools instead of configuring every client separately.
-- Route requests with default routing, conditional rules, fallback targets, and request rewrites instead of editing client configuration by hand.
-- Mix providers without changing your workflow. CCR supports OpenAI-compatible APIs, Anthropic Messages, Gemini Generate Content, OpenRouter, DeepSeek, SiliconFlow, Moonshot, Kimi Code, Mistral, Z.AI, Bailian, and custom providers.
-- Control cost and reliability with fallback routing, API key rotation, usage statistics, and request logs.
-## Features
-- **Overview dashboard**: inspect system status, usage widgets, account balances, model distribution, and share cards.
-- **Provider management**: add provider presets or custom endpoints, probe protocol support, test model connectivity, manage credentials, and monitor supported account balances where available.
-- **Routing rules**: configure default routing, conditional and model-prefix rules, fallback handling, and request rewrites.
-- **Agent Config**: configure Claude Code, Codex, and ZCode launch entries, models, scopes, and multi-instance app profiles.
-- **Gateway compatibility**: translate supported client requests through the local CCR model gateway.
-- **Proxy mode**: capture supported API traffic through a local proxy with optional system proxy integration and network capture.
-- **Fusion models**: combine a base model with vision, web search, or MCP tools into a reusable selectable model.
-## Documentation
-Read the full documentation at [ccrdesk.top](https://ccrdesk.top/).
-## Download And Install
-1. Open the [GitHub Releases page](https://github.com/musistudio/claude-code-router/releases).
-2. Download the package for your platform:
-   - macOS Apple Silicon: `Claude-Code-Router_<version>-mac-Apple-Silicon-arm64.dmg` or `.zip`
-   - macOS Intel: `Claude-Code-Router_<version>-mac-Intel-x64.dmg` or `.zip`
-   - Windows: `Claude Code Router_<version>.exe`
-   - Linux: `Claude Code Router_<version>.AppImage`
-3. Install and launch **Claude Code Router**.
-4. On first launch, CCR creates its local configuration database:
-   - macOS/Linux: `~/.claude-code-router/config.sqlite`
-   - Windows: `%APPDATA%\Claude Code Router\config.sqlite`
-CCR stores runtime configuration in SQLite. A legacy `config.json` is read only once for migration when no SQLite config exists.
-After the service is started from the **Server** page, CCR listens on `http://localhost:8080` by default. The **Server** page controls the gateway `Host`, `Port`, proxy mode, system proxy, network capture, and CA certificate status.
+# Claude Code Router CLI
+[中文](README_zh.md) · [Documentation](https://ccrdesk.top/en/) · [GitHub](https://github.com/musistudio/claude-code-router)
+`@musistudio/claude-code-router` is the Node.js distribution of Claude Code Router. It provides the `ccr` command, the browser-based management UI, the local model gateway, and profile launch commands without requiring Electron.
+Use the CLI on developer machines and headless hosts. If you want the tray, desktop notifications, automatic app updates, or desktop-only browser integrations, install the desktop application instead.
+## Requirements And Installation
+- Node.js 22 or newer
+- A supported upstream model provider, or a locally logged-in agent account that CCR can import
+- A locally installed agent executable when using profile launch commands
+Install globally:
+```sh
+npm install -g @musistudio/claude-code-router
+ccr --help
+```
+Upgrade or remove it with npm:
+```sh
+npm install -g @musistudio/claude-code-router@latest
+npm uninstall -g @musistudio/claude-code-router
+```
+Removing the package does not delete CCR's local configuration or databases.
 ## Quick Start
-CCR can be configured entirely from the desktop UI. Use this setup order for a clean first run.
-### 1. Add a provider
-Open **Providers**, click **Add Provider**, then choose a built-in preset or **Other / custom API endpoint**. Fill in the provider name, base URL, protocol, API key, and model list. Run protocol probing and model connectivity checks when available, then save the provider.
-### 2. Configure routing
-Open **Routing** to add conditional rules, configure request rewrites, and set fallback behavior.
-Use **Add Routing Rule** for request conditions, model-prefix routing, or rule-level fallback targets.
-### 3. Start the gateway
-Open **Server** and click **Start**. After the page shows Running, CCR listens on `http://localhost:8080`. Enable **Auto start** if you want CCR to start the local gateway whenever the desktop app opens.
-### 4. Connect your agent tool
-Open **Agent Config** and choose the client you want to use. Configure Claude Code, Codex, or ZCode, select the target model and effect scope, then apply the config. For app entries, use the **Open Agent** action to open the target app through CCR.
-### 5. Monitor and adjust
-Use **Settings → Logs & Observability** to enable request logs and agent observability. Use **Logs** to confirm `request model`, `resolved provider`, `resolved model`, status, tokens, latency, and errors; use the tray window for quick token and account status.
-## Acknowledgements
-Codex support is powered by [musistudio/codexl](https://github.com/musistudio/codexl).
-## Support & Sponsoring
-<div align="center">
-<p>If you find this project helpful, please consider sponsoring its development. Your support is greatly appreciated.</p>
-<table>
-  <tr>
-    <td align="center" width="220">
-      <a href="https://ko-fi.com/F1F31GN2GM">
-        <img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Support on Ko-fi" />
-      </a>
-      <br />
-      <sub>One-time support via Ko-fi</sub>
-    </td>
-    <td align="center" width="220">
-      <a href="https://paypal.me/musistudio1999">
-        <img src="https://img.shields.io/badge/PayPal-Sponsor-003087?logo=paypal&logoColor=white" alt="Sponsor with PayPal" />
-      </a>
-      <br />
-      <sub>International sponsorship</sub>
-    </td>
-  </tr>
-</table>
-<table>
-  <tr>
-    <td align="center" width="220">
-      <strong>Alipay</strong>
-      <br />
-      <img src="/blog/images/alipay.jpg" width="160" alt="Alipay QR code" />
-    </td>
-    <td align="center" width="220">
-      <strong>WeChat Pay</strong>
-      <br />
-      <img src="/blog/images/wechat.jpg" width="160" alt="WeChat Pay QR code" />
-    </td>
-  </tr>
-</table>
-</div>
-### Our Sponsors
-<div align="center">
-<p>A huge thank you to all our sponsors for their generous support.</p>
-<table width="100%">
-  <tr>
-    <td align="center" width="330">
-      <a href="https://www.bigmodel.cn/claude-code?ic=FPF9IVAGFJ">
-        <img src="/docs/public/provider-icons/zhipu-cn-general.png" width="42" height="42" alt="Zhipu icon" />
-        <br />
-        <strong>Z智谱</strong>
-      </a>
-    </td>
-    <td align="center" width="330">
-      <a href="https://aihubmix.com/">
-        <img src="https://www.google.com/s2/favicons?domain=aihubmix.com&amp;sz=128" width="42" height="42" alt="AIHubmix icon" />
-        <br />
-        <strong>AIHubmix</strong>
-      </a>
-    </td>
-    <td align="center" width="330">
-      <a href="https://ai.burncloud.com">
-        <img src="https://www.burncloud.com/favicon.png" width="42" height="42" alt="BurnCloud icon" />
-        <br />
-        <strong>BurnCloud</strong>
-      </a>
-    </td>
-    <td align="center" width="330">
-      <a href="https://share.302.ai/ZGVF9w">
-        <img src="https://www.google.com/s2/favicons?domain=302.ai&amp;sz=128" width="42" height="42" alt="302.AI icon" />
-        <br />
-        <strong>302.AI</strong>
-      </a>
-    </td>
-  </tr>
-  <tr>
-    <td align="center" width="330">
-      <a href="https://runapi.co/register?aff=IX1t">
-        <img src="/docs/public/provider-icons/runapi.jpg" width="42" height="42" alt="RunAPI icon" />
-        <br />
-        <strong>RunAPI</strong>
-      </a>
-    </td>
-    <td align="center" width="330">
-      <a href="https://teamorouter.com/">
-        <img src="/docs/public/provider-icons/teamorouter.png" width="42" height="42" alt="TeamoRouter icon" />
-        <br />
-        <strong>TeamoRouter</strong>
-      </a>
-    </td>
-    <td align="center" width="330">
-      <a href="https://s.qiniu.com/AVjMVf">
-        <img src="/docs/public/provider-icons/qiniu-ai.png" width="42" height="42" alt="Qiniu Cloud AI icon" />
-        <br />
-        <strong>Qiniu Cloud AI</strong>
-      </a>
-    </td>
-    <td align="center" width="330">
-      <a href="https://api.fenno.ai/register?redirect=/purchase?tab=subscription%26group=16&amp;aff=9HHHAB5QLAES">
-        <img src="/docs/public/provider-icons/fenno.jpg" width="42" height="42" alt="Fenno.ai icon" />
-        <br />
-        <strong>Fenno.ai</strong>
-      </a>
-    </td>
-  </tr>
-</table>
-<h4>Community Sponsors</h4>
-<table width="100%">
-  <tr>
-    <td align="center" width="220">@Simon Leischnig</td>
-    <td align="center" width="220"><a href="https://github.com/duanshuaimin">@duanshuaimin</a></td>
-    <td align="center" width="220"><a href="https://github.com/vrgitadmin">@vrgitadmin</a></td>
-    <td align="center" width="220">@*o</td>
-    <td align="center" width="220"><a href="https://github.com/ceilwoo">@ceilwoo</a></td>
-    <td align="center" width="220">@*说</td>
-  </tr>
-  <tr>
-    <td align="center" width="220">@*更</td>
-    <td align="center" width="220">@K*g</td>
-    <td align="center" width="220">@R*R</td>
-    <td align="center" width="220"><a href="https://github.com/bobleer">@bobleer</a></td>
-    <td align="center" width="220">@*苗</td>
-    <td align="center" width="220">@*划</td>
-  </tr>
-  <tr>
-    <td align="center" width="220"><a href="https://github.com/Clarence-pan">@Clarence-pan</a></td>
-    <td align="center" width="220"><a href="https://github.com/carter003">@carter003</a></td>
-    <td align="center" width="220">@S*r</td>
-    <td align="center" width="220">@*晖</td>
-    <td align="center" width="220">@*敏</td>
-    <td align="center" width="220">@Z*z</td>
-  </tr>
-  <tr>
-    <td align="center" width="220">@*然</td>
-    <td align="center" width="220"><a href="https://github.com/cluic">@cluic</a></td>
-    <td align="center" width="220">@*苗</td>
-    <td align="center" width="220"><a href="https://github.com/PromptExpert">@PromptExpert</a></td>
-    <td align="center" width="220">@*应</td>
-    <td align="center" width="220"><a href="https://github.com/yusnake">@yusnake</a></td>
-  </tr>
-  <tr>
-    <td align="center" width="220">@*飞</td>
-    <td align="center" width="220">@董*</td>
-    <td align="center" width="220">@*汀</td>
-    <td align="center" width="220">@*涯</td>
-    <td align="center" width="220">@*:-）</td>
-    <td align="center" width="220">@**磊</td>
-  </tr>
-  <tr>
-    <td align="center" width="220">@*琢</td>
-    <td align="center" width="220">@*成</td>
-    <td align="center" width="220">@Z*o</td>
-    <td align="center" width="220">@*琨</td>
-    <td align="center" width="220"><a href="https://github.com/congzhangzh">@congzhangzh</a></td>
-    <td align="center" width="220">@*_</td>
-  </tr>
-  <tr>
-    <td align="center" width="220">@Z*m</td>
-    <td align="center" width="220">@*鑫</td>
-    <td align="center" width="220">@c*y</td>
-    <td align="center" width="220">@*昕</td>
-    <td align="center" width="220"><a href="https://github.com/witsice">@witsice</a></td>
-    <td align="center" width="220">@b*g</td>
-  </tr>
-  <tr>
-    <td align="center" width="220">@*亿</td>
-    <td align="center" width="220">@*辉</td>
-    <td align="center" width="220">@JACK</td>
-    <td align="center" width="220">@*光</td>
-    <td align="center" width="220">@W*l</td>
-    <td align="center" width="220"><a href="https://github.com/kesku">@kesku</a></td>
-  </tr>
-  <tr>
-    <td align="center" width="220"><a href="https://github.com/biguncle">@biguncle</a></td>
-    <td align="center" width="220">@二吉吉</td>
-    <td align="center" width="220">@a*g</td>
-    <td align="center" width="220">@*林</td>
-    <td align="center" width="220">@*咸</td>
-    <td align="center" width="220">@*明</td>
-  </tr>
-  <tr>
-    <td align="center" width="220">@S*y</td>
-    <td align="center" width="220">@f*o</td>
-    <td align="center" width="220">@*智</td>
-    <td align="center" width="220">@F*t</td>
-    <td align="center" width="220">@r*c</td>
-    <td align="center" width="220"><a href="https://github.com/qierkang">@qierkang</a></td>
-  </tr>
-  <tr>
-    <td align="center" width="220">@*军</td>
-    <td align="center" width="220"><a href="https://github.com/snrise-z">@snrise-z</a></td>
-    <td align="center" width="220">@*王</td>
-    <td align="center" width="220"><a href="https://github.com/greatheart1000">@greatheart1000</a></td>
-    <td align="center" width="220">@*王</td>
-    <td align="center" width="220">@zcutlip</td>
-  </tr>
-  <tr>
-    <td align="center" width="220"><a href="https://github.com/Peng-YM">@Peng-YM</a></td>
-    <td align="center" width="220">@*更</td>
-    <td align="center" width="220">@*.</td>
-    <td align="center" width="220">@F*t</td>
-    <td align="center" width="220">@*政</td>
-    <td align="center" width="220">@*铭</td>
-  </tr>
-  <tr>
-    <td align="center" width="220">@*叶</td>
-    <td align="center" width="220">@七*o</td>
-    <td align="center" width="220">@*青</td>
-    <td align="center" width="220">@**晨</td>
-    <td align="center" width="220">@*远</td>
-    <td align="center" width="220">@*霄</td>
-  </tr>
-  <tr>
-    <td align="center" width="220">@**吉</td>
-    <td align="center" width="220">@**飞</td>
-    <td align="center" width="220">@**驰</td>
-    <td align="center" width="220">@x*g</td>
-    <td align="center" width="220">@**东</td>
-    <td align="center" width="220">@*落</td>
-  </tr>
-  <tr>
-    <td align="center" width="220">@哆*k</td>
-    <td align="center" width="220">@*涛</td>
-    <td align="center" width="220"><a href="https://github.com/WitMiao">@苗大</a></td>
-    <td align="center" width="220">@*呢</td>
-    <td align="center" width="220">@d*u</td>
-    <td align="center" width="220">@crizcraig</td>
-  </tr>
-  <tr>
-    <td align="center" width="220">s*s</td>
-    <td align="center" width="220">*火</td>
-    <td align="center" width="220">*勤</td>
-    <td align="center" width="220">**锟</td>
-    <td align="center" width="220">*涛</td>
-    <td align="center" width="220">**明</td>
-  </tr>
-  <tr>
-    <td align="center" width="220">*知</td>
-    <td align="center" width="220">*语</td>
-    <td align="center" width="220">*瓜</td>
-    <td align="center" width="220"></td>
-    <td align="center" width="220"></td>
-    <td align="center" width="220"></td>
-  </tr>
-</table>
-<sub>If your name is masked, please contact me via my homepage email to update it with your GitHub username.</sub>
-</div>
+Start the background service and open the management UI:
+```sh
+ccr ui
+```
+Then:
+1. Add an upstream provider and at least one model.
+2. Create a CCR client key under **API Keys**.
+3. Configure routing if the default provider/model is not sufficient.
+4. Confirm that the gateway is running under **Server**.
+5. Point your client at the gateway URL shown in the UI. The default gateway is `http://127.0.0.1:3456`; the management UI defaults to `http://127.0.0.1:3458`.
+The management token and CCR client API keys are different credentials. The management token protects the browser UI and RPC API. CCR client keys authenticate model requests sent to the gateway.
+## Service Commands
+| Command | Behavior |
+| --- | --- |
+| `ccr start` | Starts a detached background management service and gateway, then prints its authenticated management URL. |
+| `ccr ui` | Reuses or starts the background service and opens the management UI. |
+| `ccr stop` | Stops the detached service started by `ccr start` or `ccr ui`. |
+| `ccr serve` | Runs the management service and gateway in the foreground. `ccr web` is an alias. |
+| `ccr <profile>` | Opens an enabled Agent Config profile by name or ID. |
+### `ccr start`
+```text
+ccr start [--host <host>] [--port <port>] [--open|--no-open] [--gateway|--no-gateway]
+```
+- `--host <host>`: management listener, default `127.0.0.1`.
+- `--port <port>`: preferred management port, default `3458`.
+- `--open` / `--no-open`: enable or disable opening a browser.
+- `--gateway`: explicitly request gateway startup; this is the default.
+- `--no-gateway`: start only the management service.
+### `ccr ui`
+```text
+ccr ui [--host <host>] [--port <port>] [--open|--no-open] [--gateway|--no-gateway]
+```
+`ui` opens the browser by default. Use `--no-open` on SSH or other headless sessions.
+### `ccr serve`
+```text
+ccr serve [--host <host>] [--port <port>] [--open|--no-open] [--gateway|--no-gateway]
+```
+`serve` stays attached to the current terminal and handles `SIGINT`/`SIGTERM`. It is the appropriate mode for a process supervisor. `ccr stop` only manages the detached service; stop a foreground server through its terminal or supervisor.
+If the preferred management port is occupied, CCR tries the next available ports and prints the actual URL. When `start` or `ui` reuses an existing service, new host, port, and `--no-gateway` choices do not reconfigure that process. Run `ccr stop` first when those settings must change.
+## Agent Config Profiles
+Create and enable profiles in **Agent Config**, then launch one by name or ID:
+```sh
+ccr "Codex - Work"
+ccr "Codex - Work" app
+ccr "Claude - Review" cli -- --model sonnet
+ccr profile-id -- --help
+```
+The syntax is:
+```text
+ccr <profile-name-or-id> [cli|app] [-- <agent arguments>]
+```
+- `--cli` and `--app` are accepted alternatives to the positional surface.
+- Put agent-specific arguments after `--` so they cannot be confused with CCR options.
+- If the surface is omitted, CCR uses the first surface allowed by the profile: CLI for Claude Code, Codex, and Grok CLI; App for ZCode.
+- Grok supports CLI only. ZCode supports App only. Claude App and ZCode App do not accept trailing agent arguments.
+- Desktop App launches require that app to be installed and a graphical session to be available.
+- Start the CCR service before opening most profiles. A Grok CLI profile can start a temporary shared service automatically and stops it after the last managed session exits.
+The desktop application installs a related command named `ccr-app`. Commands copied from desktop Agent Config cards use `ccr-app`; the npm package documented here installs `ccr`.
+## Configuration And Runtime Files
+| Platform | Config directory |
+| --- | --- |
+| macOS / Linux | `~/.claude-code-router` |
+| Windows | `%APPDATA%\claude-code-router` |
+Important files include:
+- `config.sqlite`: current application configuration.
+- `app-data/`: API key, usage, request-log, certificate, and other runtime databases/files.
+- `service.json`: state and private token for a detached CLI service.
+- `gateway.config.json`: generated gateway runtime configuration.
+- `profiles/` and `bin/`: isolated profile configuration and launch wrappers.
+Do not edit or copy live SQLite files while CCR is writing to them. Use the UI export feature, or stop CCR before taking a filesystem backup.
+## Environment And Security
+| Variable | Description |
+| --- | --- |
+| `CCR_WEB_HOST` | Default management listener when `--host` is omitted. |
+| `CCR_WEB_PORT` | Default management port when `--port` is omitted. |
+| `CCR_WEB_AUTH_TOKEN` | Fixes the management UI/RPC token instead of generating a random token for the process. |
+The authenticated management URL contains `ccr_web_token` in its query string. Treat that URL like a password and avoid copying it into logs, tickets, or shell history. Bind to `127.0.0.1` unless remote access is intentional. For remote access, use a firewall or private network plus TLS at a trusted reverse proxy.
+Do not expose the gateway without creating CCR client API keys. Upstream provider credentials are stored in CCR's local data directory, so protect that directory and its backups.
+## Troubleshooting
+### `ccr` is not found
+Confirm Node.js is version 22 or later and that npm's global binary directory is on `PATH`:
+```sh
+node --version
+npm prefix -g
+```
+Open a new shell after installation if your shell caches command paths.
+### The management URL changed ports
+The requested port was already occupied. Use the URL printed by CCR, or stop the conflicting process and restart CCR.
+### The UI opens but the gateway is unavailable
+The management service can run without a usable gateway. Add a provider and model, create a client API key, then start or restart the gateway from **Server**. Check the foreground output from `ccr serve` when diagnosing startup errors.
+### A profile cannot be found
+Only enabled profiles are launchable. Names are matched without case and sanitized names are accepted, but ambiguous names require the profile ID. Re-save the profile if its generated launcher is missing.
+### A background service uses old options
+Stop and recreate it:
+```sh
+ccr stop
+ccr start --host 127.0.0.1 --port 3458
+```
+## Docker
+The repository also includes a Docker image for gateway and browser-UI deployments. It does not install the npm `ccr` command into the runtime image. See the [Docker deployment guide](https://github.com/musistudio/claude-code-router/blob/main/docker/README.md).
 ## License
-This project is licensed under the [MIT License](LICENSE).
+[MIT](LICENSE)