Agent 接入总览

瑞科 API 对常用 Agent 提供两类接入方式：

1. OpenAI 兼容模式：设置 Base URL 和 API Key，适合 Codex、Gemini CLI、Cursor、Cline 等。
2. Anthropic 原生模式：设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，适合 Claude Code。

通用配置

Base URL: https://api.ruikon.com
API Key: 你的 API Key

大多数客户端需要填完整的 https://api.ruikon.com/v1，也有客户端要求填写不带 /v1 的根地址。以该客户端页面提示为准：

客户端配置项	推荐值
OpenAI Base URL	https://api.ruikon.com/v1
Anthropic Base URL	https://api.ruikon.com
Gemini API Base	https://api.ruikon.com/v1beta
API Key	站内创建的 API Key

配置顺序

1. 在站内创建 API Key。
2. 给 API Key 选择分组。
3. 根据客户端类型选择对应页面。
4. 重启客户端或终端。
5. 发送一条短请求。
6. 在“使用记录”确认请求模型和费用。

客户端索引

• Codex CLI
• Claude Code / Claude Desktop
• Gemini CLI
• Cursor、Cline、Roo Code
• Continue、Cherry Studio、OpenCode
• CCSwitch

不要混用协议

Claude Code 使用 /v1/messages，Gemini 原生调用使用 /v1beta/models/...，OpenAI 兼容客户端通常使用 /v1/chat/completions 或 /v1/responses。接口路径与分组平台不匹配时会出现 403 或模型不存在。