在 CNB 里使用珂艾网关

能用。 CNB 的云原生开发环境里，CodeBuddy Agent 支持切换到任意 OpenAI 兼容模型，改三个环境变量即可。
整理日期：2026-10-18 ｜相关：按任务选模型 · 配置三要素

一、配置三要素

要素	填什么	对应环境变量
Base URL	`https://turbo.apimax.host/v1`	`CODEBUDDY_BASE_URL`
API Key	珂艾控制台生成的 `sk-` 密钥	`CODEBUDDY_API_KEY`
Model	网关模型 ID，如 `claude-sonnet-5-5`	`CODEBUDDY_MODEL`

🔴 三个变量必须同时配齐。任一缺失，CodeBuddy 会静默回退到默认模型——不报错，但你以为配上了其实没生效。

二、配置步骤

1. 把密钥放进 CNB 密钥仓库

不要把 sk- 明文写进 .cnb.yml——那个文件是提交到仓库的，会泄露。

正确做法：在 CNB 项目的密钥仓库 / 环境变量里新建一条，例如名为 KEAI_API_KEY，值填你的 sk- 密钥。

2. 在 `.cnb.yml` 里引用

三个要点：

项	说明
`\${KEAI_API_KEY}`	引用密钥仓库的变量，不要写死明文
`CODEBUDDY_BASE_URL`	必须是 OpenAI 兼容端点，带 `/v1`
`CODEBUDDY_MODEL`	填网关 ID，不是官网营销名

3. 重启开发环境

改完 .cnb.yml 后重新打开云原生开发工作区，环境变量才会生效。

三、验证是否真的通了

在云原生开发环境里打开 CodeBuddy，问它一句：

你现在用的是哪个模型？

判定标准：

✅ 答出的模型名与你配的 CODEBUDDY_MODEL 一致

❌ 答的是默认模型 → 三个变量没配齐，或环境没重启

❌ 报模型不存在 → CODEBUDDY_MODEL 填了官网名而非网关 ID

更硬的验证：让它执行一次工具调用（读文件、跑命令）。能执行才算真通，只看回答不算。

四、推荐模型搭配

使用场景	模型 ID	为什么
日常编码、改 bug	`claude-sonnet-5-5`	代码理解稳，工具调用成熟
复杂重构、跨文件改造	`claude-opus-5-5`	长链路推理不吃亏
便宜大批量	`deepseek-v4-pro`	推理强且单价低
极省、简单补全	`claude-haiku-5-5`	快，适合高频小任务

五、常见报错

现象	原因	解决
配了但还是默认模型	三个变量少配了一个	逐个核对，尤其别漏 `CODEBUDDY_MODEL`
改了 `.cnb.yml` 没生效	开发环境没重启	重开工作区
`401`	密钥错 / 带空格 / 密钥仓库变量名不匹配	核对 `\${VAR}` 名字与仓库条目
`404`	Base URL 漏 `/v1`	改成 `https://turbo.apimax.host/v1`
模型不存在	填了官网名	换网关 ID
能对话但不能读文件	模型不支持工具调用	换 `claude-sonnet-5-5` 等支持 tool calling 的
密钥出现在 git 历史里	明文写进了 `.cnb.yml`	立刻在控制台吊销该令牌，重新生成

六、计费与分组

项目	信息
计费方式	按量计费（按输入 / 输出 token 结算）
建议	给 CI / Agent 场景单独建一个令牌，设额度上限——流水线跑起来循环调用很快

实际单价以价格页为准。

七、进阶：Pipeline 里也能用

除了云原生开发环境，CNB 的流水线阶段同样能调模型。适合做「提交时自动生成变更摘要」「自动审代码」这类任务：

注意：密钥仓库变量在流水线里默认可用；如果读不到，检查该阶段是否声明了 imports。

八、相关阅读

不确定选哪个模型：按任务选模型

搞不清填什么：配置三要素

同类编程工具：Claude Code · ZCode

报错排查：配置报错对照表

九、更新记录

日期	改了什么
2026-10-18	首次发布。基于 CNB 云原生开发环境 2026-10 版本；强调三变量缺一回退与密钥仓库注入

在 CNB 里使用珂艾网关

一、配置三要素#

二、配置步骤#

1. 把密钥放进 CNB 密钥仓库#

2. 在 .cnb.yml 里引用#

3. 重启开发环境#

三、验证是否真的通了#

四、推荐模型搭配#

五、常见报错#

六、计费与分组#

七、进阶：Pipeline 里也能用#

八、相关阅读#

九、更新记录#