返回文档首页
VS Code 接入
VS Code 中的 AI 编程能力通常来自扩展。qimoq 推荐先配置本机 Codex 或 Claude Code,再让对应 VS Code 扩展复用本机配置。
Codex IDE 扩展
- 按 Codex 接入 配好本机 Codex。
- 在 VS Code 安装 Codex IDE 扩展。
- 重新加载 VS Code 窗口。
- 打开扩展面板,确认它读取到 qimoq Provider。
- 发起一次简单任务,并在「使用日志」确认请求记录。
如果扩展仍使用旧账号或旧 Provider,先退出扩展会话,再重载窗口。
Claude Code VS Code 扩展
- 按 Claude Code 接入 配好终端版 Claude Code。
- 在 VS Code 安装 Claude Code 相关扩展。
- 关闭旧终端和旧 VS Code 窗口。
- 重新打开项目目录后再启动扩展。
- 通过「使用日志」确认模型和消费记录。
Claude Code 扩展优先依赖本机 Claude Code 配置。终端版不可用时,扩展里继续排查通常会浪费时间。
验证
| 检查项 | 预期 |
|---|---|
| 终端命令 | codex --version 或 claude --version 可执行 |
| Provider | 指向 qimoq,而不是官方默认服务 |
| 模型 | 与「模型广场」复制的模型 ID 一致 |
| 日志 | 「使用日志」能看到 VS Code 触发的请求 |
排查
| 现象 | 处理 |
|---|---|
| 扩展没有读取新配置 | 重载 VS Code 窗口,必要时退出后重新打开 |
| 终端可用但扩展不可用 | 检查 VS Code 启动用户是否和终端配置用户一致 |
| 模型错误 | 分别检查扩展设置和本机 CLI 配置 |
| 没有使用日志 | 说明请求可能没有到达 qimoq,先检查 Provider 指向 |
