返回文档首页
Claude Code 接入
Claude Code 接入 qimoq 时，核心是使用支持 Claude 模型的访问凭证，并把 Endpoint、主模型和快速模型写到客户端配置里。推荐使用 CC Switch 一键导入。
配置项
| 项目 | 填写建议 |
|---|---|
| Endpoint | 站点根地址，或由 CC Switch 自动写入 |
| API Key | 使用可调用 Claude 模型的 qimoq 访问凭证 |
| 主模型 | 例如 claude-sonnet-4-5，以「模型广场」显示为准 |
| 快速模型 | 可选择更快或更低成本的 Claude 模型 |
| 分组 | 确认访问凭证所在分组支持 Claude |
Claude Code 对模型和鉴权比较敏感。不要用只支持 GPT / Codex 的访问凭证去调用 Claude 模型。
安装
先确认 Claude Code 已经能在终端中运行：
claude --version
如果命令不存在，请先完成 Claude Code 官方安装流程，再继续导入 qimoq 配置。
配置步骤
- 在「模型广场」复制 Claude 模型 ID。
- 在「访问凭证」页面创建或选择支持 Claude 的凭证。
- 点击导入配置，目标客户端选择 Claude Code。
- 检查 Endpoint、API Key、主模型和快速模型。
- 允许浏览器打开 CC Switch，并保存配置。
- 关闭旧终端，重新打开后运行 Claude Code。
如果你还在 VS Code 中使用 Claude Code 扩展，也需要重启 VS Code 或重新加载窗口。
模型与分组
| 配置 | 常见错误 |
|---|---|
| Claude 模型 ID | 写成供应商展示名，或写成 GPT 模型 |
| Claude 分组凭证 | 使用了 Codex / GPT 分组凭证 |
| Endpoint | 多写 /v1 或缺少客户端要求的根地址 |
| 快速模型 | 留空时客户端可能回退到默认官方模型 |
模型 ID 和凭证分组必须匹配。只要其中一个不匹配，常见结果就是 401、404 或客户端反复要求重新登录。
排查
| 现象 | 处理 |
|---|---|
| 401 Unauthorized | 确认凭证完整、未过期、未禁用，并且不是脱敏展示值 |
| 404 model not found | 到「模型广场」重新复制 Claude 模型调用名称 |
| challenge mismatch | 清理旧 Claude Code 会话后重新导入配置 |
| VS Code 扩展不生效 | 先确认终端版 Claude Code 可用，再重载 VS Code |