VS Code 原生编辑器不提供全局 AI 后端配置项,该功能依赖具体安装的扩展插件实现。通常在插件专属设置面板或项目配置文件填写接口地址和密钥,需注意避免将敏感密钥提交至版本控制系统。
先说结论:配置入口取决于所使用的 AI 扩展插件,而非 VS Code 原生设置。
- 适合:已安装支持自定义模型扩展(如 Continue、Cline 等)的开发人员。
- 先准备:获取有效的 API 接口地址、兼容的模型名称及合法 API Key。
- 验收:在插件聊天窗口发送测试指令,确认返回内容无报错。
命令速用版
大部分配置通过图形界面完成,若需直接编辑配置文件,可使用以下快捷键打开用户设置 JSON:
Ctrl + , 打开设置,点击右上角图标切换到 settings.json。
为什么会这样
VS Code 采用扩展架构,核心编辑器不包含特定 AI 服务逻辑。AI 功能由第三方插件提供,因此配置项存储在插件命名空间下或插件独立配置文件中。
分步处理
1. 确认插件:在扩展视图查看已安装的 AI 辅助插件名称。
2. 查找配置:在设置搜索框输入插件名称,查找 Endpoint 或 API Key 相关选项。
3. 填写信息:填入服务商提供的接口地址,注意末尾是否需要斜杠。
4. 保存密钥:优先使用插件提供的密钥管理功能,避免明文写入共享配置文件。
怎么验证是否生效
打开插件侧边栏聊天窗口,输入简单指令如“hello”,观察是否返回正常响应且无 401 或 404 错误提示。
常见坑
1. 密钥泄露:settings.json 若开启同步可能泄露密钥,建议使用插件内置密钥存储。
2. 地址格式:接口地址多余的空格或缺失协议头会导致连接失败。
3. 模型不匹配:填写的模型名称需与后端实际支持的名称完全一致。
常见问题
配置文件在哪里?
用户级设置在 %APPDATA%/Code/User/settings.json,工作区设置在项目 .vscode 文件夹内。
API Key 安全吗?
明文存储在 settings.json 不安全,建议确认插件是否支持系统密钥环存储。
修改后需要重启吗?
大多数插件支持热加载,若未生效可尝试重新加载窗口。
参考来源
Visual Studio Code Documentation, User and Workspace Settings, https://code.visualstudio.com/docs/getstarted/settings