先确定表单要的是哪一层地址

AIGoCode 的 Base URL 页面把地址分成两类：协议地址和工具地址。协议客户端通常需要明确的版本前缀，CLI 或桌面客户端可能会自己拼接版本和具体端点。看到一个输入框时，先确认它属于哪种接入方式，再决定是否写 /v1 或 /v1beta。

三种兼容协议的官方地址

官方页面给出的统一服务根地址是 https://api.aigocode.dev。协议 Base URL 对应为：OpenAI Compatible 使用 https://api.aigocode.dev/v1，Anthropic Compatible 使用 https://api.aigocode.dev/v1，Gemini Compatible 使用 https://api.aigocode.dev/v1beta。这些值是协议层地址，适合直接发 HTTP 请求或由 SDK 作为协议入口使用。

工具为什么常常只填根地址

很多 CLI 或桌面客户端会自己追加 /v1、/v1beta 或具体 endpoint。官方页面列举 Claude Code、Codex、Cherry Studio、OpenCode、OpenClaw、Hermes 的教程会明确说明填写根地址还是协议地址。Claude Code 接入文档还把“配置完成后进入代码项目目录运行 claude”作为验证步骤，因此不能把协议地址原样复制到所有工具的同一个表单。

按错误现象排查

404 Not Found：先检查 Base URL 是否多填或少填了 /v1、/v1beta。
401 Unauthorized：检查 API Key 是否正确，并按当前协议文档核对认证字段。
Gemini 请求失败：先确认 Gemini 兼容协议使用了 /v1beta。

一次只改一个配置项，并保留实际请求地址和脱敏错误，才能知道问题是地址层级还是认证字段。

Claude Code 的最小验收

如果你使用 Claude Code，请先打开 Base URL 说明对照该工具要求的地址层级，再按 Claude Code 接入文档完成配置。遇到地址或认证错误，再查看错误码说明继续排查。