AI 编程接入指南
统一模型接入,
更快开始 AI 开发
本文档适用于 Claude Code、Cherry Studio、Cline、Roo Code、Cursor、VS Code 等工具。
按照下面步骤配置后,即可使用悦云code 的统一 API 服务。
遇到问题时,请优先查看服务状态页,再联系售后排查。
API 配置示例
● ONLINE
Claude Code
OpenAI
Cherry Studio
ANTHROPIC_BASE_URL=https://yuai.space
ANTHROPIC_API_KEY=sk-你的令牌
# OpenAI 兼容工具使用:
Base URL: https://yuai.space/v1
01注册账号
02兑换额度
03创建令牌
04配置工具
快速开始
开始前,请先准备好:
- 悦云code 账号
- 已充值或已兑换额度
- 一个可用 API Key,也就是令牌
- Node.js 18 或以上版本,推荐 LTS 版本
常用地址
Claude Code / Anthropic Base URL
https://yuai.space
OpenAI Compatible Base URL
https://yuai.space/v1
简单记法:Claude Code 填 https://yuai.space;Cherry Studio、Cline、Roo Code 等 OpenAI 兼容工具通常填 https://yuai.space/v1。
注册、兑换与创建令牌
1. 注册账号
打开 https://yuai.space,点击右上角注册并登录。
2. 兑换额度
进入控制台:
钱包管理 → 兑换码充值
3. 创建 API Key
进入:
令牌管理 → 添加令牌
创建后复制生成的 Key,格式通常类似:
sk-xxxxxxxxxxxxxxxx
请不要把 API Key 发到公开群、GitHub、论坛或截图里。若怀疑泄露,请立即删除旧 Key 并重新创建。
Claude Code 配置
1. 检查 Node.js
node -v
npm -v
2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
如果安装较慢,可以尝试:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
3. Windows PowerShell 配置
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://yuai.space", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的API_KEY", "User")
设置完成后关闭终端,重新打开 PowerShell,然后执行:
claude
4. macOS / Linux 配置
echo 'export ANTHROPIC_BASE_URL="https://yuai.space"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="你的API_KEY"' >> ~/.zshrc
source ~/.zshrc
claude
Cherry Studio / Cline / Roo Code 配置
Cherry Studio
服务商类型选择:
OpenAI 兼容
填写:
API 地址:https://yuai.space/v1
API Key:你的悦云code API Key
Cline / Roo Code
Provider 选择:
OpenAI Compatible
填写:
Base URL:https://yuai.space/v1
API Key:你的悦云code API Key
模型名请以控制台「模型广场」展示为准,例如:
claude-sonnet-4-6
claude-opus-4-8
套餐与分组建议
- 体验版:适合轻量测试,不建议跑长任务。
- 标准版:适合日常代码辅助、问答、轻量开发。
- Pro 满血:适合 Claude Code、Cursor、复杂代码分析。
- Max 高稳:适合长任务、重要项目、稳定性要求高的场景。
- Origin 原厂:适合对稳定性和来源要求最高的场景。
常见问题
API Key 无效
- 检查 Key 是否复制完整。
- 检查 Key 前后是否多了空格。
- 检查令牌是否有额度。
- 检查令牌绑定分组是否支持当前模型。
- 检查 Base URL 是否填写正确。
429 Too Many Requests
请求过于频繁,触发了速率限制。建议降低并发,等待几秒后重试。
500 / 502 / 504 错误
通常与上游服务、网络波动或请求超时有关。请先查看服务状态页:
https://status.yuai.space
Claude Code 扣费较快
编程工具会产生较多上下文和输出内容,尤其是长代码文件分析、多轮修改、大量终端输出和高等级模型。建议先描述清楚任务,再让模型执行。
联系售后时请提供
- 使用工具:Claude Code / Cursor / Cherry Studio / Cline / Roo Code
- 操作系统:Windows / macOS / Linux
- 报错截图
- 使用的分组名称
- 大概发生时间
- 是否能打开官网和服务状态页
请不要发送完整 API Key。需要排查时,只发送 Key 的前 6 位和后 4 位即可。