🌠Qwen3-Coder-Next：本地运行指南

在您的设备上本地运行 Qwen3-Coder-Next 的指南！

Qwen 发布了 Qwen3-Coder-Next，这是一个 80B MoE 模型（3B 活跃参数），具有 256K 上下文 用于快速的自主编码和本地使用。其性能可与活跃参数数量高出 10–20 倍的模型相媲美。

它在 46GB 内存/显存/统一内存（8 位为 85GB）上运行，为超快速代码响应而使用非推理（non-reasoning）模式。该模型在长时程推理、复杂工具使用以及从执行失败中恢复方面表现出色。

2 月 4 日更新： llama.cpp 修复了一个错误，该错误修正了 向量化 key_gdiff 的计算。 这修复了之前的循环和输出问题。我们更新了 GGUF —— 请 重新下载 并且更新 llama.cpp 以获得更好的输出。

我们引入了新的 MXFP4 量化，以获得出色的质量和速度，你还将学习如何在 Codex 与 Claude Code 上运行该模型。

Qwen3-Coder-Next Unsloth 动态 GGUFs 以运行： unsloth/Qwen3-Coder-Next-GGUF

运行 GGUF 教程 Codex 与 Claude Code FP8 vLLM 教程

⚙️ 使用指南

没有 46GB 内存或统一内存？别担心，你可以运行我们更小的量化版本，比如 3 位。最好使模型大小等于你计算资源之和（ 磁盘空间 + 内存 + 显存 ≥ 量化文件大小）。 如果你的量化文件完全适合你的设备，预期速度为 20+ 令牌/秒。如果不完全适合，它仍可通过卸载（offloading）工作，但会更慢。

为了获得最佳性能，Qwen 建议以下设置：

Temperature = 1.0
Top_P = 0.95
Top_K = 40
Min_P = 0.01 （llama.cpp 的默认值是 0.05）

原生支持最多 262,144 上下文，但你可以将其设置为 32,768 令牌以减少内存使用。

🖥️ 运行 Qwen3-Coder-Next

根据你的使用场景，你需要使用不同的设置。因为本指南使用 4 位，你将需要大约 46GB 内存/统一内存。我们建议至少使用 3 位精度以获得最佳性能。

注意：此模型仅支持非思考模式（non-thinking mode），不会在其输出中生成 <think></think> 块。因此不再需要指定 enable_thinking=False 。

Llama.cpp 教程（GGUF）：

在 llama.cpp 中运行的说明（注意我们将使用 4 位以适配大多数设备）：

获取最新的 llama.cpp 在 GitHub 这里。你也可以按照下面的构建说明。将 -DGGML_CUDA=ON 改为 -DGGML_CUDA=OFF 如果你没有 GPU 或者只想使用 CPU 推理。

apt-get update
apt-get install pciutils build-essential cmake curl libcurl4-openssl-dev -y
git clone https://github.com/ggml-org/llama.cpp
cmake llama.cpp -B llama.cpp/build \
    -DBUILD_SHARED_LIBS=OFF -DGGML_CUDA=ON
cmake --build llama.cpp/build --config Release -j --clean-first --target llama-cli llama-mtmd-cli llama-server llama-gguf-split
cp llama.cpp/build/bin/llama-* llama.cpp

你可以直接从 Hugging Face 拉取。如果你的内存/显存可以容纳，你可以将上下文增加到 256K。使用 --fit on 也会自动确定上下文长度。

你可以使用推荐参数： temperature=1.0, top_p=0.95, top_k=40

./llama.cpp/llama-cli \
    -hf unsloth/Qwen3-Coder-Next-GGUF:UD-Q4_K_XL \
    --jinja --ctx-size 16384 \
    --temp 1.0 --top-p 0.95 --min-p 0.01 --top-k 40 --fit on

通过以下方式下载模型（在安装 pip install huggingface_hub之后）。你可以选择 UD-Q4_K_XL 或其他量化版本。

pip install -U huggingface_hub
hf download unsloth/Qwen3-Coder-Next-GGUF \
    --local-dir unsloth/Qwen3-Coder-Next-GGUF \
    --include "*UD-Q4_K_XL*"

然后以对话模式运行模型：

