鹿友 AI
首页 模型价格 登录

接入文档

不管用什么工具,都只改两样东西:接口地址 换成我们的,密钥 填你自己的。线路由模型名决定,跟着两步走,一分钟接好。

1
先创建你的密钥

登录控制台,进入「密钥」页点创建,得到一串 sk- 开头的字符。 它就是你的通行证 —— 下面所有配置里写「你的密钥」的地方,都填它。

去控制台创建密钥 →
2先选线路,再找工具
日常使用推荐 SUB。地址和密钥完全相同,只看模型名:末尾加 -sub 走 SUB,标准名称走 API。
SUB
claude-fable-5-sub推荐

订阅容量线路,价格更低,推荐用于日常开发和可接受偶发波动的高用量任务。

API
claude-fable-5

Anthropic 官方 API 专线,适合关键任务和明确要求官方线路、优先看重稳定性的场景。

SUB 使用提醒:该线路可能受官方订阅规则、上游限流、额度和账号状态影响,高峰期可能出现容量不足、请求受限或短时不可用,不承诺与官方 API 相同的稳定性。关键任务建议选择 API。
cc-switch一键导入 · 推荐 Claude Code手动配置 Cursor · LobeChat及其它客户端 直接调 APIcurl · Python SDK

cc-switch 一键导入推荐

鹿友用户几乎都在用 cc-switch 管理 Claude Code 配置:一键导入、随时切换供应商、多套配置互不打架,全程不用手改任何文件。

  • 安装 cc-switch:到 ccswitch.io 下载安装(macOS / Windows / Linux)。
  • 一键导入:在控制台 → 密钥创建密钥,弹窗里点 「一键导入 cc-switch」,接口地址、密钥和三档 SUB 模型映射全部自动填好,确认即可。
  • 检查旧配置:以前导入过「鹿友AI」的用户,请确认主模型、Fable、Opus、Sonnet、Haiku 五处映射都以 -sub 结尾;也可以删除旧供应商后重新一键导入。
  • 开始使用:在 cc-switch 里选中「鹿友AI」,照常运行 claude。

推荐的 SUB 映射为主模型 claude-fable-5-sub、Opus claude-opus-5-sub、Sonnet claude-sonnet-5-sub。 如需官方 API,去掉三个模型名末尾的 -sub 即可。

🖥️ 桌面版 Claude:切到 cc-switch 的「Claude Desktop」面板(顶部的双图标切换),点右上角 + 添加供应商,只需填三样:

  • 供应商名称:鹿友AI
  • API Key:粘贴你的密钥
  • 请求地址:…

如果想在桌面版中显示完整的模型选择,在手动添加页面点击「手动指定 Claude Desktop 模型列表（高级，可选）」,再点击「获取模型列表」,即可自动获取全部 6 个模型(3 个 API + 3 个 SUB)并自由切换。

不想用 cc-switch?手动配置 Claude Code · Cursor / LobeChat · 直接调 API · 可用模型 ▸

Claude Code 手动配置

不想装 cc-switch?手动设置下面这些环境变量,同样使用 Claude 原生协议,无需改动任何配置文件。后三项确保 Claude Code 的模型别名和后台任务也留在 SUB 线路。

# 密钥在 控制台 → 密钥 创建
export ANTHROPIC_BASE_URL=__ORIGIN__
export ANTHROPIC_AUTH_TOKEN=你的密钥
export ANTHROPIC_MODEL=claude-fable-5-sub
export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5-sub
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-sub
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-sub
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-sonnet-5-sub
# SUB 可换:claude-opus-5-sub / claude-sonnet-5-sub
# 去掉 -sub 后缀,就是对应的官方 API 线路

# 然后照常启动
claude

只把 你的密钥 换成第 1 步的 sk- 密钥,整段粘进终端回车即可。 示例使用 claude-fable-5-sub 订阅线路。改成 claude-opus-5-sub 或 claude-sonnet-5-sub 可切换档位;去掉 -sub 即走 API。

Cursor · LobeChat · 其它 OpenAI 兼容客户端

在客户端设置里把「OpenAI Base URL」指向下面地址,填入你的密钥。模型名末尾带 -sub 使用 SUB,不带后缀使用 API。

  • Base URL：…
  • API Key：你在控制台创建的密钥(sk- 开头)
  • SUB Model：claude-fable-5-sub · claude-opus-5-sub · claude-sonnet-5-sub
  • API Model：上面三个名称去掉 -sub 后缀

Cursor:设置 → Models → 打开「Override OpenAI Base URL」,填入上面地址与密钥,再把上面的模型名加进模型列表即可。LobeChat / NextChat 等同理。

直接调用 API

复制后把 你的密钥 换成自己的即可运行。下面示例默认使用 SUB;要走 API,删掉模型名末尾的 -sub。

curl __ORIGIN__/v1/chat/completions \
  -H "Authorization: Bearer 你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5-sub",
    "messages": [{"role": "user", "content": "你好"}]
  }'
curl __ORIGIN__/v1/messages \
  -H "x-api-key: 你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5-sub",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'
from openai import OpenAI

client = OpenAI(
    base_url="__ORIGIN__/v1",
    api_key="你的密钥",
)
resp = client.chat.completions.create(
    model="claude-fable-5-sub",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
from anthropic import Anthropic

client = Anthropic(
    base_url="__ORIGIN__",
    api_key="你的密钥",
)
msg = client.messages.create(
    model="claude-fable-5-sub",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

可用模型

每档模型都有 API 与 SUB 两条线路。计费按实际用量精确到 µ$,详见 模型价格。

模型线路适用
claude-fable-5API最强旗舰 · 官方 API 专线
claude-fable-5-subSUB最强旗舰 · 订阅容量
claude-opus-5API主力之选 · 官方 API 专线
claude-opus-5-subSUB主力之选 · 订阅容量
claude-sonnet-5API高性价比 · 官方 API 专线
claude-sonnet-5-subSUB高性价比 · 订阅容量

遇到问题?

  • 提示余额不足 / 402 —— 去控制台充值,兑换码即时到账。
  • 提示密钥无效 / 401 —— 确认填的是控制台创建的 sk- 密钥,别填成官方或别人的 key。
  • 提示 model not found / 404 —— 先检查基础模型名是否正确;使用订阅线路时,只在完整名称末尾加一次 -sub,例如 claude-sonnet-5-sub。
  • 选了 Opus,日志却出现 Sonnet —— Claude Code 的主会话和子代理可以使用不同模型。先检查 cc-switch 中 Fable、Opus、Sonnet、Haiku 四个角色映射是否都带 -sub。如果确实希望所有子代理也强制使用 Opus,启动前另设 CLAUDE_CODE_SUBAGENT_MODEL=claude-opus-5-sub。
  • 日志显示“已取消(估算)” —— 这表示客户端在收到完整回复前主动断开,不是网关把模型改成了 Sonnet。先关闭旧 Claude Code 会话,修正映射后重新启动再测。
  • 还是不行? —— 加微信 iveyzen(搜索微信号添加)直接问,或把报错截图发到 support@luyouai.com,我们帮你看。