AI 工具
云开发 AI 同时兼容 OpenAI Chat Completions 和 Anthropic Messages API 协议，凡是支持自定义接口的 AI 工具（如 CodeBuddy、Cursor、Cline、Claude Code 等），都可以直接接入云开发的大模型。
准备工作
- 已创建云开发环境（旧套餐可升级），获取环境 ID（
ENV_ID） - 在控制台 → AI → 生文模型中开启所需模型
- 已创建 API Key（控制台 → 环境配置 → API Key）
接口配置
在 AI 工具中填写以下配置：
| 配置项 | 值 |
|---|---|
| Base URL | https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/cloudbase |
| API Key | 云开发环境的 API Key |
| 模型 | hy3-preview（需在控制台开启，支持其他已开启的模型） |
将 <ENV_ID> 替换为实际的云开发环境 ID。
关于 Provider
上方 Base URL 中的 cloudbase 是云开发统一的 provider，适用于通过资源点套餐支持的所有模型（DeepSeek、混元、Kimi、GLM 等）。完整的模型列表见支持的模型列表。
在各工具中配置
CodeBuddy
- 打开 CodeBuddy 设置 → 模型配置
- 选择「添加自定义模型」，Provider 选择
OpenAI Compatible - 填写 Base URL 和 API Key
- 模型名称填写
hy3-preview
Cursor
- 打开 Cursor 设置 → Models
- 在 OpenAI API Key 处填写 CloudBase API Key
- 在 Override OpenAI Base URL 处填写 Base URL
- 在模型列表中输入
hy3-preview并启用
Cline / Roo Code
- 打开插件设置 → API Provider，选择
OpenAI Compatible - 填写 Base URL 和 API Key
- 填写 Model ID：
hy3-preview
Claude Code
Claude Code 支持通过环境变量配置自定义 API 地址，接入云开发后消耗的是云开发资源点套餐内的 Token。
设置以下环境变量后启动 Claude Code：
export ANTHROPIC_BASE_URL="https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/cloudbase"
export ANTHROPIC_AUTH_TOKEN="<YOUR_CLOUDBASE_API_KEY>"
claude
也可以将环境变量写入 shell 配置文件（如 ~/.zshrc 或 ~/.bashrc）以永久生效：
echo 'export ANTHROPIC_BASE_URL="https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/cloudbase"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<YOUR_CLOUDBASE_API_KEY>"' >> ~/.zshrc
source ~/.zshrc
其他支持 OpenAI 协议的工具
在工具的模型设置中，将 OpenAI 的接口地址替换为上方的 Base URL，并填写 CloudBase API Key 即可。