./llama.cpp/llama-cli \
    --model unsloth/Qwen3-Coder-Next-GGUF/Qwen3-Coder-Next-UD-Q4_K_XL.gguf \
    --fit on \
    --seed 3407 \
    --temp 1.0 \
    --top-p 0.95 \
    --min-p 0.01 \
    --top-k 40 \
    --jinja

此外，根据需要调整 上下文窗口 最多为 262,144

注意：此模型仅支持非思考模式（non-thinking mode），不会在其输出中生成 <think></think> 块。因此不再需要指定 enable_thinking=False 。

🦙Llama-server 服务与部署

要将 Qwen3-Coder-Next 部署到生产环境，我们使用 llama-server 在新终端（例如通过 tmux）中。然后，通过以下命令部署模型：

./llama.cpp/llama-server \
    --model unsloth/Qwen3-Coder-Next-GGUF/Qwen3-Coder-Next-UD-Q4_K_XL.gguf \
    --alias "unsloth/Qwen3-Coder-Next" \
    --fit on \
    --seed 3407 \
    --temp 1.0 \
    --top-p 0.95 \
    --min-p 0.01 \
    --top-k 40 \
    --port 8001 \
    --jinja

然后在新终端中，在执行 pip install openai之后，我们可以运行该模型：

from openai import OpenAI
import json
openai_client = OpenAI(
    base_url = "http://127.0.0.1:8001/v1",
    api_key = "sk-no-key-required",
)
completion = openai_client.chat.completions.create(
    model = "unsloth/Qwen3-Coder-Next",
    messages = [{"role": "user", "content": "Create a Flappy Bird game in HTML"},],
)
print(completion.choices[0].message.content)

将输出：

这是一个完整且可运行的 Flappy Bird 游戏，包含在单个文件中。

我使用 **HTML5 Canvas** 进行图形绘制，使用 **JavaScript** 实现物理（重力、碰撞检测和计分）。无需外部图像或下载；游戏使用代码绘制小鸟和水管。

### 如何运行：
1.  复制下面的代码块。
2.  在你的计算机上创建一个名为 `game.html` 的新文件。
3.  将代码粘贴到该文件并保存。
4.  双击 `game.html` 在你的网页浏览器中打开它。

