> ## 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.8-Max-Preview | Qwen 最新基座模型，拥有 2.4T 参数，在软件工程、办公与深度推理方面表现领先 | 0.5× |
| 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-K3 | Kimi 最强模型，拥有 2.8T 参数，专为软件工程、知识工作与深度推理打造 | 0.8× |
| Kimi-K2.7-Code | Kimi 最新模型，专为长上下文编码打造：精准的指令遵循，可靠的长程任务执行 | 0.3× |
| MiniMax-M3 | 原生多模态感知、前沿编码能力，以及 1M 上下文深度，适合高强度工作流 | 0.2× |

表中 Credit 消耗倍率仅供参考，实际以届时生效的营销活动为准。

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

### 自定义模型（Custom）

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

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

> [!NOTE]
>
> **适用版本**：个人版
>
> **支持的供应商**：阿里云百炼、DeepSeek、智谱、Kimi、MiniMax、小米 MIMO

## 模型参数配置

部分模型支持配置参数，以便更好地适应不同任务类型。可用参数取决于当前模型，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.8-Max-Preview、Qwen3.7-Max、Qwen3.7-Plus、GLM-5.2、MiniMax-M3、Kimi-K3 和 Kimi-K2.7-Code 支持参数配置。其中 Ultimate、Performance、DeepSeek-V4-Pro、DeepSeek-V4-Flash 和 GLM-5.2 支持上下文窗口、思考开关和思考强度；Qwen3.8-Max-Preview、Qwen3.7-Max 和 Qwen3.7-Plus 支持上下文窗口和思考开关；MiniMax-M3 和 Kimi-K3 仅支持上下文窗口；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`。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.