快速开始
Base URL
不同协议、不同工具该填哪个地址，以及 /v1 的取舍。
网关的统一根地址如下。不同协议、不同工具在此基础上拼接路径，填错多一个或少一个 /v1 是最常见的 404 原因。
根地址
https://api.easyapi.cc不带 /v1。Claude Code、Anthropic SDK、Cherry Studio、Gemini CLI 直接填这个。
按协议
用官方 SDK 或直接发 HTTP 请求时，按协议选择：
| 协议 | SDK 里填的 Base URL | 完整接口地址 |
|---|---|---|
| OpenAI 兼容 | https://api.easyapi.cc/v1OpenAI SDK 的 base_url / baseURL | https://api.easyapi.cc/v1/chat/completions |
| Anthropic 兼容 | https://api.easyapi.ccAnthropic SDK 会自己追加 /v1/messages | https://api.easyapi.cc/v1/messages |
| Gemini 兼容 | https://api.easyapi.ccGoogle GenAI SDK 会自己追加 /v1beta | https://api.easyapi.cc/v1beta/models/{model}:generateContent |
按工具
许多工具会自己补上 /v1 或具体接口路径，这时只能填根地址；另一些则要求完整前缀。以下是各工具页面里实际使用的值：
| 工具 | 填写的地址 | 说明 |
|---|---|---|
| Claude Code | https://api.easyapi.cc | ANTHROPIC_BASE_URL，根地址 |
| Codex CLI | https://api.easyapi.cc/v1 | config.toml 里的 base_url，带 /v1 |
| Gemini CLI | https://api.easyapi.cc | GOOGLE_GEMINI_BASE_URL，根地址 |
| Cursor | https://api.easyapi.cc/v1 | Override OpenAI Base URL，带 /v1 |
| Cline / Roo Code | https://api.easyapi.cc/v1 或 https://api.easyapi.cc | OpenAI Compatible 模式带 /v1；Anthropic 模式填根地址 |
| Cherry Studio | https://api.easyapi.cc | 三种协议的端点都填根地址 |
| OpenCode | https://api.easyapi.cc/v1 | provider 的 baseURL，带 /v1 |
| CC Switch | https://api.easyapi.cc | 控制台一键导入会自动填好 |
排查
| 现象 | 常见原因 |
|---|---|
| 404 Not Found | 地址多了或少了 /v1，或模型名不存在。 |
| 401 Unauthorized | 密钥不对、复制不完整，或请求头缺少 Bearer 前缀。 |
| Gemini 请求失败 | Gemini 协议路径是 /v1beta 而不是 /v1，SDK 里应填根地址。 |
更多状态码见 错误码。