```html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Simple Flappy Bird</title>
    <style>
        body {
            margin: 0;
            padding: 0;
            display: flex;
            flex-direction: column;
            justify-content: center;
            align-items: center;
            height: 100vh;
            background-color: #333;
            font-family: 'Courier New', Courier, monospace;
            color: white;
        }

        h1 {
            margin-bottom: 10px;
        }

        #game-container {
            position: relative;
            box-shadow: 0 0 20px rgba(0,0,0,0.5);
        }

        canvas {
            display: block;
            background-color: #70c5ce; /* Sky blue */
            border: 4px solid #000;
        }

        #ui-layer {
            position: absolute;
            top: 0;
            left: 0;
            width: 100%;
            height: 100%;
            pointer-events: none; /* Let clicks pass through to canvas */
            display: flex;
            flex-direction: column;
            justify-content: center;
            align-items: center;
            text-align: center;
        }

        .message {
            background: rgba(255, 255, 255, 0.8);
            padding: 20px;
            border-radius: 10px;
            color: #333;
        }

        #score-board {
            position: absolute;
            top: 20px;
            width: 100%;
            text-align: center;
            font-size: 40px;
            font-weight: bold;
            color: white;
            text-shadow: 2px 2px 0 #000;
            z-index: 10;
        }
    </style>
</head>
<body>

    <h1>Flappy Bird Clone</h1>
    
    <div id="game-container">
        <div id="score-board">0</div>
        <canvas id="birdCanvas" width="320" height="480"></canvas>
        
        <div id="ui-layer">
            <div id="start-screen" class="message">
                <h2>Ready to Fly?</h2>
                <p>Press <strong>Space</strong> or <strong>Click</strong> to Jump</p>
                <p>Press Space to Start</p>
            </div>
            <div id="game-over-screen" class="message" style="display: none;">
                <h2>Game Over</h2>
                <p>Score: <span id="final-score">0</span></p>
                <p>Best: <span id="best-score">0</span></p>
                <p>Press <strong>Space</strong> to Restart</p>
            </div>
        </div>
    </div>

    <script>
        // --- Configuration ---
        const canvas = document.getElementById('birdCanvas');
        const ctx = canvas.getContext('2d');
        const scoreElement = document.getElementById('score-board');
        const startScreen = document.getElementById('start-screen');
        const gameOverScreen = document.getElementById('game-over-screen');
        const finalScoreSpan = document.getElementById('final-score');
        const bestScoreSpan = document.getElementById('best-score');

        // Game Variables
        let frames = 0;
        let score = 0;
        let highScore = localStorage.getItem('flappyHighScore') || 0;
        let gameState = 'START'; // START, PLAYING, GAMEOVER
        const gravity = 0.25;
        const speed = 2; // Speed of pipes moving left

        // --- The Bird Object ---
        const bird = {
            x: 50,
            y: 150,
            width: 30,
            height: 30,
            velocity: 0,
            jumpStrength: 4.5,
            radius: 15,
            draw: function() {
                ctx.fillStyle = "#FFD700"; // Gold color
                ctx.beginPath();
                ctx.arc(this.x + this.radius, this.y + this.radius, this.radius, 0, Math.PI * 2);
                ctx.fill();
                ctx.lineWidth = 2;
                ctx.stroke();

                // Eye
                ctx.fillStyle = "white";
                ctx.beginPath();
                ctx.arc(this.x + this.radius + 5, this.y + this.radius - 5, 5, 0, Math.PI * 2);
                ctx.fill();
                ctx.fillStyle = "black";
                ctx.beginPath();
                ctx.arc(this.x + this.radius + 7, this.y + this.radius - 5, 2, 0, Math.PI * 2);
                ctx.fill();
                
                // Beak
                ctx.fillStyle = "orange";
                ctx.beginPath();
                ctx.moveTo(this.x + this.radius + 10, this.y + this.radius);
                ctx.lineTo(this.x + this.radius + 20, this.y + this.radius + 5);
                ctx.lineTo(this.x + this.radius + 10, this.y + this.radius + 10);
                ctx.fill();
                ctx.stroke();
            },
            update: function() {
                this.velocity += gravity;
                this.y += this.velocity;

                // Floor Collision
                if (this.y + this.height >= canvas.height) {
                    this.y = canvas.height - this.height;
                    gameOver();
                }
                
                // Ceiling Collision (Optional: prevents flying over pipes)
                if (this.y < 0) {
                    this.y = 0;
                    this.velocity = 0;
                }
            },
            jump: function() {
                this.velocity = -this.jumpStrength;
            },
            reset: function() {
                this.y = 150;
                this.velocity = 0;
            }
        };

        // --- The Pipes Array ---
        const pipes = {
            position: [],
            width: 50,
            gap: 120, // Space between top and bottom pipe
            dx: 2, // Movement speed

            draw: function() {
                for (let i = 0; i < this.position.length; i++) {
                    let p = this.position[i];
                    let topY = p.y;
                    let bottomY = p.y + this.gap;

                    ctx.fillStyle = "#228B22"; // Forest Green

                    // Top Pipe
                    ctx.fillRect(p.x, 0, this.width, topY);
                    ctx.strokeRect(p.x, 0, this.width, topY);

                    // Bottom Pipe
                    ctx.fillRect(p.x, bottomY, this.width, canvas.height - bottomY);
                    ctx.strokeRect(p.x, bottomY, this.width, canvas.height - bottomY);
                }
            },

            update: function() {
                // Add new pipe every 120 frames (approx 2 seconds)
                if (frames % 120 === 0) {
                    // Random height for top pipe
                    // Min height 50, Max height canvas - gap - 50
                    let maxY = canvas.height - this.gap - 50;
                    let randomY = Math.floor(Math.random() * (maxY - 50 + 1) + 50);
                    
                    this.position.push({
                        x: canvas.width,
                        y: randomY
                    });
                }

                for (let i = 0; i < this.position.length; i++) {
                    let p = this.position[i];
                    p.x -= this.dx;

                    // Collision Detection
                    // Logic: Check if bird X is within pipe X range
                    if (bird.x + bird.width > p.x && bird.x < p.x + this.width) {
                        // Logic: Check if bird Y is hitting Top Pipe OR Bottom Pipe
                        if (bird.y < p.y || bird.y + bird.height > p.y + this.gap) {
                            gameOver();
                        }
                    }

                    // Score Update (when bird passes pipe)
                    if (p.x + this.width < bird.x && !p.passed) {
                        score++;
                        scoreElement.innerText = score;
                        p.passed = true;
                    }

                    // Remove pipes that have gone off screen
                    if (p.x + this.width <= 0) {
                        this.position.shift();
                        // Decrement i because array length changed
                        i--; 
                    }
                }
            },
            
            reset: function() {
                this.position = [];
            }
        };

        // --- Background (Clouds/Grass) ---
        const background = {
            draw: function() {
                // Draw Grass
                ctx.fillStyle = "#7cfc00"; // Lawn Green
                ctx.fillRect(0, canvas.height - 20, canvas.width, 20);
                ctx.beginPath();
                ctx.moveTo(0, canvas.height - 20);
                ctx.lineTo(canvas.width, canvas.height - 20);
                ctx.stroke();
            }
        };

        // --- Game Control Functions ---

        function loop() {
            // Clear Canvas
            ctx.clearRect(0, 0, canvas.width, canvas.height);

            // Draw Background
            background.draw();

            if (gameState === 'START') {
                bird.draw();
                // Draw a ground line
                ctx.fillStyle = "#ded895";
                ctx.fillRect(0, canvas.height - 10, canvas.width, 10);
            } 
            else if (gameState === 'PLAYING') {
                bird.update();
                bird.draw();
                pipes.update();
                pipes.draw();
                frames++;
            } 
            else if (gameState === 'GAMEOVER') {
                pipes.draw();
                bird.draw();
                // Don't update frames or position, just freeze
            }

            requestAnimationFrame(loop);
        }

        function startGame() {
            gameState = 'PLAYING';
            startScreen.style.display = 'none';
            gameOverScreen.style.display = 'none';
            score = 0;
            frames = 0;
            scoreElement.innerText = score;
            bird.reset();
            pipes.reset();
        }

        function gameOver() {
            gameState = 'GAMEOVER';
            
            // Update High Score
            if (score > highScore) {
                highScore = score;
                localStorage.setItem('flappyHighScore', highScore);
            }

            finalScoreSpan.innerText = score;
            bestScoreSpan.innerText = highScore;
            gameOverScreen.style.display = 'block';
        }

        // --- Input Handling ---

        function handleInput(e) {
            // Prevent default scrolling behavior for Space
            if (e.type === 'keydown' && e.code === 'Space') {
                e.preventDefault();
            }

            if (e.code === 'Space' || e.type === 'mousedown' || e.type === 'touchstart') {
                switch (gameState) {
                    case 'START':
                        startGame();
                        bird.jump();
                        break;
                    case 'PLAYING':
                        bird.jump();
                        break;
                    case 'GAMEOVER':
                        startGame();
                        bird.jump();
                        break;
                }
            }
        }

        window.addEventListener('keydown', handleInput);
        canvas.addEventListener('mousedown', handleInput);
        canvas.addEventListener('touchstart', handleInput);

        // Initialize
        loop();

    </script>
</body>
</html>
```

