Codebuff 接入核对：平台 Key、SDK 与端点边界
依据 Codebuff 官方文档和 SDK 仓库区分平台认证、自定义 Agent 与通用模型端点；任意 Base URL 尚未核验，提供版本、权限和数据安全核对路径。
内容复核中 部分能力仍待核对，请留意正文中的版本与协议限制。 图解为本站原创示意，不是客户端运行截图。
查看教程占位服务地址
- 控制台
https://80321.cn- 创建 Key
https://80321.cn/keys- 钱包充值
https://80321.cn/wallet- 文档站
https://80321.cn/docs.html
以上服务地址仅为教程占位示例，不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。
本页目录
为什么本篇只确认部分能力
Codebuff 官方快速开始页介绍 CLI 项目入口，SDK 文档则要求创建 Codebuff 账号并取得平台 API Key。 已核验这些资料，但没有在其中确认可直接填入任意 OpenAI 兼容 Base URL 的用户配置，因此状态为部分核验，不能发布“一换地址就能接入”的结论。
另一个版本细节不能忽略：官方组织仓库的根 README 当前使用 Freebuff 名称，并说明其构建于 Codebuff 框架之上。 先核对正在使用的是 Codebuff CLI、框架 SDK，还是相关的新产品，不从旧教程猜安装包或命令。
平台凭证不是外部模型凭证
SDK 的 CodebuffClient 接收平台 apiKey；官方前置条件说明了该 Key 的来源。 其他服务颁发的 Key 即使外观相似，也不能当作 Codebuff 账号授权。模型路由、计费和组织政策需要分别确认，不建议拿订阅会话 Token 代替平台凭证。
下面仅为原创参数辨认示意，不是已测试配置：apiKey: "YOUR_API_KEY"。这里表示 Codebuff 平台凭证的占位，绝无真实 Key。外部候选地址 https://80321.cn/v1 与模型 YOUR_MODEL_ID 也都是占位，并无真实接口；本篇没有证明它们能作为 Codebuff 的模型后端。
自定义 Agent 不等于自定义网关
SDK 文档允许定义 Agent、工具和模型字段，官方模型说明也描述主协调者与不同子任务使用不同模型。 这些能力不能推导出某个 Base URL 设置，更不能推导出所有模型请求都能在本地完成。
如需企业网关，提交明确的核对问题：当前 SDK 是否有公开支持的端点选项，它指向平台服务还是模型服务；主 Agent 与子 Agent 的请求分别发往哪里；模型字段允许哪些标识；鉴权由谁处理。得到对应版本的官方答案后才编写实际配置。
用最小项目排查平台问题
先核对账号、客户端自报版本和文档入口，再在空项目中让 Agent 解释一份普通文件。登录失败、平台权限不足与模型任务失败应分开记录；不要把所有报错都解释成外部网关余额不足。
诊断材料只记录脱敏错误、版本和操作阶段，不公开上传整个会话状态。原仓库根说明与网站快速开始的产品名称并不完全一致，升级或更换入口前先向官方确认，不执行来历不明的修复脚本。
文件过滤不构成完整沙箱
官方 FAQ 介绍 .gitignore 与 .codebuffignore 的文件选择规则。 SDK README 还说明内置环境文件过滤只作用于 SDK 介导的读取，并未增加终端命令或内部编辑限制。 所以，忽略文件不等于把运行环境中的凭证隔离掉。
使用不带生产凭证的仓库副本，限制终端与自定义工具权限，并分别核对客户端、平台和模型服务的数据政策。本文没有登录账号、申请 Key 或执行真实调用。