第 1 课
安装 llama,按内存挑模型,在终端里对话
弄清 Llama App、llama cli、llama serve 的关系,用官方一行脚本装好 llama,按 llama.app/models 的内存建议挑模型,用 仓库:量化 下载并查看缓存,用 llama cli 单轮提问,学会 -sys、--temp 等采样参数、-rea off 关闭思考,以及上下文与内存相关参数。
课程目录第 1 / 3 课
学习位置仅保存在当前浏览器,有效期 180 天。
图文教材
本课依据:Llama 官方文档「Introduction」https://llama.app/docs/introduction 、「Installation」https://llama.app/docs/installation 、「Quickstart」https://llama.app/docs/quickstart 、「Using the CLI」https://llama.app/docs/cli ,以及官方模型页 https://llama.app/models (2026-10-27 核对,llama build b11852)。
这一课做完你会得到什么
在自己的电脑上装好 llama 命令,按内存挑一个合适的开源模型并下载,在终端里和它对话,学会设系统提示词、调采样参数、关掉思考过程。全程离线可用,不需要任何账号或 API Key。
Llama App 和 llama.cpp 是什么关系
llama.cpp 是在本机跑大模型的开源推理引擎(MIT 许可),模型用 GGUF 格式:一个文件里打包了权重、分词器和元数据。2026 年 9 月起,llama.cpp 团队和 Hugging Face 在 https://llama.app 推出了 Llama App(Mac 与 Windows 桌面应用),命令行工具则统一成一个 llama 命令:
| 形态 | 适合谁 |
|---|---|
| Llama App(Mac 菜单栏 / Windows 11 托盘) | 想点几下就用上本地模型的人 |
llama cli | 在终端里聊天、试模型、调参数 |
llama serve | 给其他程序提供本地 API 和网页聊天界面 |
三者底层都是 llama.cpp,模型都存在标准的 Hugging Face 缓存里,下载一次,App、命令行和其他工具都能用。本课以 llama 命令为主,因为它在 Mac、Windows、Linux 上用法一致,第 2、3 课的 API 也靠它。
第 1 步:安装
Mac 和 Windows 11 用户可以先在 https://llama.app 下载桌面 App(官网写明 Mac 安装包约 1 MB,装好约 4 MB;Mac 也可用 brew install --cask llama-app),装好后它会出现在菜单栏或系统托盘里。
命令行版本用官方一行安装脚本,Linux、macOS 通用(Windows 在 PowerShell 里用官网给出的 irm https://llama.app/install.ps1 | iex):
curl -LsSf https://llama.app/install.sh | sh
脚本会依次探测 CUDA、ROCm、Vulkan,都没有就按 CPU 指令集下载合适的版本,装到 ~/.local/bin/llama。
对照结果(2026-10-27 实测,Linux x86_64,无显卡,节选):
Version: b11852
Probing CUDA...
Probing ROCm...
Probing Vulkan...
Probing CPU...
Found: avx2
Found: avx512f
Downloading llama...
Installation completed successfully
Run the following command to start it:
llama serve
如果提示 ~/.local/bin 不在 PATH 里,按脚本给出的那行 echo 'export PATH=...' 加进 shell 配置,然后重开终端。装好后确认版本:
llama cli --version
对照结果(2026-10-27 实测):
version: 0.7.0-dev (build 11852, commit 7894e8b92)
built with Clang 22.1.8 for Linux x86_64
能打印版本和 build 号就说明装好了。llama help 可以看所有子命令,常用的是 cli、serve、download 和 update(升级到最新版)。
第 2 步:按内存挑模型
本地模型最先受限于内存。官方模型页 https://llama.app/models 给每个模型标了建议内存,例如(2026-10-27 页面):
- Qwen 3.5 Small 0.8B:8 GB 以上,Q8_0 文件 0.81 GB,适合入门和低配机器;
- Gemma 4(E2B 到 31B 多个尺寸):16 GB 以上;
- GPT-OSS 20B:24 GB 以上;
- Qwen 3.8 27B:32 GB 以上。
官方 Quickstart 用的是 unsloth/gemma-4-E4B-it-GGUF:Q4_K_M,约需 6 GB 内存。本课在只有约 2 GB 空闲内存的云主机上实测,所以选了最小的 ggml-org/Qwen3.5-0.8B-GGUF:Q8_0。内存够的话,把下面命令里的模型名换成 Gemma 4 即可,其他步骤完全相同。
模型名写成 Hugging Face 仓库:量化档位,冒号后面不写时默认找 Q4_K_M。先下载:
llama download -hf ggml-org/Qwen3.5-0.8B-GGUF:Q8_0
下载完会打印模型文件路径。看看缓存里有哪些模型:
llama cli -cl
对照结果(2026-10-27 实测):
number of models in cache: 1
1. ggml-org/Qwen3.5-0.8B-GGUF:Q8_0
第 3 步:在终端里聊天
直接带上模型名运行就进入交互聊天;如果还没下载,会先自动下载:
llama cli -hf ggml-org/Qwen3.5-0.8B-GGUF:Q8_0
进去后输入问题回车即可。界面会列出可用命令:/exit 退出,/regen 重新生成,/clear 清空历史,/read <file> 把一个文本文件加进对话。
只想问一句就退出,用 -st(单轮)加 -p(提示词)。这种写法也方便放进脚本:
llama cli -hf ggml-org/Qwen3.5-0.8B-GGUF:Q8_0 -st -rea off \
-p "用一句话解释什么是 GGUF 文件。"
对照结果(2026-10-27 实测,节选;模型输出每次会不同):
model : ggml-org/Qwen3.5-0.8B-GGUF:Q8_0
ftype : Q8_0
modalities : text
> 用一句话解释什么是 GGUF 文件。
GGUF 文件是一种压缩的量化模型量化文件,它通过降低模型参数量、
使用特定量化方式(如 FP16/INT8)以及高效的压缩技术(如 GPTQ)
来极大提高训练和推理速度。
[ Prompt: 189.0 t/s | Generation: 36.2 t/s ]
最后一行是速度:Prompt 是读入提示词的速度,Generation 是生成速度,单位都是每秒 token 数。
注意这个回答是错的:GGUF 是 llama.cpp 的模型文件格式,和 GPTQ 无关,也不能提高训练速度。0.8B 的小模型适合练手、做格式化和简单分类,事实性问题容易编造。要认真用,请按内存换更大的模型。
第 4 步:系统提示词、采样参数和思考开关
-sys 设系统提示词,--temp 等参数控制随机性:
llama cli -hf ggml-org/Qwen3.5-0.8B-GGUF:Q8_0 -st -rea off \
--temp 0.2 -sys "你是简洁的助手,只用要点回答。" \
-p "本地跑大模型前要先看哪 3 个硬件指标?"
对照结果(2026-10-27 实测,节选):
1. **显存 (VRAM)**:需满足模型推理/训练所需显存容量……
2. **算力 (GPU 核心数/显存)**:需匹配模型架构……
3. **内存 (RAM)**:需满足模型加载与上下文窗口大小需求……
[ Prompt: 183.4 t/s | Generation: 53.7 t/s ]
官方 CLI 文档列出的常用采样参数和默认值:
| 参数 | 作用 |
|---|---|
--temp N | 随机性,默认 0.8,越低越稳定 |
--top-k N | 只从概率最高的 K 个 token 里选,默认 40 |
--top-p N | 核采样概率阈值,默认 0.95 |
--min-p N | 丢掉相对概率低于该值的 token,默认 0.05 |
-n N | 最多生成多少 token,默认 -1 不限 |
不设时 llama.cpp 会按模型给出合理默认值。
-rea off 是什么:Qwen 3.5、Gemma 4 这类模型会先输出一段思考过程再回答。-rea off 关掉思考,回答更快;想保留思考但限制长度,用 --reasoning-budget 1024。第 2 课会看到不关思考时 API 返回的样子。
第 5 步:上下文和内存
两个和内存有关的参数:
# 指定上下文长度(0 表示用模型支持的最大值)
llama cli -m model.gguf -c 16384
# 大 MoE 模型配小显卡时,把专家权重留在 CPU 上
llama cli -m model.gguf -cmoe
官方文档说明,llama.cpp 默认会按可用内存自动调整没设置的参数(--fit on),所以启动时很少因为内存不够而失败。--list-devices 可以查看本机有哪些 GPU,-dev 指定用哪块。
已经有 .gguf 文件的,用 -m 文件路径 代替 -hf 仓库名。
用桌面 App 的话
本节按官方 Quickstart 描述,未在 Linux 云主机上实测。Mac 和 Windows 上打开 Llama App,在「Recommended for this Mac / PC」里点模型旁边的下载箭头。下载完点这个模型,按内存和需要的对话长度选上下文窗口,再点「Chat with the model」开始聊天。App 下载的模型和命令行共用同一个缓存,llama cli -cl 也能看到。
小结
- 一行脚本装好
llama,llama cli --version确认; - 按内存在 https://llama.app/models 挑模型,
仓库:量化指定文件; llama cli -st -p适合单问一句,-sys、--temp、-rea off是最常用的三个参数。
下一课用 llama serve 把模型变成 OpenAI 兼容的本地 API。