### 本版本功能：
1.  **物理：** 逼真的重力和跳跃机制。
2.  **碰撞检测：** 如果你撞到水管、地面或天花板，游戏将结束。
3.  **计分系统：** 每通过一个水管获得 1 分。
4.  **最高分：** 使用浏览器的 LocalStorage 记录你的最高分，即使刷新页面也会保留。
5.  **响应式控制：** 支持 **空格键**、**鼠标点击** 或 **触摸**（适用于移动设备）。
6.  **图形：** 小鸟由代码绘制（包括眼睛和喙），水管有边框，因此不会出现损坏的图片链接。

我们提取了该 HTML 并运行，示例生成的 Flappy Bird 游戏运行良好！

👾 OpenAI Codex 与 Claude Code

要通过本地编码代理工作负载运行模型，你可以按照我们的指南。只需将模型名称 'GLM-4.7-Flash' 更改为 'Qwen3-Coder-Next'，并确保遵循正确的 Qwen3-Coder-Next 参数和使用说明。使用我们刚刚设置的 llama-server 配置。

Claude Code & OpenAI Codex

例如，在按照 Claude Code 的说明操作后，你将看到：

然后我们可以例如请求 创建一个用 Python 实现的国际象棋游戏 :

如果你看到 API Error: 400 {"error":{"code":400,"message":"request (16582 tokens) exceeds the available context size (16384 tokens), try increasing it","type":"exceed_context_size_error","n_prompt_tokens":16582,"n_ctx":16384}} 那意味着你需要增加上下文长度或查看 📐 如何适应长上下文

