Problem entry · machine-readable · 网关与路由

JSON / API 配置错误导致服务启动失败

本页嵌入 #trove-entity JSON(本条目全量结构化数据);全库数据见 /agent/trove.json。

元数据

idclaude-code-router-6收录2026-08-29
问题域网关与路由主题分组Agent 工具·运行与配置
适用工具claude-code-router

症状

修改配置后 `ccr start` 报错或崩溃;管理界面 API 返回 500。

原因

provider/profile 配置 JSON 语法错误或字段名不符(如 api_base_url、type 拼写/结构错误)。

解法

1. 改前备份配置文件(`~/.claude-code-router/`)。

2. 改后用 JSON 校验工具检查语法。

3. 对照项目配置文档核对字段;改错恢复备份后重启。

验证证据

- 网页案例:CSDN 汇总篇(服务启动失败 / API / JSON 配置场景)。

- 本市场实测:写面 = `~/.claude-code-router/config.sqlite`,配置修改前先备份该目录。

来源与证据

素材来源:本站实测沉淀(2026-08-28)

验证证据:site docs#6