# CodeBuddy如何配置Claude Opus 5.5？模型ID与协议转换说明

更新于2026年10月19日：已核对当前模型、计费和接入说明；实际权限、价格与服务流程以下单或调用时页面为准。

先确认你使用的是CodeBuddy IDE、CLI还是WorkBuddy。它们的设置入口和地址字段语义不能混为一谈。 本文按产品设置说明区分地址字段与协议限制。

若界面有“配置自定义模型”，可在模型菜单中添加提供商、Key、模型和地址；字段是Base URL还是完整Endpoint，需要看当前产品说明。

# CodeBuddy IDE的地址规则

CodeBuddy IDE官方models.json说明 (opens new window)要求url使用完整OpenAI兼容接口路径，一般以/chat/completions结尾。这不是“OpenAI填/v1、Claude填/chat/completions”的区别。

该文档的IDE配置仅支持OpenAI接口格式。如果上游是Anthropic原生Messages API，就需要网关提供协议转换，不能直接把/v1/messages塞进去。

如果图形界面与旧截图不同，按当前设置页操作；IDE也有用户级~/.codebuddy/models.json和项目级配置，参考官方说明，不需要为了旧教程强行寻找相同按钮。

若选择的服务明确提供OpenAI兼容Chat Completions端点，可使用其文档给出的完整地址，例如https://apidock.ai/v1/chat/completions；这是条件示例，不保证该端点支持每个模型和每种工具。

Base URL可能需要SDK自动拼路径，url/Endpoint可能要求完整路径。先判断字段，再填地址，避免重复出现/v1/v1或少拼接口。

当前官方ID包括claude-opus-5-5、claude-sonnet-5-5、claude-fable-5-1和claude-haiku-5-5，见Anthropic模型入口 (opens new window)。网关是否开放这些ID，以后台为准。

原生Claude使用Messages API；IDE的OpenAI兼容端点需要网关转换请求、响应、工具与思考内容。不能因为模型名以claude-开头，就默认直接支持。

Opus 5.5与Fable 5.1采用始终开启的自适应思考。不要把客户端“推理模式”复选框等同于官方所有thinking配置；应检查网关透传能力。参数报400时先用最小文本请求定位。

先选中模型测试短问答，再测试读取一个非敏感文件和一次可撤销的小修改。核对工具调用结构、错误提示、用量与最终扣费，成功后再处理长任务。

官方Key调用受官方组织计费；第三方Token受第三方规则约束，均不等于使用Claude Pro/Max订阅内额度。

验证登录状态...