Appearance
Base URL 到底加不加 /v1 避坑指南
许多用户在接入 API 时遇到的 404 Not Found 错误，90% 都是由于 Base URL 末尾的 /v1 拼接错误引起的。
1. 原理说明
标准的 OpenAI 兼容 Chat Completions 请求最终需要发送到：
text
https://aikeydock.online/v1/chat/completions不同的客户端软件在设计时有两种不同的拼接逻辑：
- 逻辑 A（直接在 Base URL 后拼
/chat/completions）：- 此时若 Base URL 没有
/v1，请求会变成https://aikeydock.online/chat/completions➔ 报错 404。 - 正确填法：
https://aikeydock.online/v1。
- 此时若 Base URL 没有
- 逻辑 B（自动在 Base URL 后拼
/v1/chat/completions或 Claude Code 自带/v1/messages）：- 此时若 Base URL 填了
/v1，请求会变成https://aikeydock.online/v1/v1/chat/completions➔ 报错 404。 - 正确填法：
https://aikeydock.online。
- 此时若 Base URL 填了
2. 常见工具速查
| 工具 / 框架 | 推荐 Base URL 填法 | 说明 |
|---|---|---|
Claude Code (settings.json) | https://aikeydock.online | 裸域名（客户端自动拼 /v1/messages） |
Codex (config.toml) | https://aikeydock.online | 裸域名（客户端自动拼 /responses） |
| Cursor Settings | https://aikeydock.online/v1 | 标准 OpenAI 兼容端点（带 /v1） |
OpenCode (opencode.json) | https://aikeydock.online/v1 | 标准 OpenAI 兼容端点（带 /v1） |
| CC Switch 一键导入 | 由客户端自动处理 | 导入智坞提供商条目即可 |
快速排错口诀
如果看到 404 page not found 或 Route not found，请先检查 Base URL：如果带了 /v1 就去掉试试，如果没带 /v1 就加上试试！