设置模型
模型
管理 LLM Profile:API Type、Base URL、API Key 等通用字段,以及不同供应商的配置方式。
模型设置用于管理可用模型和调用方式。建议为不同任务复杂度创建多个 LLM Profile,按需快速切换。
通用字段
无论使用哪个供应商,LLM Profile 的核心字段都是相同的:
| 字段 | 说明 |
|---|---|
| API Type | 协议类型:Anthropic / OpenAI Chat Completions / OpenAI Responses API |
| Model | 供应商侧的模型 ID |
| Base URL | API 入口地址(OpenAI 协议常以 /v1 结尾) |
| API Key | 用于鉴权的密钥 |
| Effort | 推理强度(仅 OpenAI Responses API 支持,常见取值 Medium / High / XHigh) |
| Thinking | 思考模式(Anthropic 系列模型支持,常用 Adaptive) |
| Support Vision | 是否启用多模态输入 |
| Tool Streaming | 是否启用工具调用的流式输出 |
修改模型后,建议先用一个小任务验证连通性和输出质量,再用于长任务。
选择供应商
按你使用的接入方式选择对应文档:
| 供应商 | 适用场景 |
|---|---|
| NorthGate | 推荐入口。统一网关,覆盖自研模型 Nex-N2-Pro、Anthropic Claude、OpenAI GPT。 |
| OpenAI 官方 | 直接使用 OpenAI 官方 API(含 Responses API / Chat Completions)。 |
| Anthropic 官方 | 直接使用 Anthropic 官方 Messages API。 |
| OpenRouter | 通过 OpenRouter 接入主流模型,支持 OpenAI 协议或 Anthropic 协议。 |
如果你不确定选哪个,从 NorthGate 开始,它在同一个 Base URL 下覆盖了三大类模型,切换最简单。
多 Profile 策略
建议同时保留几个 LLM Profile,按场景切换:
- 快模型(如 Nex-N2-Pro):用于子 Agent、压缩、简单问答。
- 强模型(如 Claude Opus、GPT High/XHigh):用于复杂实现、RFC 设计、跨文件重构。
- 代码补丁模型(OpenAI GPT 系列):搭配 Codex Agent Profile 使用
apply_patch。
切换 Agent Profile 时如果绑定了默认模型,会自动跟随,不必每次手动切换。详见 Agent 配置。