# 国产模型接入

QCode.cc 在售的不只是 Claude / GPT / Gemini。同一把 `cr_` 密钥还可以调用智谱 GLM、月之暗面 Kimi、DeepSeek、通义 Qwen。本页只解决「怎么把请求打到这些 id 上」，不比较文采、不写营销。

日常默认仍然建议 Claude 5 系（见 [模型选择指南](/docs/usage/model-selection)）。国产档适合：中文办公与长文、单价更低的大批量、和 Claude 做对照。不要把未出现在 [qcode.cc/models](https://qcode.cc/models) 上的名字填进客户端。

## 现在在卖哪些

下列 id 于 2026-09-18 同时出现在 [qcode.cc/models](https://qcode.cc/models) 与公开端点 `GET https://api.qcode.cc/api/v1/models`（两处交叉验证；单价与上下文长度以 [qcode.cc/models](https://qcode.cc/models) 实时显示为准，本页不复制数字以免过时）。

| 家族 | 旗舰 id | 更轻一档 |
|------|---------|----------|
| 智谱 GLM | `glm-5.3` | `glm-5.3-flash` |
| 月之暗面 Kimi | `kimi-k3` | —（上一代 `kimi-k2.6` 已下架） |
| DeepSeek | `deepseek-v4-pro` | `deepseek-v4-flash` · `deepseek-v4.1-flash` |
| 通义 Qwen | `qwen3.8-max` | `qwen3.8-flash` · `qwen3.7-plus` |

已停售、文档旧例里还可能见到的名字：`qwen3.7-max`、`kimi-k2.6`、`glm-5.1`——两个在售清单里都已没有它们，客户端里填这些 id 会报错，请改用上表的 id。

**没有 grok。** 实时清单以 [qcode.cc/models](https://qcode.cc/models) 或带密钥 `GET https://api.qcode.cc/v1/models` 为准。

## 走哪条协议

协议由**路径**决定，Key 不区分家族。口径见 [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths)。

| 你用的工具 | 填什么 | 模型名字段填 |
|------------|--------|----------------|
| OpenAI SDK / LangChain / Cline「OpenAI Compatible」/ [WorkBuddy](/docs/ide/workbuddy) | `https://api.qcode.cc/openai/v1`（大陆优先 `https://asia.qcode.cc/openai/v1`） | `glm-5.3` 等上表 id，逐字符 |
| Claude Code（已按 [环境变量](/docs/getting-started/environment) 指到 QCode） | 不必改 `ANTHROPIC_BASE_URL` | 会话里 `/model glm-5.3` |
| 手写 HTTP | `POST /openai/v1/chat/completions` | JSON 的 `"model"` |

不要把国产 id 配到 Gemini 的 `/gemini` 前缀上。也不要在 OpenAI 兼容工具里填 `https://api.qcode.cc/api`（那是 Anthropic Messages 前缀）。

非 Claude 模型在 Claude Code 里可能用不了 Extended Thinking 等原生能力——[模型选择指南](/docs/usage/model-selection) 对 GPT 系已经写过同样的限制。拿不准就当补充档，不要替换日常默认。

## curl 自测

与接入点文档同一套判读：`400` = 路径与密钥都通（缺体属预期），`401` = 密钥无效，`404` = 前缀错了。

```bash
KEY="cr_你的密钥"

# 只验路径
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"

# 带一个在售国产 id 做端到端（把 glm-5.3 换成你要用的 id）
curl -sS https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"ping"}]}'
```

中国大陆把主机换成 `asia.qcode.cc` 再测一次。三个域同一把 Key。

OpenAI Python 客户端的参考写法（`base_url` 填到 `/openai/v1`，**不要**尾斜杠）：

```python
from openai import OpenAI

client = OpenAI(
    api_key="cr_你的密钥",
    base_url="https://api.qcode.cc/openai/v1",
)
resp = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "ping"}],
)
```

## 和 Claude 5 系怎么搭配

| 你在做的事 | 先用 | 国产什么时候上 |
|------------|------|----------------|
| 日常改代码 | `claude-sonnet-5` | 对照跑一遍，或预算紧时用 `deepseek-v4-pro` / `glm-5.3` |
| 难推理 / 大重构 | `claude-opus-5` | 不强制换；要省再试 `kimi-k3` |
| 中文长文、纪要、办公 | 任意旗舰 | `kimi-k3`、`glm-5.3`、`qwen3.8-max` 很常见 |
| 大批量、打杂 | `claude-haiku-4-5` | `deepseek-v4-flash` / `qwen3.8-flash` 单价更低 |

4.x（`claude-sonnet-4-6`、`claude-opus-4-8`）**仍在售**，只是不再当默认。价格与窗口以 [qcode.cc/models](https://qcode.cc/models) 为准。

办公桌面里接同一把 Key：见 [WorkBuddy 集成](/docs/ide/workbuddy)。Claude Code / Codex 之间切换：见 [CC Switch 配置](/docs/ide/cc-switch)。

## 常见问题

### 模型名填了但 404 / 空列表

id 必须是上表那种 `glm-5.3`，不是「GLM-5.3」或展示名。OpenAI 兼容模式下列表常是空的，手动填。

### 401

密钥 `cr_` 开头、无空格。到 [qcode.cc/dashboard](https://qcode.cc/dashboard) 核对。

### 能不能走 Anthropic 的 `/api/v1/messages` 调 GLM？

网关按路径选协议。OpenAI 兼容客户端用 `/openai/v1/chat/completions` 是文档里核实过的路径。Claude Code 已指到 QCode 时，用 `/model <id>` 换模型即可，不必再手拼 Messages 去调国产档。

### WorkBuddy / Cline 怎么填

WorkBuddy：提供商选 Custom，接口地址 `https://api.qcode.cc/openai/v1`，模型名称填上表 id。逐步说明见 [WorkBuddy 集成](/docs/ide/workbuddy)。Cline 用「OpenAI Compatible」同一套 Base URL 和 Model ID。

## 下一步

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths)
- [模型选择指南](/docs/usage/model-selection)
- [计费说明](/docs/reference/billing)
- [WorkBuddy 集成](/docs/ide/workbuddy)
- 实时型号：[qcode.cc/models](https://qcode.cc/models)