接入文档
AGI Dawn 兼容 Anthropic 官方 API。任何支持 Anthropic 的工具和 SDK,只需替换接口地址和 API Key。
本页
接口地址
https://agidawn.ccKey 在控制台「API 密钥」创建,以 sk- 开头快速开始
- 注册账号,在控制台「钱包」领取兑换码额度,或联系专属商务充值。
- 在「API 密钥」创建一个 Key。建议每台设备或每个项目一个 Key,便于单独停用。
- 按下面任意一种方式接入。
Claude Code
需要 Node.js 22 或更高版本(低版本会出现 EBADENGINE 警告,通常仍能运行)。
bash
npm install -g @anthropic-ai/claude-code
方式一:环境变量(推荐)
# 写入 ~/.zshrc 或 ~/.bashrc 后重开终端 export ANTHROPIC_BASE_URL=https://agidawn.cc export ANTHROPIC_AUTH_TOKEN=sk-你的Key
# PowerShell,写入用户环境变量 [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://agidawn.cc", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")
方式二:settings.json
不想修改全局环境变量时使用。
~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://agidawn.cc",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}不必先退出官方账号:
ANTHROPIC_AUTH_TOKEN 的优先级高于订阅登录;想退出就在会话里输入 /logout,用 claude auth status 确认当前凭据。不要同时设置 ANTHROPIC_API_KEY:两个都设置时本站以它为准(经本站接入时 x-api-key 请求头优先),残留的旧 Key 会导致 401。验证
bash
claude -p "你是哪个模型?"
想系统地用好 Claude Code(权限模式、工作流、Hooks、MCP、团队用法),见 Claude Code 指南。
其他工具
- Cursor:Settings → Models → Anthropic API Key 填 Key,开启「Override Base URL」填接口地址。
- Cline / Roo Code:Provider 选 Anthropic,填接口地址与 Key,模型 ID 见下方表格。
- Continue:
provider: anthropic,apiBase填接口地址。
Messages API
与 Anthropic 官方 POST /v1/messages 完全一致。认证使用 x-api-key 请求头,并带上 anthropic-version。
curl https://agidawn.cc/v1/messages \ -H "x-api-key: sk-你的Key" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello, Claude"}] }'
# pip install anthropic import anthropic client = anthropic.Anthropic( base_url="https://agidawn.cc", api_key="sk-你的Key", ) message = client.messages.create( model="claude-opus-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Hello, Claude"}], ) print(message.content[0].text)
// npm install @anthropic-ai/sdk import Anthropic from '@anthropic-ai/sdk' const client = new Anthropic({ baseURL: 'https://agidawn.cc', apiKey: 'sk-你的Key', }) const message = await client.messages.create({ model: 'claude-opus-5-5', max_tokens: 1024, messages: [{ role: 'user', content: 'Hello, Claude' }], }) console.log(message.content[0].text)
流式输出
请求体加 "stream": true,响应为 SSE 事件流,事件类型与官方一致(message_start、content_block_delta、message_stop 等)。SDK 中使用 client.messages.stream(...)。
python
with client.messages.stream(model="claude-opus-5-5", max_tokens=1024,
messages=[{"role": "user", "content": "写一首关于黎明的短诗"}]) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)Prompt Caching
在需要缓存的内容块上加 cache_control,重复请求时命中缓存,读取按缓存价计费,同样享本站折扣。Claude Code 会自动使用缓存,无需配置。
json
"system": [{
"type": "text",
"text": "很长的系统提示……",
"cache_control": {"type": "ephemeral"}
}]模型与价格
价格以每百万 tokens 计,与后台计费实时同步,统一享官方价 5 折起。
| 模型 | 本站 输入 / 输出 | 本站缓存读 | 官方 输入 / 输出 |
|---|---|---|---|
claude-fable-5-1 | $5.00 / $25.00 | $0.125 | $10.00 / $50.00 |
claude-fable-5 | $5.00 / $25.00 | $0.50 | $10.00 / $50.00 |
claude-opus-5-5 | $2.00 / $10.00 | $0.10 | $4.00 / $20.00 |
claude-opus-5 | $2.50 / $12.50 | $0.25 | $5.00 / $25.00 |
claude-opus-4-8 | $2.50 / $12.50 | $0.25 | $5.00 / $25.00 |
claude-opus-4-7 | $2.50 / $12.50 | $0.25 | $5.00 / $25.00 |
claude-opus-4-6 | $2.50 / $12.50 | $0.25 | $5.00 / $25.00 |
claude-opus-4-5-20251101 | $2.50 / $12.50 | $0.25 | $5.00 / $25.00 |
claude-sonnet-5-5 | $1.00 / $5.00 | $0.05 | $2.00 / $10.00 |
claude-sonnet-5 | $1.00 / $5.00 | $0.10 | $2.00 / $10.00 |
claude-sonnet-4-6 | $1.50 / $7.50 | $0.15 | $3.00 / $15.00 |
claude-sonnet-4-5-20250929 | $1.50 / $7.50 | $0.15 | $3.00 / $15.00 |
claude-haiku-5-5提示超过 100K tokens 时,整次请求按长上下文价:$0.25 / $1.25 | $0.05 / $0.25 | $0.005 | $0.10 / $0.50 |
claude-haiku-4-5 | $0.50 / $2.50 | $0.05 | $1.00 / $5.00 |
claude-haiku-4-5-20251001 | $0.50 / $2.50 | $0.05 | $1.00 / $5.00 |
缓存写入:5 分钟缓存为输入价 1.25 倍,1 小时缓存为 2 倍,与官方一致。
计费说明
- 充多少美元到账多少美元;每次调用按上表的本站价扣费,使用日志里每条都标出官方价与折扣。
- 输入、输出、缓存读取、缓存写入分别计价,控制台「使用日志」可查每条请求的 tokens 与费用。
- 额度永久有效。token 即时消耗,已用部分不支持退款,建议先小额试用。
错误码
| 状态码 | 原因 | 怎么办 |
|---|---|---|
401 | Key 无效或已停用、这把 Key 的额度用完或已过期,或同时设置了 ANTHROPIC_API_KEY | 到控制台检查 Key 状态与额度;确认变量已生效(Claude Code 读 ANTHROPIC_AUTH_TOKEN);unset ANTHROPIC_API_KEY;用 claude auth status 看当前凭据 |
403 | 账户余额不足、这把 Key 剩余额度不够本次请求;或请求的模型不在这把 Key 允许的范围、IP 不在白名单,或账户被停用 | 先看返回的 message:额度问题就充值、使用兑换码或调高这把 Key 的额度;模型或 IP 不在允许范围就到控制台调整这把 Key 的设置;账户被停用请联系商务 |
404 | 模型不存在 | 使用上方表格中的模型 ID |
429 | 请求过于频繁,或上游繁忙 | 稍后重试;持续出现请联系商务 |
5xx | 上游临时异常 | 重试;SDK 与 Claude Code 默认会自动重试几次 |
常见问题
是官方 Claude 吗?
是。请求通过 Anthropic 原生 Messages 协议转发,不做协议转换,不注入系统提示词,不替换模型。
如何充值和开票?
登录控制台,在概览页「商务支持」联系你的专属商务充值;企业开票同样由商务办理。详见如何充值。
控制台会记录什么?
每次请求的模型、tokens 用量与费用,用于计费和对账,可在「使用日志」里逐条查看。