客户端配置
常见客户端的接入方式只有两类：Anthropic 协议客户端（改 base_url + 密钥）与 OpenAI 兼容客户端（改 base_url + 密钥 + 模型名）。下面给出可直接套用的配置。
Claude Code
方式一：环境变量（推荐）。写入 shell 配置文件后，所有终端会话都生效。
# 追加到 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_BASE_URL="https://zhinao.75zs.com"
export ANTHROPIC_AUTH_TOKEN="sk-zn-xxxx"
export ANTHROPIC_MODEL="claude-sonnet-4-5"
# 生效并验证
source ~/.zshrc
claude "用一句话说明这个仓库的用途"方式二：写入 Claude Code 配置文件 ~/.claude/settings.json 的 env 段，适合不想改 shell 环境的场景。
{
"env": {
"ANTHROPIC_BASE_URL": "https://zhinao.75zs.com",
"ANTHROPIC_AUTH_TOKEN": "sk-zn-xxxx",
"ANTHROPIC_MODEL": "claude-sonnet-4-5"
}
}- ANTHROPIC_BASE_URL 填站点根地址，不要带 /v1，Claude Code 会自动请求 /v1/messages。
- 用 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY，前者会被作为 x-api-key 发送。
- ANTHROPIC_MODEL 建议选上下文较大的模型（如 200K 上下文档位），避免长会话被截断。
Cursor
Cursor 使用 OpenAI 兼容协议，需要覆盖 Base URL 并自定义模型名：
1. 打开 Cursor → Settings → Models
2. 关闭不需要的官方模型，点击 "Add model" 添加：deepseek-chat
3. 在 "OpenAI API Key" 填入：sk-zn-xxxx
4. 展开 "Override OpenAI Base URL"，填入：https://zhinao.75zs.com/v1
5. 点击 Verify，看到模型可用后即可在 Chat / Composer 中选用- Base URL 必须是 https://zhinao.75zs.com/v1，结尾不要多写 /。
- 自定义模型名需与智脑在售模型 slug 完全一致，否则会返回 404 model_not_found。
- 若 Cursor 提示密钥无效，先确认是否误填到 Anthropic 密钥栏位。
cc-switch 式多供应商切换
如果你使用 cc-switch 这类「多供应商配置切换」工具，可以把智脑配置成多个条目：同一把 Key、不同默认模型， 在工具里一键切换。下面是等价的配置结构示例（字段名以你所装版本为准）：
{
"providers": {
"zhinao": {
"id": "zhinao",
"name": "智脑 API",
"category": "custom",
"websiteUrl": "https://zhinao.75zs.com",
"settingsConfig": {
"env": {
"ANTHROPIC_BASE_URL": "https://zhinao.75zs.com",
"ANTHROPIC_AUTH_TOKEN": "sk-zn-xxxx",
"ANTHROPIC_MODEL": "claude-sonnet-4-5"
}
}
},
"zhinao-deepseek": {
"id": "zhinao-deepseek",
"name": "智脑 · DeepSeek",
"category": "custom",
"websiteUrl": "https://zhinao.75zs.com",
"settingsConfig": {
"env": {
"ANTHROPIC_BASE_URL": "https://zhinao.75zs.com",
"ANTHROPIC_AUTH_TOKEN": "sk-zn-xxxx",
"ANTHROPIC_MODEL": "deepseek-chat"
}
}
}
},
"current": "zhinao"
}- 每个条目的 ANTHROPIC_BASE_URL 都指向同一站点根地址，仅 ANTHROPIC_MODEL 不同。
- 切换后请重开终端或重启客户端，确保新的环境变量被读取；current 字段表示当前生效条目。
- 团队协作时建议每人使用自己的 Key，便于在控制台按 Key 统计用量。
其他 OpenAI 兼容客户端
Cherry Studio、Chatbox、LobeChat、Dify、LangChain 等只要支持「自定义 OpenAI 兼容服务商」，按以下四项填写即可：
Provider 类型：OpenAI 兼容 / 自定义
Base URL：https://zhinao.75zs.com/v1
API Key：sk-zn-xxxx
模型名称：deepseek-chat（或其它在售模型 slug）
流式输出：开启客户端登录（免填 Key）
桌面客户端支持用账号密码直接登录：向 /api/client/auth/login 提交邮箱与密码， 接口会返回可直接使用的 API Key、可用模型列表与 baseUrl，用户无需手工创建或粘贴密钥。
首次登录后客户端会保存凭据，之后打开即可直接对话；该 Key 与你在控制台看到的属于同一账号，用量与扣费同样计入该账号。
curl -X POST https://zhinao.75zs.com/api/client/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"你的登录密码"}'该接口仅供你信任的官方客户端使用。任何第三方网页、脚本或插件向你索取账号密码时，都不要提供。
插件市场、技能与专家团
客户端登录后可在「插件市场」一键安装插件、技能与专家团，安装完成即可在会话中直接调用，无需自行配置参数。
客户端可通过 GET /api/client/bootstrap 拉取当前账号可用的模型、客户端配置与已安装内容清单 （使用 API Key 鉴权），具体字段以接口实际返回为准。插件市场的公开介绍见插件市场页面，登录后的安装与管理在客户端内完成。
curl https://zhinao.75zs.com/api/client/bootstrap \
-H "Authorization: Bearer sk-zn-xxxx"