OpenAI SDK 的 base_url 怎么填？
填写 https://claudeagent.com.cn/v1，末尾不要重复添加 /v1。
OpenAI Python SDK
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://claudeagent.com.cn/v1",
)
models = client.models.list()
model = models.data[0].id
response = client.chat.completions.create(
model=model,
messages=[{"role": "user", "content": "Reply with OK"}],
)
print(response.choices[0].message.content)OpenAI SDK 的 base_url 包含 /v1；这与 Claude Code 使用站点根域名的配置不同。
OpenAI Node.js SDK
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
baseURL: "https://claudeagent.com.cn/v1",
});
const models = await client.models.list();
const response = await client.chat.completions.create({
model: models.data[0].id,
messages: [{ role: "user", content: "Reply with OK" }],
});
console.log(response.choices[0].message.content);服务端程序从环境变量读取 Key，不要把 Key 写入浏览器代码、公开仓库或桌面应用安装包。
从官方地址迁移时要改什么
| 项目 | 迁移设置 | 检查方式 |
|---|---|---|
| API Key | 使用 Claude Agent 控制台创建的 Key | 先请求 /v1/models |
| Base URL | https://claudeagent.com.cn/v1 | 确认只出现一个 /v1 |
| 模型名 | 复制当前模型列表中的 id | 不要硬编码旧别名 |
| Chat Completions | /chat/completions | 先发非流式短请求 |
| Responses API | /responses | 先确认所选分组和 SDK 版本支持 |
OpenAI-compatible 表示常用接口和 SDK 调用方式兼容，不等于所有实验字段在所有模型上完全一致。迁移前应对流式、工具调用、图片和错误处理分别验收。
常见问题
模型名能沿用原值吗？
不一定。应从当前 Key 的 /v1/models 返回中复制。