若Roo Code接入火山方舟平台失败，需依次检查BaseURL与认证令牌：一、从控制台获取带区域的BaseURL（如https://ark.cn-beijing.volces.com/v1）及具备coding-plan权限的API密钥；二、在Roo Code设置中选择Custom OpenAI-compatible provider，准确填写Base URL、API Key（非ID）和模型标识（如ark:/volc-engine/glm-4.7）；三、通过/test-api或Debug Mode验证响应，排查401（密钥错误）或404（URL路径错误）；四、确保BaseURL含正确区域子域和/v1路径，私有部署需网络可达；五、令牌失效时禁用旧密钥、新建并替换为含model-inference权限的新secret。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试将 Roo Code 插件接入火山引擎方舟平台，但配置后模型无法响应或提示认证失败，则可能是由于 BaseURL 填写错误或认证令牌未正确生成。以下是完成该接入任务的具体操作步骤：
一、获取火山方舟平台的 BaseURL 与认证信息
火山方舟平台提供 OpenAI 兼容接口，其服务地址和认证方式需从控制台准确提取。BaseURL 并非通用域名，而是绑定具体项目与区域的唯一端点；认证令牌必须具备 API 调用权限，且未过期。
1、登录火山引擎官网，进入【火山方舟】控制台。
2、在左侧导航栏中点击【API管理】→【API密钥】，确认已创建有效密钥；若无，请点击【创建密钥】并勾选“coding-plan”相关权限。
3、在【模型服务】页面选择已部署的编程模型（如 deepseek-v3.2 或 glm-4.7），点击右侧【服务详情】。
4、在服务详情页中找到【OpenAI 兼容接口】区块，复制其中的 Base URL 字符串（形如 https://ark.cn-beijing.volces.com/v1），注意不含路径尾部斜杠或额外参数。
二、配置 Roo Code 的第三方供应商参数
Roo Code 支持免账号模式接入任意 OpenAI 兼容服务，需手动填写服务地址、密钥及模型标识。参数格式必须严格匹配方舟平台返回的字段，大小写与路径层级均不可更改。
1、在 VS Code 中点击左侧活动栏的 Roo Code 图标，打开插件主界面。
2、点击右上角齿轮图标进入【Settings】设置页。
3、在【Provider】下拉菜单中选择 Use without an account → Custom OpenAI-compatible provider。
4、在 Provider Configuration 表单中依次填写：
- Base URL：粘贴步骤一中复制的完整 URL
- API Key：粘贴步骤一中创建的密钥字符串（非 AccessKey ID）
- Model Name：输入方舟控制台中该服务对应的模型标识（如 ark:/volc-engine/glm-4.7）
5、确认所有字段无空格、无换行、无中文引号，点击【Save】保存配置。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
三、验证 BaseURL 连通性与令牌有效性
仅保存配置不足以确认接入成功，需通过实际请求探测服务端是否可接收并解析请求。此步骤可区分是网络层阻断、路由错误，还是认证密钥被拒绝。
1、在 Roo Code 聊天窗口中输入测试指令：/test-api（部分版本支持该内置命令）。
2、若未响应或报错，手动发起诊断请求：点击设置页底部【Advanced】→【Debug Mode】开启，然后发送任意简短消息（如“hi”）。
3、观察输出日志中是否出现 HTTP 200 OK 及含 "choices" 字段的 JSON 响应体。
4、若返回 401 Unauthorized，请重新核对 API Key 是否为【密钥 Secret】而非【密钥 ID】；若返回 404 Not Found，请检查 Base URL 末尾是否误加了 /chat/completions 等路径。
四、处理常见 BaseURL 格式错误
方舟平台不同区域与实例类型对应不同 BaseURL，直接套用文档示例易导致请求失败。必须使用控制台实时生成的地址，不可自行拼接。
1、识别 Base URL 中的区域标识：如 cn-beijing、ap-southeast-1，须与您创建服务的地域完全一致。
2、排除典型错误写法：https://ark.volces.com/v1（缺少区域子域）、https://ark.cn-beijing.volces.com（缺少 /v1 路径）。
3、若使用私有 VPC 部署，Base URL 将包含内网 IP 或私有域名，此时需确保 VS Code 所在机器可直连该地址，不得使用公网 DNS 解析。
五、重置并轮换认证令牌
当怀疑令牌泄露、权限变更或长期未使用导致失效时，应主动废弃旧密钥并生成新密钥。方舟平台不支持密钥有效期编辑，仅能通过新建实现轮换。
1、返回火山引擎【API密钥】管理页，定位原密钥条目，点击【禁用】按钮。
2、点击【创建密钥】，在弹窗中勾选【coding-plan】与【model-inference】权限组。
3、下载并安全保存新密钥文件（.json），从中提取 secret 字段值。
4、回到 Roo Code 设置页，将旧 API Key 替换为新 secret，重新点击【Save】。
5、执行步骤三中的诊断流程，确认新令牌生效。
