跳转到正文
Onevium文档
本页内容

配置并验证 1M 上下文窗口

确认模型和账户支持长上下文,再设置全局开关与模型能力,并用新会话验证实际窗口。

先确认模型支持,再打开长上下文#

1M 上下文用于一次请求需要容纳更多历史或材料的任务。它不是让所有模型都拥有更大窗口的开关,也不保证回复一定更好或成本不变。

Onevium 需要同时知道:这个连接中的模型是否支持 1M,以及你是否希望启用它。从 1.2.2 开始,OpenAI Responses、Chat Completions 和 Gemini 连接可以通过界面中的模型能力与全局开关联动,一般不必为此复制一个带 [1m] 后缀的模型条目。

开始之前#

  • 向提供商确认具体模型、接口和账户套餐支持至少 1M token;同名模型经由另一个网关时,能力可能不同。
  • 先让连接成功回复一条短消息。连接方法见服务商与模型及自定义服务商。
  • 在提供商条目中核对连接类型,不要为开启长上下文而更换协议。

不同连接分别在哪里设置#

连接类型要核对的设置
官方 Anthropic / Claude Code 登录使用账户可用的模型;需要长上下文选项时,到 Claude Code 设置检查全局 1M 上下文窗口
自定义 Anthropic Messages 兼容接口提供商编辑 → 高级选项 → 接口支持 1M 上下文,以及全局 1M 上下文窗口;只在供方确认支持时开启
OpenAI Responses、Chat Completions、Google Gemini管理模型 → 对应模型的高级字段 → 确认此模型支持 1M,以及全局 1M 上下文窗口
内置兼容服务预设的专用长上下文条目保留预设的模型映射,并核对具体模型和套餐;名字带 (1M) 不能代替供方授权

已知官方端点的模型能力可由内置资料识别;自定义网关或未识别的模型,需要你在核实后明确确认。填写一个较大的窗口数字,不能代替接口实际支持。

配置 OpenAI 或 Gemini 类型的连接#

  1. 打开设置 → AI 服务,找到已连接的服务,进入管理模型。
  2. 找到要使用的模型,核对它已启用,展开该行的高级。
  3. 对已经向供方确认支持、但应用无法自动识别的模型,开启确认此模型支持 1M。窗口不足 1M 或套餐不支持的模型保持关闭。
  4. 点击保存。再到 Claude Code 设置打开全局 1M 上下文窗口。
  5. 新建测试会话,选择刚才的提供商与模型,按下方步骤验证。

模型 ID和上游模型 ID继续使用连接所需的真实标识。当前流程会在适用时处理内部长上下文标记,不需要把 [1m] 填进供方的上游模型 ID。

从旧版升级时,如果曾手动建立带 [1m] 的重复条目,先用原模型按上述流程验证成功,再决定是否停用重复条目。不要为了清理菜单而先删除仍被会话或自动化使用的模型。

角色映射和子任务也要核对#

主会话的模型、Claude Code 角色映射、AI 创建的子会话,是相关但不同的选择。

  • 角色映射: 编辑提供商,在高级选项的模型映射中核对 Fable、Opus、Sonnet、Haiku 和 Subagent。1.2.2 的 OpenAI Responses、Chat Completions 和 Gemini 连接也可编辑这些映射,选项来自同一提供商内已启用的模型。新连接先保存并配置模型,再回来设置。
  • 每个模型的能力: 角色映射不会把 1M 能力复制给另一个模型。一个角色改用较小窗口的模型后,应按那个模型的能力处理。
  • 真实子会话: 创建后打开成员,检查它实际选择的模型与窗口。主会话验证成功不能证明所有成员使用相同预算。

Anthropic 兼容连接的角色字段和额外环境变量有自己的映射规则,见自定义服务商。

验证窗口与真实回复#

  1. 新建会话并选择目标模型,发送 /context,查看实际总窗口。
  2. 对按本教程启用 1M 的模型,确认窗口已体现长上下文配置;不要只看管理模型里的数字。
  3. 发送“只回复:已收到”,检查模型可以正常回复。
  4. 使用角色映射或子会话时,再分别核对它们的实际模型与 /context 结果。

/context 验证会话采用的预算,短回复验证基础请求成功;两者都不能单独证明供方能接受接近上限的长请求。真实任务仍受账户、限流、工具能力和服务端约束。

常见问题#

现象先检查
窗口仍显示约 200K全局 1M 开关、所选模型的支持状态,以及是否在新建的测试会话中选择了正确条目
官方模型可用,同名网关模型不生效两个端点不一定有相同能力;向网关确认后,在它自己的模型条目中设置
服务返回未知模型上游 ID 是否正确,是否误加 [1m],以及当前账号是否能使用该模型
主会话正常,子任务失败检查对应角色是否映射到同一提供商内可用且已启用的模型
找不到逐模型确认或原生协议角色映射核对安装版本;本文流程要求 1.2.2 或更新版本
更换连接类型后报协议错误恢复为供方支持的接口类型;长上下文设置不需要改协议

下一步#

回到服务商与模型管理可用条目,或用自定义连接接入团队网关。需要调整默认推理力度时,在对应提供商的模型配置中设置。