故障排查

故障排查

401 / 403

  1. 先执行：
clovapi test <profile-name>
  1. 检查：
  • API key 是否有效
  • Base URL 是否带了正确路径（如 OpenAI 兼容通常带 /v1）
  • 模型名是否存在

Claude Code 认证冲突

如果出现 token / api key 冲突，重新执行：

clovapi switch --cli claude-code <profile-name>

并确认 Claude 配置中仅保留 clovapi 写入的认证字段。

OpenCode 切换后看起来“没变化”

优先检查项目级配置是否覆盖全局配置（例如仓库内 opencode.json）。

一键重置

clovapi reset --yes

会清空保存的 profile 和 active 绑定，请谨慎执行。