🎱 在 vLLM 中的 FP8 Qwen3-Coder-Next

你现在可以使用我们的新 FP8 动态量化来获得高性能且快速的推理。首先从 nightly 安装 vLLM。将 --extra-index-url https://wheels.vllm.ai/nightly/cu130 更改为与你的 CUDA 版本相符的地址，可通过 nvidia-smi 找到 - 目前仅支持 cu129 并且 cu130 。

# 如果你没有 uv，请安装以加速环境安装
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建新的 Python 环境 - 如果你不想更改整个系统则需要
uv venv unsloth_fp8 --python 3.12 --seed
source unsloth_fp8/bin/activate

uv pip install --upgrade --force-reinstall vllm --torch-backend=auto --extra-index-url https://wheels.vllm.ai/nightly/cu130
uv pip install --upgrade --force-reinstall git+https://github.com/huggingface/transformers.git
uv pip install --force-reinstall numba

然后服务化 Unsloth 的动态 FP8 版本的模型。你还可以通过添加 --kv-cache-dtype fp8 启用 FP8 以将 KV 缓存内存使用降低 50%。 我们在 4 块 GPU 上部署了它，但如果你只有 1 块 GPU，请使用 CUDA_VISIBLE_DEVICES='0' 并设置 --tensor-parallel-size 1 或移除此参数。使用 tmux 在新终端中启动下面的命令然后 CTRL+B+D - 使用 返回到它。

export PYTORCH_CUDA_ALLOC_CONF=expandable_segments:False
CUDA_VISIBLE_DEVICES='0,1,2,3' vllm serve unsloth/Qwen3-Coder-Next-FP8-Dynamic \
    --served-model-name unsloth/Qwen3-Coder-Next \
    --tensor-parallel-size 4 \
    --tool-call-parser qwen3_coder \
    --enable-auto-tool-choice \
    --dtype bfloat16 \
    --seed 3407 \
    --max-model-len 200000 \
    --gpu-memory-utilization 0.93 \
    --port 8001

你应该会看到类似如下的内容。参见 Qwen3-Coder-Next 了解如何使用 OpenAI API 和工具调用实际使用 Qwen3-Coder-Next —— 这适用于 vLLM 和 llama-server。

🔧使用 Qwen3-Coder-Next 的工具调用

在一个新的终端中，我们创建了一些工具，例如加两个数、执行 Python 代码、执行 Linux 命令等：

import json, subprocess, random
from typing import Any
def add_number(a: float | str, b: float | str) -> float:
    return float(a) + float(b)
def multiply_number(a: float | str, b: float | str) -> float:
    return float(a) * float(b)
def substract_number(a: float | str, b: float | str) -> float:
    return float(a) - float(b)
def write_a_story() -> str:
    return random.choice([
        "很久很久以前，在一个遥远的银河系……",
        "有两个朋友，他们喜欢树懒和代码……",
        "世界毁灭了，因为每只树懒都进化出超人般的智慧……",
        "其中一个朋友毫不知情，另一个不小心写了一个让树懒进化的程序……",
    ])
def terminal(command: str) -> str:
    if "rm" in command or "sudo" in command or "dd" in command or "chmod" in command:
        msg = "无法执行 'rm, sudo, dd, chmod' 命令，因为它们很危险"
        print(msg); return msg
    print(f"正在执行终端命令 `{command}`")
    try:
        return str(subprocess.run(command, capture_output = True, text = True, shell = True, check = True).stdout)
    except subprocess.CalledProcessError as e:
        return f"命令失败: {e.stderr}"
def python(code: str) -> str:
    data = {}
    exec(code, data)
    del data["__builtins__"]
    return str(data)
