常见问题

通用问题

无法连接

检查网络，关闭代理重试
在终端直接运行 CLI 测试

401 Unauthorized

清空环境变量中残留的 API Key
确认令牌正确且未过期

模型不存在

在「模型广场」确认分组内有该模型
检查模型名拼写

Claude Code

配置文件

Windows: %userprofile%\.claude\settings.json
macOS: ~/.claude/settings.json

VS Code 插件不生效

在配置目录创建 config.json：

json

{ "primaryApiKey": "hoxkai" }

Codex

配置文件

Windows: %userprofile%\.codex\
macOS: ~/.codex/

403 错误 - 终止对话后重试

Gemini

配置文件

Windows: %userprofile%\.gemini\.env
macOS: ~/.gemini/.env

401/403 错误 - 检查 GEMINI_API_KEY 和 GOOGLE_GEMINI_BASE_URL