llama.vscode

环境要求

• 已安装 VS Code（扩展本体运行在 VS Code 中）
• macOS 需已安装 Homebrew；Windows 需 Windows Package Manager (winget)
• Linux 需自行下载 llama.cpp 最新二进制并把其 bin 目录加入 PATH
• 一台能运行 llama.cpp 的本地机器（低端硬件也可，扩展支持智能上下文复用）

安装与启动步骤

1. 1安装 VS Code 扩展

   从 VS Code 扩展市场安装 llama-vscode（扩展 ID 为 ggml-org.llama-vscode），也可在 Open VSX 获取；安装后无需其他依赖即可在编辑器中使用。

   code --install-extension ggml-org.llama-vscode

   复制

2. 2安装 llama.cpp

   启动 llama-vscode 后会自动安装 llama.cpp（Mac 走 brew，Windows 走 winget）。也可点状态栏的 llama-vscode 或按 Ctrl+Shift+M 打开菜单，选择 Install/Upgra

3. 3Linux 用户装 llama.cpp

   Linux 不自动安装：从 llama.cpp 官方 releases 下载最新二进制，解压后把其中的 bin 目录加入系统 PATH，确保命令行可调用。

4. 4选择环境 Env

   在 llama-vscode 菜单中选 Select/start env...，选中一个包含模型的环境（Env 是一组模型，选中/取消会同时启用其中所有模型）。

5. 5打开 Llama Agent

   按 Ctrl+Shift+A 或从 llama-vscode 菜单选 Show Llama Agent 打开智能体视图，前提是已为 Agent 选择好 Env。

6. 6发起对话/补全

   在 Agent 中写查询，需要时可点 @ 按钮附加文件；在编辑器里正常输入即可触发补全建议。

关键配置

如何确认成功

状态栏出现 llama-vscode 图标；按 Ctrl+L 能手动触发补全建议；Ctrl+Shift+A 能打开 Llama Agent 并正常返回结果。

常见问题

注意事项

• 详情与更多用法见项目 wiki：https://github.com/ggml-org/llama.vscode/wiki
• 扩展还支持 Deep Link，如 vscode://ggml-org.llama-vscode?view=agent&prompt=Hello 可直接打开 Agent 并带入提示词
• 可通过扩展菜单导出/导入模型与 Env，便于在多台机器间复用配置