使用指引
选你正在用的工具,照着抄就能用。所有配置只需要两样东西: 接口地址 和 你的 API Key。
开始前:拿到你的 API Key
- 注册账号(免费,送 ¥10 体验额度)
- 登录控制台 → 左侧「令牌」→「添加令牌」→ 随便起个名字 → 保存
- 点击复制,得到一个
sk-开头的 Key。下面所有sk-你的Key都换成它
OpenAI 兼容地址(多数工具用这个)
http://localhost:3001/v1 Anthropic 原生地址(Claude Code 用这个)
http://localhost:3001 一、Claude Code
Anthropic 官方的命令行 AI 编程工具。两步接入:
第 1 步:设置环境变量
macOS / Linux 打开终端,执行(把 Key 换成你的):
export ANTHROPIC_BASE_URL="http://localhost:3001"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
想永久生效,把这两行追加到 ~/.zshrc(macOS)或 ~/.bashrc(Linux)末尾,
然后重开终端。Windows 用户在「系统属性 → 环境变量」里添加同名变量。
第 2 步:启动
claude
正常进入对话界面即成功。想指定模型,在 Claude Code 里输入
/model claude-sonnet-4-6(均衡)或 /model claude-opus-4-7(最强)。
二、OpenClaw
开源的个人 AI 助手框架。三步接入:
第 1 步:打开配置文件
配置文件在用户主目录下:
~/.openclaw/openclaw.json 第 2 步:添加模型服务商
在 models.providers 里加一段(没有这个文件/字段就照抄整段):
{
"models": {
"providers": {
"duai": {
"baseUrl": "http://localhost:3001",
"api": "anthropic-messages",
"apiKey": "sk-你的Key",
"models": [
{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
{ "id": "claude-opus-4-7", "name": "Claude Opus 4.7" }
]
}
}
},
"agents": {
"defaults": {
"model": { "primary": "duai/claude-sonnet-4-6" }
}
}
} | 字段 | 说明 |
|---|---|
baseUrl | 我们的 Anthropic 原生地址 |
api | 固定填 anthropic-messages |
apiKey | 你在控制台创建的 Key |
primary | 默认模型,格式是 服务商名/模型名 |
第 3 步:重启网关生效
openclaw gateway restart 三、Cherry Studio(图形界面,最适合小白)
免费的桌面 AI 聊天客户端,全程点鼠标:
- 去 cherry-ai.com 下载安装
- 打开 设置(左下角齿轮)→「模型服务」→「添加」→ 选 OpenAI 类型
- API 地址填:
http://localhost:3001/v1 - API 密钥填:
sk-你的Key - 点「添加模型」,模型 ID 填
claude-sonnet-4-6(或列表里任意一个),保存 - 回到聊天界面,右上角切到刚加的模型,开聊
四、自己写代码(任意 OpenAI SDK)
所有支持 OpenAI 协议的库都通用,只改两个参数:
from openai import OpenAI
client = OpenAI(
api_key="sk-你的Key",
base_url="http://localhost:3001/v1",
)
resp = client.chat.completions.create(
model="claude-sonnet-4-6", # Claude 和 GPT 模型随便换
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content) 常见问题
- 报 401:Key 复制不完整或已删除,去控制台重新复制。
- 报 402 / 额度不足:体验额度用完了,去控制台「充值」。
- 模型名报错:必须用 模型与定价 页列出的准确名字,如
claude-sonnet-4-6,不要自己缩写。 - 其他问题:邮件 support@tathr.com,1 个工作日内回复。