> ## 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.

# Model

Qoder CLI includes world-class SOTA AI models and provides a flexible selection mechanism to help you find the right balance between development efficiency, output quality, and cost.

## Model Selection

### Tiered Models (Default)

The model tier selector provides five high-performance model pools for developers, each with a different balance between cost and performance. Like driving modes in a smart car, you can choose the right gear for each task.

| Tier                 | Description                                                                   | Use Cases                                                          | Credit Usage |
| -------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------ | ------------ |
| Smart Routing (Auto) | Intelligently selects the most suitable model, balancing performance and cost | Most daily development work, recommended as the default            | \~1.0x       |
| Ultimate             | Expert-level deep reasoning and thinking capabilities                         | Complex system design, high-difficulty problem analysis            | \~1.6x       |
| Performance          | Advanced reasoning capabilities and high-quality output                       | Core feature implementation, architecture design, code refactoring | \~1.1x       |
| Efficient            | Standard reasoning capabilities with high cost-effectiveness                  | Basic code generation, unit tests, daily Q\&A                      | \~0.3x       |
| Lite                 | Basic reasoning capabilities, free to use                                     | Quick validation, basic logic implementation, quick Q\&A           | Free         |

> Lite mode is available only for Team users. It may respond more slowly during peak hours and does not currently support multimodal Q\&A.

#### Credit Usage Comparison

The table below shows example Credit usage for a moderately complex coding task. Actual usage may vary depending on the task, codebase, context length, and model parameters.

| Model Tier  | Credit Usage Rate | Example Task Usage |
| ----------- | ----------------- | ------------------ |
| Auto        | \~1.0x            | 10 Credits         |
| Ultimate    | \~1.6x            | 20 Credits         |
| Performance | \~1.1x            | 11 Credits         |
| Efficient   | \~0.3x            | 3 Credits          |
| Lite        | Free              | 0 Credits          |

### Frontier Models (New Models)

The New Models tab shows the specific models currently available. It is suitable when you have a clear model preference or want to verify specific capabilities.

Available models, descriptions, Credit usage rates, and supported parameters may change with server-side model list updates. Refer to the `/model` interface and `--list-models` output for the current list.

> Currently, only some models are open for direct selection.

| Model Name        | Description                                                                                                           | Credit Usage Rate |
| ----------------- | --------------------------------------------------------------------------------------------------------------------- | ----------------- |
| Qwen3.7-Max       | Comprehensive leap in agentic capabilities, autonomously handling long-horizon complex tasks                          | 0.5x              |
| Qwen3.7-Plus      | Comprehensive leap in reasoning capability, efficiency, and multimodal experience                                     | 0.1x              |
| DeepSeek-V4-Pro   | Excels at complex reasoning, code generation, and engineering tasks                                                   | 0.5x              |
| DeepSeek-V4-Flash | Fast reasoning and low cost with balanced capabilities                                                                | 0.1x              |
| GLM-5.2           | Excels at complex systems engineering and long-horizon tasks                                                          | 0.6x              |
| Kimi-K2.7-Code    | Kimi's latest model, built for long-context coding: precise instruction following and reliable long-horizon execution | 0.3x              |
| MiniMax-M3        | Native multimodal perception, frontier coding capabilities, and 1M context depth for demanding workflows              | 0.2x              |

<Tip>
  **Kimi-K2.7-Code** provides a **Fast** toggle in the parameter panel. Turning it on increases response speed to about 6x, and the Credit rate rises from 0.3x to 0.6x.
</Tip>

### Custom Models (Custom)

Connect models from your own provider subscriptions. Qoder supports a curated list of providers. Configure your API key to start using them.

Qoder supports accessing third-party provider model resources via API keys.

<Note>
  **Applicable For**: Individual plan

  **Supported Providers**: Alibaba Cloud Model Studio, DeepSeek, Z.ai, Kimi, MiniMax, Xiaomi MIMO
</Note>

## Model Parameters

Some models support configurable parameters to better adapt to different task types. Available parameters depend on the current model. The CLI shows supported options in the `/model` model list and model parameter panel.

### Context Window

The context window controls the maximum context length available for the conversation. Common options include:

| Option | Description                                                   |
| ------ | ------------------------------------------------------------- |
| 200K   | Standard context window, sufficient for most tasks            |
| 400K   | Extended context for larger codebases or longer conversations |
| 1M     | Maximum context for extremely large-scale projects            |

In TUI mode, type `/context-window` to open the model parameter panel and adjust the context window.

### Thinking Effort

Controls how deeply the model reasons before generating a response. Available options vary by model. After you select a model, the interface shows the levels supported by that model.

| Option | Description                                             |
| ------ | ------------------------------------------------------- |
| low    | Minimal reasoning, fastest response                     |
| medium | Moderate reasoning depth                                |
| high   | Deep reasoning for complex tasks                        |
| xhigh  | Deep analysis for high-difficulty problems              |
| max    | Maximum reasoning depth for the most complex challenges |

Use `/effort` in TUI mode to adjust the current model's thinking effort. Run it without arguments to open the model parameter panel, or pass a level directly:

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

By default, changes are saved to `~/.qoder/settings.json`; add `--session-only` to apply them only to the current session.

### Fast Mode

Some models provide Fast mode to prioritize response speed. Credit usage may change after it is enabled. Refer to the model parameter panel for details.

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

### Supported Models

Currently, Ultimate, Performance, DeepSeek-V4-Pro, DeepSeek-V4-Flash, Qwen3.7-Max, Qwen3.7-Plus, GLM-5.2, MiniMax-M3, and Kimi-K2.7-Code support parameter configuration. Qwen3.7-Max, Qwen3.7-Plus, GLM-5.2, and MiniMax-M3 support only context window configuration; Kimi-K2.7-Code supports only enabling Fast mode; the remaining models support both context window and thinking effort.

## Switching Models

### Switch in TUI

Type `/model` in TUI mode to open the model selector. The interface has three tabs: Default, New Models, and Custom.

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

`↑` / `↓` to navigate, `Tab` to switch tabs, `Enter` to confirm, `Esc` to close.

Your selection is automatically saved to `~/.qoder/settings.json` and persists across sessions.

### Command-Line Flags

Use the `--model`, `--reasoning-effort`, and `--context-window` flags to specify model settings at startup. These apply to the current session only and are not persisted:

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

### List Available Models

Use `--list-models` to print the models available to the current account without opening the TUI. This is useful for scripts and automation:

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

## Adding a Custom Model

1. Type `/model` and switch to the **Custom** tab
2. Select `Add custom model...` and press `Enter`
3. Follow the prompts to select Provider -> Model Type -> Model
4. Enter your API key and any other required fields
5. Once verified, the model is saved and ready to use

To delete a custom model, select it in the Custom tab and press `d`.
