网关兼容 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 工具配置
通用接入步骤
- 在 LMPanel 网关页,点击 一键同步(自动写入已支持工具的配置)
- 或手动配置:
| 工具 | 配置位置 | 要填的值 |
|---|---|---|
| Claude Code | claude 配置中的 API base URL |
http://127.0.0.1:8199 |
| Codex | Codex 配置 | 同上 |
| Gemini CLI | Gemini CLI 配置 | 同上 |
| OpenCode | OpenCode 配置 | 同上 |
- 设置模型名(default model)为你的模型名称,例如
qwen3-8b - 如果网关开启了 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 · 配置详解