文档

接入文档

三步开始：注册 → 创建密钥 → 改一行 BASE_URL。所有工具共用同一把密钥。

获取 API 密钥

  1. 注册账号（邮箱或 LinuxDo 登录）
  2. 在控制台 充值（¥50 起，¥1 = $1 额度）
  3. 在控制台「API 密钥」页创建密钥，并选择分组（推荐 Claude 稳定分组）

Base URL 与端点

网关地址 https://api.orcai.cc
协议端点适用客户端
Anthropic Messageshttps://api.orcai.cc/v1/messagesClaude Code、Anthropic SDK、Cherry Studio
OpenAI Chat Completionshttps://api.orcai.cc/openai/v1/chat/completionsCursor、OpenAI SDK、NextChat 等
OpenAI Responseshttps://api.orcai.cc/openai/v1/responsesCodex CLI

客户端配置指南

Claude Code

Anthropic 官方终端编程工具。设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 两个变量即可。

查看教程 →

Codex CLI

OpenAI 的终端编程工具。在 config.toml 里添加 orcai provider，模型 gpt-5.6。

查看教程 →

CC-Switch

桌面应用，一键把 OrcAI 写入 Claude Code / Codex / Gemini CLI 的配置，支持多供应商切换。

查看教程 →

Cursor / OpenAI SDK

任何支持自定义 OpenAI Base URL 的工具：填 https://api.orcai.cc/openai/v1 与密钥即可。

查看说明 →

常见错误

错误码速查
状态含义处理
401 Unauthorized密钥错误或未激活到控制台确认密钥状态，检查是否带了 Bearer 前缀或多余空格
402 Insufficient Quota额度不足充值 后立即恢复
429 Too Many Requests触发分组并发 / 速率限制退避重试；长期高并发请联系企业分组
400（CC-Switch 健康检查）探针格式与网关不匹配正常现象，实际调用不受影响
404 model not found该分组不含此模型对照 模型列表 换分组或换模型 ID

需要帮助：Telegram 群 @orcAiAPI · 客服 @Orcai_api

最后更新：2026-10-05 · 作者：OrcAI 团队