MAP_FN = {
    "add_number": add_number,
    "multiply_number": multiply_number,
    "substract_number": substract_number,
    "write_a_story": write_a_story,
    "terminal": terminal,
    "python": python,
}
tools = [
    {
        "type": "function",
        "function": {
            "name": "add_number",
            "description": "将两个数字相加。",
            "parameters": {
                "type": "object",
                "properties": {
                    "a": {
                        "type": "string",
                        "description": "第一个数字。",
                    },
                    "b": {
                        "type": "string",
                        "description": "第二个数字。",
                    },
                },
                "required": ["a", "b"],
            },
        },
    },
    {
        "type": "function",
        "function": {
            "name": "multiply_number",
            "description": "将两个数字相乘。",
            "parameters": {
                "type": "object",
                "properties": {
                    "a": {
                        "type": "string",
                        "description": "第一个数字。",
                    },
                    "b": {
                        "type": "string",
                        "description": "第二个数字。",
                    },
                },
                "required": ["a", "b"],
            },
        },
    },
    {
        "type": "function",
        "function": {
            "name": "substract_number",
            "description": "将两个数字相减。",
            "parameters": {
                "type": "object",
                "properties": {
                    "a": {
                        "type": "string",
                        "description": "第一个数字。",
                    },
                    "b": {
                        "type": "string",
                        "description": "第二个数字。",
                    },
                },
                "required": ["a", "b"],
            },
        },
    },
    {
        "type": "function",
        "function": {
            "name": "write_a_story",
            "description": "写一个随机故事。",
            "parameters": {
                "type": "object",
                "properties": {},
                "required": [],
            },
        },
    },
    {
        "type": "function",
        "function": {
            "name": "terminal",
            "description": "从终端执行操作。",
            "parameters": {
                "type": "object",
                "properties": {
                    "command": {
                        "type": "string",
                        "description": "你希望运行的命令，例如 `ls`, `rm`, ...",
                    },
                },
                "required": ["command"],
            },
        },
    },
    {
        "type": "function",
        "function": {
            "name": "python",
            "description": "使用一些将被运行的 Python 代码调用 Python 解释器。",
            "parameters": {
                "type": "object",
                "properties": {
                    "code": {
                        "type": "string",
                        "description": "要运行的 Python 代码",
                    },
                },
                "required": ["code"],
            },
        },
    },
]

然后我们使用下面的函数（复制并粘贴执行），它们会自动解析函数调用并针对任何模型调用 OpenAI 端点：

from openai import OpenAI
def unsloth_inference(
    messages,
    temperature = 1.0,
    top_p = 0.95,
    top_k = 40,
    min_p = 0.01,
    repetition_penalty = 1.0,
):
    messages = messages.copy()
    openai_client = OpenAI(
        base_url = "http://127.0.0.1:8001/v1",
        api_key = "sk-no-key-required",
    )
    model_name = next(iter(openai_client.models.list())).id
    print(f"使用模型 = {model_name}")
    has_tool_calls = True
    original_messages_len = len(messages)
    while has_tool_calls:
        print(f"当前消息 = {messages}")
        response = openai_client.chat.completions.create(
            model = model_name,
            messages = messages,
            temperature = temperature,
            top_p = top_p,
            tools = tools if tools else None,
            tool_choice = "auto" if tools else None,
            extra_body = {"top_k": top_k, "min_p": min_p, "repetition_penalty" :repetition_penalty,}
        )
        tool_calls = response.choices[0].message.tool_calls or []
        content = response.choices[0].message.content or ""
        tool_calls_dict = [tc.to_dict() for tc in tool_calls] if tool_calls else tool_calls
        messages.append({"role": "assistant", "tool_calls": tool_calls_dict, "content": content,})
        for tool_call in tool_calls:
            fx, args, _id = tool_call.function.name, tool_call.function.arguments, tool_call.id
            out = MAP_FN[fx](**json.loads(args))
            messages.append({"role": "tool", "tool_call_id": _id, "name": fx, "content": str(out),})
        else:
            has_tool_calls = False
    return messages

现在我们将展示下面多种用于不同用例的工具调用运行方法：

执行生成的 Python 代码

messages = [{
    "role": "user",
    "content": [{"type": "text", "text": "用 Python 创建一个斐波那契函数并求 fib(20)。"}],
}]
unsloth_inference(messages, temperature = 1.0, top_p = 0.95, top_k = 40, min_p = 0.00)

执行任意终端命令

messages = [{
    "role": "user",
    "content": [{"type": "text", "text": "将 'I'm a happy Sloth' 写入文件，然后把它打印回来给我。"}],
}]
messages = unsloth_inference(messages, temperature = 1.0, top_p = 1.0, top_k = 40, min_p = 0.00)

我们确认文件已创建，确实创建了！

参见 Tool Calling Guide 了解更多关于工具调用的示例。

🛠️ 提高生成速度

如果使用 vLLM / SGLang，尝试使用我们的 FP8-Dynamic 量化，它可以将吞吐量提升 25% 或更多！见 Qwen3-Coder-Next

