1Panel 企业版 AI 编程接入指南：通过 AI 网关统一接入 OpenCode、Qwen Code、Codex 等工具

1Panel 企业版「AI 编程接入指南」围绕 1Panel AI 网关的 OpenAI 兼容接口，说明 OpenCode、Qwen Code、Codex 以及 Cursor、Continue、Cline、Aider 等 AI 编程工具的接入方式。

按照指南，大多数 AI 编程工具只要支持 OpenAI 兼容接口，就可以接入 1Panel AI 网关。接入时主要填写 Base URL、API Key 和 Model 三个参数，其中 Model 需要填写 AI 网关模型映射中的请求模型名称。

▲ AI 编程工具接入 1Panel AI 网关示意图

统一接入参数

• Base URL：填写 AI 网关的外部访问地址，通常格式为 http://<服务器 IP>:<端口>/v1。
• API Key：填写 AI 网关中创建的 API Key。
• Model：填写 AI 网关模型映射中的请求模型名称，例如 qwen3-coder。

Model 不一定是上游模型的真实名称。客户端请求的模型名称需要先在 AI -> AI 网关 -> 模型池 中完成映射，再由网关转发到实际模型。指南建议先通过 /v1/chat/completions 请求确认 AI 网关可以正常访问。

已覆盖的工具配置

• OpenCode：支持在配置文件中自定义 Provider，并通过 baseURL 指向自定义 OpenAI 兼容接口；启动后通过 /connect 配置 API Key，并通过 /models 选择模型。
• Qwen Code：支持 OpenAI 兼容协议，可以在 ~/.qwen/settings.json 中通过 modelProviders.openai 配置自定义服务地址；API Key 建议写入 ~/.qwen/.env。
• Codex：支持通过 config.toml 配置模型供应商；接入 AI 网关时，建议写入用户级配置文件 ~/.codex/config.toml。
• 其他工具：Cursor、Continue、Cline、Aider 等工具如果支持 OpenAI 兼容接口，一般可配置 OpenAI Base URL 或 API Base、API Key 和 Model。

常见问题排查

• 返回 401 或 API Key 无效时，检查 API Key 是否填写正确、绑定的用户组是否启用，以及请求头是否为 Authorization: Bearer <API Key>。
• 返回 model not found 时，检查客户端填写的模型名称是否等于 AI 网关模型映射中的请求模型名称。
• 连接失败或返回 404 时，检查 Base URL 是否包含 /v1，以及 AI 网关服务、监听端口、防火墙和外部访问地址是否配置正确。
• 工具调用或代码编辑失败时，优先选择支持 tool calling / function calling 的编程模型，例如 Qwen Coder、DeepSeek Coder 等。
• 流式输出中断或请求超时时，检查 AI 网关设置中的最大并发、队列等待超时、非流式请求超时和流式空闲超时，并结合 AI 网关日志、用量统计排查上游模型响应情况。

完整配置示例可查看 1Panel 文档：AI 编程接入指南。