#VS Code 接入 THQ API

VS Code 是扩展平台，不是统一的模型客户端。不同 AI 扩展可能使用 OpenAI Chat Completions、 OpenAI Responses、Anthropic Messages 或其他协议，也可能完全不允许修改服务地址。开始配置前， 必须先确认具体扩展公开支持的协议和自定义端点能力。

模型 ID 和可用能力会动态调整，请从 THQ API 控制台复制当前可用的完整模型 ID。

#先确认扩展协议

在扩展的官方文档和设置中确认以下项目：

不要把“支持 OpenAI 模型”理解成“支持任意 OpenAI 兼容地址”。如果扩展没有公开的 Base URL 或自定义 provider 设置，就不要通过不受支持的字段强行接入。

#官方 Codex 扩展

官方 Codex IDE 扩展与 Codex CLI 共享用户级 ~/.codex/config.toml。当前自定义 provider 使用 OpenAI Responses API，因此 THQ Base URL 应为 https://api.thqllm.com/v1，并且所选 模型和服务端必须支持最终的 /v1/responses 请求。

这不等同于任意 VS Code 扩展都能使用 Responses。完整配置见 Codex 接入指南，扩展行为见 OpenAI Codex IDE 官方文档和 Codex 配置官方文档。

#OpenAI 兼容扩展

仅当扩展明确允许添加 OpenAI 兼容 provider，并能配置 Base URL、API Key 和模型时，使用：

先确认扩展发送的是哪一种具体请求：

• Chat Completions 的最终路径通常是 /v1/chat/completions。
• Responses 的最终路径是 /v1/responses，官方 Codex 扩展属于这一类。
• 扩展若只支持固定服务或不允许自定义地址，则不能按本节接入。

不要把完整请求路径直接填入只要求 Base URL 的输入框。更多字段模板见 手动配置，地址差异见 端点说明。

#Claude Code 扩展

Claude Code 的 VS Code 扩展使用 Anthropic Messages 网关。先在启动 VS Code 的环境中设置：

export ANTHROPIC_BASE_URL="https://api.thqllm.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_THQ_API_KEY"
export ANTHROPIC_MODEL="CONTROL_PANEL_MODEL_ID"

ANTHROPIC_BASE_URL 必须使用不带 /v1 的主机地址。扩展会追加 Anthropic Messages 路径； 手动添加 /v1 可能造成重复路径。

如果 VS Code 已经运行，它通常不会自动获得后来新增的 shell 环境变量。可以完全退出 VS Code， 再从已设置变量的终端启动；也可以按组织的受控环境配置方式注入变量。详细说明见 Claude Code 接入指南和 Claude Code VS Code 官方文档。

#保存并重新加载窗口

完成设置后：

1. 保存扩展设置或用户级配置文件。
2. 在命令面板运行 Developer: Reload Window。
3. 关闭旧的扩展会话，并创建新会话。
4. 如果修改了终端环境变量，完全退出 VS Code，再从读取到新变量的环境启动。
5. 检查扩展状态页、日志或配置诊断，确认 provider、Base URL 和模型已经更新。

只重新打开聊天面板不一定会重启扩展宿主，也不一定会重新读取环境变量。

#验证

在新会话中发送一条最小提示词：

请只回复：VS Code 已连接 THQ API

随后核对：

• 扩展显示的 provider 和模型是否符合预期。
• 最终请求路径是否与扩展协议一致。
• 控制台是否出现对应时间和模型的请求记录。
• 失败时是否有 HTTP 状态码、request ID 或已脱敏的错误信息。

#常见问题

#扩展设置中没有 Base URL

该扩展可能不支持自定义端点。查看扩展官方文档，不要假设隐藏字段、其他扩展的设置名或通用 OPENAI_BASE_URL 一定会生效。

#官方 Codex 扩展配置后请求失败

确认修改的是 ~/.codex/config.toml，provider 使用 Responses，并且 THQ 侧所选模型支持 /v1/responses。只支持 Chat Completions 的模型不能直接用于当前 Codex 自定义 provider。

#Claude Code 扩展仍使用旧地址

运行 Developer: Reload Window，关闭旧会话并新建会话。若变量是在 VS Code 启动后才设置， 完全退出后从正确的终端环境重新启动。

#返回 404

先确认扩展协议，再检查 Base URL 是否漏写或重复添加 /v1。OpenAI 兼容扩展使用 /v1 根地址；Claude Code 扩展使用不带版本后缀的地址。

更多排查步骤见客户端接入总览和 常见问题。