外观
客户端通用配置
接入客户端时，先确认它使用哪一种 API 协议，再填写服务地址。相同模型名称不代表不同协议之间可以直接互换。
配置对照
| 工具 | 接入协议 | 地址配置 | 教程 |
|---|---|---|---|
| Cherry Studio 文本聊天 | OpenAI Chat Completions | https://api.beanc.cn，客户端追加路径 | 查看 |
| OpenAI SDK / 通用聊天应用 | OpenAI 兼容 | 通常为 https://api.beanc.cn/v1 | 地址说明 |
| Claude Code CLI | Anthropic Messages | https://api.beanc.cn | 查看 |
| Codex CLI | Responses | https://api.beanc.cn/v1 | 查看 |
Claude Code 和 Codex 需要所选模型与渠道支持对应协议、流式及工具调用，配置地址本身不会增加这些能力。
通常需要填的项目
- 服务商 / Provider：按客户端选择自定义或对应兼容协议。
- API 地址 / Base URL：按上表和客户端页面说明填写。
- API Key：填写豆子 API 密钥本身，不额外添加
Bearer。 - 模型 / Model ID：填写控制台提供的完整标识。
第一次验证
先新建一个普通文本对话，发送一句简短问候。暂时关闭客户端额外的搜索、MCP、自动标题和复杂参数，成功后逐项启用自己需要的功能。
连接测试通过，只能说明该测试请求成功；真实对话仍需要选中已添加的模型。
配置失败
对照错误排查检查最终请求路径、HTTP 状态码和具体错误信息。客户端更新后字段名称可能改变，以其官方说明为准。