注册
教程中心 / LM Panel 教程

LM Panel 教程

LM Panel 本地大模型管理面板:安装配置、模型管理、多模型网关、Agent 接入与故障排查,从入门到进阶

08 · 接入 Agent 工具

LM Panel 教程 更新于 2026-10-10 16:46:00

网关兼容 OpenAI 接口,把本地模型接进 Claude Code / Codex / Gemini CLI / OpenCode 等工具,一键同步 base URL。

原理

Agent 工具通常支持通过环境变量或配置文件指定 OpenAI 兼容的 API 地址。LMPanel 网关正好提供:

  • 地址:http://127.0.0.1:8199
  • 协议:OpenAI 兼容(/v1/chat/completions、/v1/models)
  • 模型名:config 中定义的模型名称

所以接入 = 把工具的 base URL 指向网关 + 指定模型名。

演示图占位
此处放:网关页一键同步
说明:将网关地址写入已支持 Agent 工具配置

通用接入步骤

  1. 在 LMPanel 网关页,点击 一键同步(自动写入已支持工具的配置)
  2. 或手动配置:
工具 配置位置 要填的值
Claude Code claude 配置中的 API base URL http://127.0.0.1:8199
Codex Codex 配置 同上
Gemini CLI Gemini CLI 配置 同上
OpenCode OpenCode 配置 同上
  1. 设置模型名(default model)为你的模型名称,例如 qwen3-8b
  2. 如果网关开启了 API Key,把密钥填进工具的 API Key 字段
演示图占位
此处放:Agent 工具配置示例
说明:base URL 指向 http://127.0.0.1:8199 并指定模型名

命令行验证

不依赖任何工具,先用 curl 验证网关可用:

curl http://127.0.0.1:8199/v1/chat/completions 
  -H "Content-Type: application/json" 
  -d '{
    "model": "你的模型名",
    "messages": [{ "role": "user", "content": "你好" }]
  }'

返回 JSON 中 choices[0].message.content 即模型回复。

多模型切换

在工具中随时切换模型:

  • 工具允许指定 model 时,填入不同模型名称即可(如从 qwen3-8b 换 llama3-8b)
  • 网关按 model 字段自动路由并热切换

鉴权模式

  • 网关未开鉴权:工具配置中可不填 API Key(仅限本机)
  • 网关开启鉴权:工具中填网关密钥

常见问题

现象 处理
工具报连接失败 确认 LMPanel 在运行、网关地址未写错、防火墙放行
工具报模型不存在 模型名与 config 中的名称一致(含大小写)
请求超时 模型冷启动需要时间,先手动在模型页启动一次
工具不支持自定义 base URL 检查该工具文档,多数支持环境变量方式

下一步

  • 网关配置细节 → 06 · 全局网关
  • 配置文件与模型定义 → 10 · 配置详解
已是最后一篇 →
TOP