> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 模型

Qoder CLI内置了全球 SOTA 级别的 AI 模型，并提供灵活的选择机制，帮助你在开发效率、输出质量与成本之间找到最佳平衡。

## 模型选择方式

### 分级模型（Default）

模型分级选择器为开发者提供五个高性能模型池，在成本与性能之间取得不同平衡。如同智能汽车的驾驶模式，为每项任务选用最合适的档位。

| 级别               | 说明                 | 适用场景             | Credit 消耗 |
| ---------------- | ------------------ | ---------------- | --------- |
| 智能路由 (Auto)      | 智能选择最适合的模型，平衡性能与成本 | 大部分日常开发工作，建议默认使用 | \~1.0×    |
| 极致 (Ultimate)    | 专家级深度推理与思考能力       | 复杂系统设计、高难度问题分析   | \~1.6×    |
| 性能 (Performance) | 高级推理能力，高质量输出       | 核心功能实现、架构设计、代码重构 | \~1.1×    |
| 经济 (Efficient)   | 标准推理能力，高性价比        | 基础代码生成、单元测试、日常问答 | \~0.3×    |
| 轻量 (Lite)        | 基础推理能力，免费使用        | 快速验证、基础逻辑实现、快问快答 | 免费        |

> 轻量 (Lite) 模式仅 Team 版用户可使用，在高峰时段可能响应较慢，且暂不支持多模态问答。

#### Credit 消耗对比

下表展示完成一个中等复杂度编码任务时，不同分级的 Credit 消耗示例。实际消耗会受任务、代码库、上下文长度和模型参数影响。

| 模型分级        | Credit 消耗倍率 | 单示例任务消耗    |
| ----------- | ----------- | ---------- |
| Auto        | \~1.0×      | 10 Credits |
| Ultimate    | \~1.6×      | 20 Credits |
| Performance | \~1.1×      | 11 Credits |
| Efficient   | \~0.3×      | 3 Credits  |
| Lite        | 免费          | 0 Credits  |

### 前沿模型（New Models）

New Models 标签页会展示当前开放的具体模型。适合对模型有明确偏好，或希望验证特定能力的场景。

可选模型、模型简介、Credit 消耗倍率和支持的参数可能随服务端模型列表更新；以 `/model` 界面和 `--list-models` 输出为准。

> 目前只开放部分模型供直接选择。

| 模型名称              | 模型简介                                   | Credit 消耗倍率 |
| ----------------- | -------------------------------------- | ----------- |
| Qwen3.7-Max       | Agentic 能力的全面跃迁，可自主完成长程复杂任务            | 0.5×        |
| Qwen3.7-Plus      | 推理能力、效率与多模态体验的全面跃迁                     | 0.1×        |
| DeepSeek-V4-Pro   | 复杂推理、代码生成与工程任务表现卓越                     | 0.5×        |
| DeepSeek-V4-Flash | 推理速度快且成本低廉，综合能力均衡                      | 0.1×        |
| GLM-5.2           | 擅长复杂系统工程与长程任务                          | 0.6×        |
| Kimi-K2.7-Code    | Kimi 最新模型，专为长上下文编码打造：精准的指令遵循，可靠的长程任务执行 | 0.3×        |
| MiniMax-M3        | 原生多模态感知、前沿编码能力，以及 1M 上下文深度，适合高强度工作流    | 0.2×        |

<Tip>
  **Kimi-K2.7-Code** 在参数面板提供 **Fast** 开关。开启后响应速度约提升至 6×，Credit 倍率会从 0.3× 上调至 0.6×。
</Tip>

### 自定义模型（Custom）

接入模型厂商提供的订阅计划。Qoder 提供了一批受支持的 Provider，用户使用自己在对应厂商的 API Key 即可调用。

支持通过 API 密钥接入第三方供应商的模型资源。

<Note>
  **适用版本**：个人版

  **支持的供应商**：阿里云百炼、DeepSeek、智谱、Kimi、MiniMax、小米 MIMO
</Note>

## 模型参数配置

部分模型支持配置参数，以便更好地适应不同任务类型。可用参数取决于当前模型，CLI 会在 `/model` 模型列表和模型参数面板中展示当前模型支持的选项。

### 上下文窗口

上下文窗口控制对话可用的最大上下文长度。常见选项包括：

| 选项   | 说明                   |
| ---- | -------------------- |
| 200K | 标准上下文窗口，满足大多数任务需求    |
| 400K | 扩展上下文，适用于更大的代码库或较长对话 |
| 1M   | 最大上下文，适用于超大规模项目      |

在 TUI 模式下输入 `/context-window` 可打开模型参数面板并调整上下文窗口。

### 思考强度

控制模型在生成回复前的推理深度。可用的选项因模型而异，选择模型后界面会显示该模型支持的档位。

| 选项     | 说明              |
| ------ | --------------- |
| low    | 最少推理，响应最快       |
| medium | 推理深度适中          |
| high   | 深入推理，适合复杂任务     |
| xhigh  | 深度分析，适用于高难度问题   |
| max    | 最大推理深度，适合最复杂的挑战 |

在 TUI 模式下输入 `/effort` 可调整当前模型的思考强度。不带参数时打开模型参数面板，也可以直接指定 level：

```text theme={null}
/effort high
/effort auto --session-only
/effort off
```

默认会保存到 `~/.qoder/settings.json`；加 `--session-only` 则仅对当前会话生效。

### Fast 模式

部分模型提供 Fast 模式，用于优先提升响应速度。开启后 Credit 消耗可能变化，具体以模型参数面板展示为准。

```text theme={null}
/fast on
```

### 支持的模型

目前 Ultimate、Performance、DeepSeek-V4-Pro、DeepSeek-V4-Flash、Qwen3.7-Max、Qwen3.7-Plus、GLM-5.2、MiniMax-M3 和 Kimi-K2.7-Code 支持参数配置。其中 Qwen3.7-Max、Qwen3.7-Plus、GLM-5.2 和 MiniMax-M3 仅支持上下文窗口；Kimi-K2.7-Code 仅支持开启 Fast 模式；其余模型同时支持上下文窗口和思考强度。

## 切换模型

### TUI 中切换

在 TUI 模式下输入 `/model` 打开选择界面，界面分为 Default、New Models 和 Custom 三个标签页：

```text theme={null}
/model
```

`↑` / `↓` 选择，`Tab` 切换标签页，`Enter` 确认，`Esc` 关闭。

选择的模型会自动保存到 `~/.qoder/settings.json`，下次启动无需重新选择。

### 命令行参数指定

通过 `--model`、`--reasoning-effort` 和 `--context-window` 参数在启动时直接指定模型设置，仅对本次会话生效：

```bash theme={null}
qodercli --model efficient   # Efficient 分级
qodercli --model auto        # Auto 分级
qodercli --reasoning-effort high
qodercli --context-window 400000
```

### 列出可用模型

使用 `--list-models` 可以在无界面模式下输出当前账号可用的模型列表，适合脚本或自动化场景：

```bash theme={null}
qodercli --list-models
```

## 添加自定义模型

1. 输入 `/model`，切换到 **Custom** 标签页
2. 选择 `Add custom model...` 并按 `Enter`
3. 按引导依次选择 Provider → 模型类型 → 具体模型
4. 填写 API Key 等配置信息
5. 验证通过后自动保存，可立即切换使用

删除自定义模型：在 Custom 标签页选中目标模型后按 `d`。