返回文档首页

VS Code 接入

VS Code 中的 AI 编程能力通常来自扩展。qimoq 推荐先配置本机 Codex 或 Claude Code,再让对应 VS Code 扩展复用本机配置。

Codex IDE 扩展

  1. Codex 接入 配好本机 Codex。
  2. 在 VS Code 安装 Codex IDE 扩展。
  3. 重新加载 VS Code 窗口。
  4. 打开扩展面板,确认它读取到 qimoq Provider。
  5. 发起一次简单任务,并在「使用日志」确认请求记录。

如果扩展仍使用旧账号或旧 Provider,先退出扩展会话,再重载窗口。

Claude Code VS Code 扩展

  1. Claude Code 接入 配好终端版 Claude Code。
  2. 在 VS Code 安装 Claude Code 相关扩展。
  3. 关闭旧终端和旧 VS Code 窗口。
  4. 重新打开项目目录后再启动扩展。
  5. 通过「使用日志」确认模型和消费记录。

Claude Code 扩展优先依赖本机 Claude Code 配置。终端版不可用时,扩展里继续排查通常会浪费时间。

验证

检查项预期
终端命令codex --versionclaude --version 可执行
Provider指向 qimoq,而不是官方默认服务
模型与「模型广场」复制的模型 ID 一致
日志「使用日志」能看到 VS Code 触发的请求

排查

现象处理
扩展没有读取新配置重载 VS Code 窗口,必要时退出后重新打开
终端可用但扩展不可用检查 VS Code 启动用户是否和终端配置用户一致
模型错误分别检查扩展设置和本机 CLI 配置
没有使用日志说明请求可能没有到达 qimoq,先检查 Provider 指向