v3.1.5
This release contains the October/November issue fixes merged since v3.1.4.
- Fix provider credential fallback, vendor-qualified model routing, stale profile model selections, and context-window/reasoning metadata discovery.
- Preserve native Anthropic safeguards, classifier verdicts and tool-use IDs through virtual models and JSON/SSE. Profiles with internal gateway tools explicitly reject incompatible safeguards requests; upstream eligibility still controls no-charge server review.
- Add Restore original settings to system-default Claude Code/Codex profiles. Recovery works with the gateway stopped, persists the disabled state, and preserves unrelated Claude settings. Client errors identify the failed provider/model and nested upstream cause.
- Fix Codex workspace routing, shared-account credential refresh visibility, legacy per-profile auth copies and native desktop backend connections.
- Deliver protocol-native terminal errors for interrupted native, converted and virtual-model streams. Add a provider compatibility switch for upstreams that reject deferred tool flags.
- Bound request-log migrations and cleanup, route-script work, and large request-body processing. Improve Windows process visibility, Pi launch arguments, ToolHub stdio framing and Anthropic tool-result image conversion.
- Update Electron to 42.11.18 and retain non-root Docker service execution.
Downloads
| Platform | Installer |
|---|---|
| Windows x64 | EXE |
| Linux x64 | AppImage |
| macOS Apple Silicon | DMG |
| macOS Intel | DMG |
CLI: npm install -g @musistudio/claude-code-router@3.1.5
Docker: musistudio/claude-code-router:3.1.5 (linux/amd64 and linux/arm64).
Validation
CCR: 1,529 passed, 7 platform-specific skips. Patched gateway: 978 passed, 7 skipped. Typechecks, production builds, bilingual docs and Docker system smoke passed. Classifier validation used mock upstreams; live-account billing eligibility was not tested.
中文:本版修复供应商与凭据回退、模型配置校验、Codex 账号及桌面路由、流式中断和 safeguards 透传,并新增系统默认 Agent 配置的“恢复原始设置”入口。中英文 README 下载链接同步更新。