VS Code 接入 Clawsocket API：Custom Endpoint 配置教程
VS Code 的 Custom Endpoint 可以把兼容 API 接入 Chat 模型选择器。给 VS Code 配置 Clawsocket 时，重点是选对 API 类型、填写完整 endpoint，并使用控制台中的 Model ID。本文说明当前 VS Code 文档所列的自定义端点流程，并补充 BYOK 的功能边界。
VS Code 当前的 Custom Endpoint 支持 Chat Completions、Responses 和 Anthropic Messages 三种 API 类型；应选择 Clawsocket 当前为目标模型提供的协议。下面用 Chat Completions 举例。具体模型列表和 Model ID 请查看 Clawsocket 控制台。
添加 Custom Endpoint
- 在 VS Code 打开 Chat 的模型选择器，选择齿轮菜单中的“Manage Language Models”；也可以从命令面板运行
Chat: Manage Language Models。 - 选择“Add Models”，再选择“Custom Endpoint”。
- 将 Provider 名称设为
Clawsocket，输入 API Key，并把 API 类型选为Chat Completions。 - VS Code 打开
chatLanguageModels.json后，按控制台实际信息填写模型配置。示例中的your-model-id需要替换成你的 API Model ID：
json
[
{
"name": "Clawsocket",
"vendor": "customendpoint",
"apiKey": "${input:clawsocketApiKey}",
"apiType": "chat-completions",
"models": [
{
"id": "your-model-id",
"name": "Clawsocket model",
"url": "https://api.clawsocket.com/v1/chat/completions"
}
]
}
]${input:clawsocketApiKey} 用于让 VS Code 在运行时安全输入密钥，不要把实际 Key 写进并提交到 Git 的 JSON 文件。Custom Endpoint 的认证默认使用 Bearer Token。
如果 Clawsocket 控制台对你使用的模型提供 Responses API，可以将 apiType 改为 responses，并将 URL 改为 https://api.clawsocket.com/v1/responses。Responses endpoint 是否保留会话状态，需要和服务端行为相符；无状态服务可能需要设置模型项 "statefulResponses": false，以让 VS Code 每次请求发送完整对话历史。
- 保存 JSON，回到 Chat 模型选择器，选择 Clawsocket 下配置的模型。模型没有立即出现时，重启 VS Code 再检查。
toolCalling、vision、上下文长度等能力字段应按该模型和 API 的实际支持情况设置。只有模型支持工具调用时，才将 toolCalling 设为 true；不要用虚构的上下文长度填充设置。
BYOK 能做什么
BYOK 模型可以用于 VS Code Chat；模型支持工具调用时，也可以用于对应 Agent 工作流。VS Code 官方文档注明，内联代码补全、语义搜索和依赖 Embedding 的功能仍可能需要 GitHub Copilot 服务，不能假定接入 Clawsocket 后所有 Copilot 功能都会改用该 API。
对于 Copilot Business 或 Enterprise 账户，组织管理员可能需要允许 BYOK。模型调用和费用由 API 服务提供方按其账户规则处理，和 Copilot 订阅的内置模型额度分开。
常见问题
API Key 应该放在哪里？
使用 VS Code 提供的 ${input:...} 输入变量，避免将真实 Key 写入共享配置、项目仓库或公开日志。
模型添加成功，但 Agent 里无法选择
确认 apiType 和 endpoint 匹配，目标模型支持工具调用，并按模型能力设置 toolCalling。Agent 场景需要模型和服务接口支持工具调用。
对话中断或提示缺少工具结果
确认当前选择的协议及服务端状态管理方式。如果 Responses API 服务端不保存 previous_response_id，根据 VS Code 文档对该模型设置 statefulResponses: false。
代码补全仍然使用其他模型
BYOK 首先配置的是 Chat 模型。行内补全、语义搜索等功能有自己的模型选择和服务要求，查看 VS Code 的功能设置及组织策略。
先确认你配置的是哪条调用链
VS Code 可以安装多种 AI 扩展，也可以使用内置 Chat 的模型管理功能。本文的 Custom Endpoint 配置针对 VS Code Chat；如果你使用的是其他扩展，该扩展可能有自己的服务地址、密钥存储和模型设置。把一个扩展的配置填进另一个入口，常见结果就是设置看似正确，但请求仍然发往原来的服务。
排查之前，先记录正在使用的 Chat 入口、模型选择器和配置文件。不要看到编辑器里出现 AI 按钮，就认为所有功能共享同一个 API Key。尤其是代码补全、对话、Agent 和外部扩展，可以分别拥有不同调用链。
| 使用入口 | 应检查的配置 | 本文是否覆盖 |
|---|---|---|
| VS Code Chat 自定义端点 | 模型管理与 endpoint 配置 | 覆盖 |
| Chat 中的 Agent | 模型工具调用与权限 | 说明验证方法 |
| 独立安装的 AI 扩展 | 扩展自己的 Provider 设置 | 需查看对应文档 |
| 行内代码补全 | 补全服务及账户策略 | 不由这份配置统一控制 |
理解 API 类型与地址的关系
模型 API 的协议决定了请求体和返回结构。Chat Completions 通常以消息列表组织对话，Responses 则有自己的输入、输出和工具事件结构。设置中选择哪种协议，URL 就需要指向服务端对应的 endpoint；只替换地址而保留错误协议，可能得到参数错误，也可能在进入工具任务后才失败。
| API 类型 | 示例路径 | 配置时的重点 |
|---|---|---|
| Chat Completions | /v1/chat/completions | 与消息格式对应 |
| Responses | /v1/responses | 核对工具事件与状态管理 |
| 其他协议 | 以平台说明为准 | 不通过改路径假定兼容 |
Clawsocket 中同一模型展示名称与可用协议也应分别确认。服务商提供某个模型，不代表每一种接口都开放了同样的能力。准备做 Agent 开发时，最好直接验证工具调用流程，而不是只依赖模型名称或一条纯文本回复。
密钥与配置文件如何分开管理
示例中的输入变量用于避免把真实密钥直接写入配置。保存配置前，检查文件里是否还有从教程复制的占位模型名，以及旧 endpoint。多人协作时可以分享字段说明和不含凭据的样例，但每位成员应使用自己的授权凭据或团队规定的密钥管理方式。
如果曾把密钥写入项目文件，不要只删除当前内容就继续使用。应撤销已暴露的 Key，再创建新的凭据，并检查提交历史、日志和截图中是否残留。密钥泄漏属于凭据管理问题，切换模型或更改展示名称不能解决。
用四个开发任务检查兼容性
第一步是解释一小段已知代码。选中一个函数，让模型说明输入、输出和异常路径，查看它是否依据代码回答。这一步主要验证文本与上下文传入，不必给它整个工作区。
第二步是读取项目约定。让它从说明文件中找出格式化和测试命令，并列出引用来源。模型猜对一个常见命令和真正读取项目约定是两回事，检查时应该看文件路径与内容是否一致。
第三步是提出修改但暂不执行。给出一个复现明确的问题，让它列出准备改动的文件和原因。如果建议范围超出问题本身，先缩小任务。这样可以检验模型是否理解约束，也方便在工具操作前审查方案。
第四步才运行一个小型 Agent 任务：执行修改、查看差异、运行已有检查并解释结果。若只能完成前两步，重点调查工具调用兼容和权限；若工具已经运行但结果没有被理解，再检查多轮消息和响应状态处理。
长对话、工具输出与上下文管理
大型错误日志不必整段反复粘贴。先提供报错栈、相关函数和复现步骤，必要时再补充完整日志。工具输出过长时，可要求模型定位失败片段和文件位置，避免下一轮把无关内容当成主要上下文。
切换模型之后，建议新建对话测试同一个最小任务。旧会话可能已经包含不同模型产生的推理、工具消息和错误恢复内容，新对话更容易判断新配置本身是否有效。只有最小任务稳定后，再恢复日常的复杂工作流。
在 Responses 模式下，如果会话续接出现错误，先核对服务端是否维护响应状态，以及客户端的相关设置。不要通过反复开启、关闭能力字段碰运气；记录失败发生在首次请求还是工具回传后，对定位问题更有效。
团队使用前的验收清单
为团队推广配置时，准备一组固定仓库样例，包括代码解释、范围受限的修改和测试失败后的处理。记录模型 ID、API 类型、客户端版本以及实际结果，后续升级时再运行同一组任务。这样能比较实际工作表现，而不是仅凭回答长度判断效果。
费用统计也应该覆盖完整任务。一次简短提问与一个持续读取文件、重试工具的大任务，输入输出量并不相同。按 Clawsocket 的实际用量记录核算，结合团队任务类型决定模型选择；不要把上游标价或演示中的单次调用费用当成固定工作成本。