如果你有更多显存，可以尝试卸载更多 MoE 层，或卸载整层本身。

通常， -ot ".ffn_.*_exps.=CPU" 将所有 MoE 层卸载到 CPU！这实际上允许你将所有非 MoE 层放在 1 个 GPU 上，从而提高生成速度。如果你有更多 GPU 容量，可以自定义正则表达式以适配更多层。

如果你有更多一些 GPU 内存，尝试 -ot ".ffn_(up|down)_exps.=CPU" 这会将上投影和下投影的 MoE 层卸载。

尝试 -ot ".ffn_(up)_exps.=CPU" 如果你有更多 GPU 内存。这只会卸载上投影的 MoE 层。

你也可以自定义正则，例如 -ot "\.(6|7|8|9|[0-9][0-9]|[0-9][0-9][0-9])\.ffn_(gate|up|down)_exps.=CPU" 表示从第 6 层起卸载 gate、up 和 down 的 MoE 层。

最新的 llama.cpp 发行版还引入了高吞吐量模式。使用 llama-parallel。在这里阅读更多此处。你也可以 将 KV 缓存量化为 4 位 例如以减少 VRAM / RAM 的数据移动，这也可以使生成过程更快。下一节讨论了 KV 缓存量化。

📐 如何适应长上下文

为了适应更长的上下文，你可以使用 KV 缓存量化 将 K 和 V 缓存量化为更低的位数。这也可以由于减少 RAM / VRAM 数据移动而提高生成速度。K 量化的可选项（默认是 f16）包括下面这些。

--cache-type-k f32, f16, bf16, q8_0, q4_0, q4_1, iq4_nl, q5_0, q5_1

你应当使用 _1 这些变体以获得稍微提高的准确性，尽管它们稍慢。例如 q4_1, q5_1 所以尝试一下 --cache-type-k q4_1

你也可以量化 V 缓存，但你需要 用 Flash Attention 支持编译 llama.cpp 通过 -DGGML_CUDA_FA_ALL_QUANTS=ON，并使用 --flash-attn 来启用它。安装 Flash Attention 之后，你就可以使用 --cache-type-v q4_1

如果你正在使用我们的动态 FP8 量化 Qwen3-Coder-Next那么使用 FP8 KV 缓存量化可以使上下文长度支持大约翻倍。添加 --kv-cache-dtype fp8

📐基准测试

Qwen3-Coder-Next 在其规模中表现最佳，其性能可与具有 10–20 倍更多活跃参数的模型相媲美。

基准

Qwen3-Coder-Next (80B)

DeepSeek-V3.2 (671B)

GLM-4.7 (358B)

MiniMax M2.1 (229B)

SWE-Bench 验证（含 SWE-Agent）

70.6

70.2

74.2

74.8

SWE-Bench 多语种（含 SWE-Agent）

62.8

62.3

63.7

66.2

SWE-Bench Pro（含 SWE-Agent）

44.3

40.9

40.6

34.6

Terminal-Bench 2.0（含 Terminus-2 json）

36.2

39.3

37.1

32.6

Aider

66.2

69.9

52.1

61.0

上一页GLM-5 下一页GLM-4.7-Flash

最后更新于59分钟前

这有帮助吗？

hashtag⚙️ 使用指南

hashtag🖥️ 运行 Qwen3-Coder-Next

hashtagLlama.cpp 教程（GGUF）：

hashtag🦙Llama-server 服务与部署

hashtag👾 OpenAI Codex 与 Claude Code

hashtag🎱 在 vLLM 中的 FP8 Qwen3-Coder-Next

hashtag🔧使用 Qwen3-Coder-Next 的工具调用

hashtag执行生成的 Python 代码

hashtag执行任意终端命令

hashtag🛠️ 提高生成速度

hashtag📐 如何适应长上下文

hashtag📐基准测试

⚙️ 使用指南

🖥️ 运行 Qwen3-Coder-Next

Llama.cpp 教程（GGUF）：

🦙Llama-server 服务与部署

👾 OpenAI Codex 与 Claude Code

🎱 在 vLLM 中的 FP8 Qwen3-Coder-Next

🔧使用 Qwen3-Coder-Next 的工具调用

执行生成的 Python 代码

执行任意终端命令

🛠️ 提高生成速度

📐 如何适应长上下文

📐基准测试