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配置工具

快速开始

开始前,请先准备好:

常用地址

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

套餐与分组建议

常见问题

API Key 无效

429 Too Many Requests

请求过于频繁,触发了速率限制。建议降低并发,等待几秒后重试。

500 / 502 / 504 错误

通常与上游服务、网络波动或请求超时有关。请先查看服务状态页:

https://status.yuai.space

Claude Code 扣费较快

编程工具会产生较多上下文和输出内容,尤其是长代码文件分析、多轮修改、大量终端输出和高等级模型。建议先描述清楚任务,再让模型执行。

联系售后时请提供

请不要发送完整 API Key。需要排查时,只发送 Key 的前 6 位和后 4 位即可。