在 Cline 和 Roo Code 里接入自己的密钥

第一次打开 Cline 或 Roo Code，通常会先遇到服务商、密钥和模型这些设置。它们决定扩展把请求发给谁、使用哪个模型，以及费用记在哪个账户上。这里的“使用自己的密钥”，就是把你在模型服务平台取得的 API 密钥填进扩展，让它通过这个账户调用模型。

Cline 和 Roo Code 都可以在 VS Code 中协助阅读项目、修改文件和执行命令。扩展负责组织这些操作，模型负责理解请求并生成回应。配置密钥后，你仍然需要检查修改内容，并决定是否允许它执行具体操作。

§ 先把三个设置分清

服务商决定连接方式，接口地址决定请求去哪里，模型名称决定调用哪个模型。API 密钥则用于验证账户。聊天产品的订阅通常不等于 API 额度，能在网页上聊天，也不代表同一个账户已经具备可用的 API 余额。

Vana API 提供统一入口 https://api.vanaapi.com，兼容 OpenAI 接口，也支持 Anthropic Messages 和 Gemini 原生协议。对刚开始配置扩展的人，可以先选择 OpenAI 兼容方式，把连接跑通，再考虑其他协议。

§ 在扩展里填入连接信息

先创建一个 Vana API 账户，在控制台生成密钥，并确认账户有可用余额。随后打开 Cline 或 Roo Code 的设置，找到 API 服务商配置。不同版本的菜单名称可能略有变化，寻找支持自定义地址的 OpenAI 兼容选项即可。

• 接口地址：按 OpenAI 兼容配置填写 https://api.vanaapi.com/v1。这里填写基础地址，不要自行追加具体请求路径。
• API 密钥：填入控制台生成的密钥。不要写进项目源码、提交到 Git，或放进用于求助的截图。
• 模型：从控制台确认可用模型及其准确标识，再填写或选择。可以从 Claude Sonnet 5.5 开始，避免只凭显示名称猜测接口标识。

如果扩展要求手动填写上下文长度、输出上限或价格，应参考平台提供的信息。连接成功只说明请求能够到达服务；工具调用、文件修改等功能，还需要通过实际任务检查。

§ 从一次小修改开始

第一次使用时，打开一个熟悉的小项目，让扩展解释某个函数，或者修改一处提示文字。明确告诉它允许修改哪些文件，并要求在执行命令前说明用途。检查它读了什么、改了什么，再决定是否接受结果。

如果提示身份验证失败，先检查密钥是否复制完整、账户是否可用；如果提示找不到模型，核对模型标识；如果请求地址报错，检查基础地址是否重复包含路径。一次只调整一个设置，比较容易判断问题出在哪里。

§ 留意一次任务里的多次请求

Vana API 按实际 token 用量计费，没有月费。一次编程任务可能包含多轮读取、解释和修改，因此一次点击并不对应一次模型请求。项目内容、对话历史和工具返回结果都可能增加输入用量，生成的回答和代码则产生输出用量。

开始时把任务范围写小，保留必要上下文，并在完成后查看用量记录。这样既能判断模型是否适合当前工作，也能逐渐了解一次解释、一处修改或一轮排错的大致成本。