Open Interpreter 本地会话提速实战:快速模式、上下文精简与工具链配置指南
会话「慢」通常不是某一处的问题,而是由模型选择、上下文大小与工具设置三者共同决定的。本指南基于 docs/zh/speed.md 展开,结合本仓库(op/openinterpreter)中的配置文档与 Rust 源码,系统讲解如何在不隐藏安全审查、不牺牲重要检查的前提下提升交互速度:包括一键快速模式(/fast)、把低推理预算固化为默认配置文件、保持上下文紧凑的四个日常习惯(@ 精确引用、/compact、AGENTS.md、技能按需加载),以及让构建/测试命令随手可跑的工具组织方式。读完即可在终端里直接套用。
速度的三个决定因素
Open Interpreter 一次会话的响应速度,几乎可以收敛到三个变量上:
- 模型选择:不同模型的推理速度与延迟差异巨大,包括选对口径的模型(如大模型负责复杂任务、小模型负责高频简单任务)。
- 上下文大小:发送给模型的 token 越多,每次「思考」的开销越大;冗余历史与重复指令都会累积成明显延迟。
- 工具设置:低效的构建/测试调用、可复用的重复流程反复加载,都会拖慢一次完整任务闭环。
/status 命令会显示模型、提供商、沙箱、批准情况、令牌使用以及会话状态,是排查「慢在哪一步」的起点;/debug-config 则打印已解析的配置及其来源,帮助确认当前生效的设置到底来自哪里。
快速模式:/fast 与持久化配置
单次会话:输入 /fast
在支持的服务层级(service tier)可用的前提下,直接在 TUI 中输入 /fast,即可为当前会话切换到最快的服务层级。这与「降低推理强度」是两条互补的提速通道——/fast 解决的是服务端排队与算力分配,而推理强度(reasoning effort)决定模型在单轮里「想多深」。
在底层,/fast 与推理强度控制都体现在配置模型中。codex-rs/config/src/profile_toml.rs 中,每个具名 profile(配置组)可同时承载 service_tier、model_reasoning_effort 等字段,其中 service_tier 的取值如 default、priority、flex,且旧版 fast 仍然兼容可用(见 profile_toml.rs 的字段注释)。
持久化:写入 [profiles.fast]
/fast 只对当前会话生效。若要「每天默认都快」,把低推理预算写进配置文件:
[profiles.fast]
model_reasoning_effort = "low"
Open Interpreter 从 TOML 文件读取持久化设置(参见 docs/zh/config.md),用户级配置位于:
~/.openinterpreter/config.toml
受信任项目内还可以放项目级配置:
.openinterpreter/config.toml
之后通过 --profile 显式启用该配置组:
interpreter --profile fast
model_reasoning_effort 可选值在仓库中明确定义为 minimal、low、medium、high、xhigh 五档——ReasoningEffort 枚举定义于 codex-rs/protocol/src/openai_models.rs,其字符串序列化/解析值见同文件 L59-L63 与 L130-L134。文档与配置示例中的常见档位有:
| 档位 | 含义 |
|---|---|
low |
低推理预算,日常快速模式常用(见 [profiles.fast]) |
medium |
默认档 |
high |
高推理预算,适合代码审查等任务(见 [profiles.review]) |
这种「快速组 / 审查组」的多 profile 组合用法在本仓库文档中也有体现:在 docs/zh/config.md 中,[profiles.fast] 使用小模型 + model_reasoning_effort = "low",而 [profiles.review] 使用完整模型 + model_reasoning_effort = "high" + sandbox_mode = "read-only",同一会话内切档非常自然。
一次性的 CLI 覆盖
不需要改配置文件的临时调速,可用 -c 传 TOML 风格的值(字符串务必加引号防止 shell 吞掉):
interpreter -c model_reasoning_effort='"low"'
配置的最终生效值按优先级从低到高合并:内置默认值 → 系统或托管配置 → 用户配置 → 受信任项目配置 → 已选 profile → -c/--enable/--disable 等 CLI 覆盖(见 docs/zh/config.md)。
值得留意的是,TUI 中还提供了可交互切换的控制点:配置源码里存在 toggle_fast_mode、increase_reasoning_effort、decrease_reasoning_effort 等键位项(见 codex-rs/config/src/tui_keymap.rs),状态栏也有专门的 effort 显示逻辑,意味着你可以在不重启会话的情况下实时微调推理强度。
保持上下文紧凑:四个日常习惯
上下文膨胀是「越聊越慢」最常见的元凶。每次请求都会携带整段会话历史,因此发送越少无关 token,响应越快。以下四条来自官方文档的实践可以组合使用:
1. 用 @ 只提及相关文件
对话中通过 @ 精确选择与当前任务相关的文件,而不是让模型「扫描整个仓库」,避免把无关内容塞进上下文。在命令层面,/mention 可将文件显式加入对话,与 @ 互为补充(见 docs/zh/slash_commands.md)。
2. 用 /compact 压缩冗长会话
当会话已经很长、大量历史已无检索价值时,执行 /compact 会把旧上下文汇总为摘要、释放空间(docs/zh/slash_commands.md)。本仓库对压缩行为有着相当完备的工程约束:核心测试套件 codex-rs/core/tests/suite/compact.rs 覆盖了手动压缩、回合中压缩、超限触发压缩、切换模型前压缩等多种路径,并伴随大量 snapshot(如 codex-rs/core/tests/suite/snapshots/ 下 all__suite__compact__* 系列),保证「摘要旧上下文」不会丢失关键信息——这也印证了「在不隐藏重要检查的情况下提速」的设计原则。
如果只是想让「眼前干净」,/clear 可以清空可见对话记录而不影响底层会话状态;/new、/fork 则分别用于开新会话与分支,都是避免历史无限累积的轻量手段。
3. 把持久规则放进 AGENTS.md,而不是每条提示
反复把仓库约定粘贴进每一条 prompt,等于让每个 token 请求都重复付费。正确做法是把跨会话长期有效的项目规则沉淀进 AGENTS.md:Open Interpreter 会按「全局 ~/.openinterpreter/AGENTS.md」与「项目级 AGENTS.md」两级自动加载,/init 命令还能基于仓库现状起草一份初始版本,随后手工编辑为长期规则即可(见 docs/zh/agents_md.md)。规则的基本原则是:简短、具体、持久,临时任务细节留在提示中,项目说明只放稳定内容。本仓库根目录的 AGENTS.md 就是一份实际范本。
4. 把可重复流程做成技能(Skills),按需加载
技能(skills)是「仅在需要时加载」的流程封装——把可复用的工作流(例如某种打包、某种重构范式)做成技能,模型只在任务命中时读取其说明,平时不占用任何上下文预算。会话中用 /skills 检查可用技能、/skills 命令入口可见 docs/zh/slash_commands.md,完整的使用与编写方法参考 docs/zh/skills.md。本仓库 codex-rs/skills/ 目录下内置了大量示例(涵盖 .md、.py、.yaml 等格式),可作为自定义技能的真实参照。
工具设置:让构建与测试随手可跑
自动化 Agent 的速度瓶颈,有时不在模型而在「工具调用的摩擦」:如果每次都要从深层目录摸索构建命令,或在不知道如何构建/测试的仓库里反复试错,单是失败重试就会烧掉大量 token 与时间。
官方文档给出的两条工具原则是:
- 让构建和测试命令可以从仓库根目录轻松运行——例如统一通过
cargo test、just、bazel test等顶层入口触达,避免依赖特定 CWD 的脆弱脚本; - 在
AGENTS.md中记录这些命令——这样每一次新会话、每一个子代理都能直接读到「该仓库如何构建、如何跑测试」,无需重新探索,也不会因猜测而误用命令。
这两条配合前文的 AGENTS.md 习惯,等于把「仓库的开发者体验」同时变成了「Agent 的执行效率」。
小结:一套可立即落地的提速组合
把三块提速手段串成日常工作流:
- 日常编码用低推理预算:将
model_reasoning_effort = "low"固化到~/.openinterpreter/config.toml的[profiles.fast],用interpreter --profile fast启动;重活(如代码审查)切换到[profiles.review]的high档; - 会话中保持克制:
@只带相关文件、历史长了就/compact、想重置就/new; - 把仓库规则写进
AGENTS.md、把重复流程做成技能、把构建/测试命令收敛到仓库根目录并记录在案。
如此,提速不再依赖「关闭安全检查」这类危险手段,而是建立在更快的服务层级、更省的上下文预算和更顺滑的工具调用之上——这与 docs/zh/speed.md 的核心主张完全一致:在不隐藏重要检查的情况下,让本地会话更快。
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0631
MiniCPM5-2BMiniCPM5-2B 是一款面向端侧、本地部署和资源受限场景的 2B 稠密 Transformer,能够达到同尺寸开源模型 SOTA 水平。Markdown00
video-shotcraftAI宣传片skill,使用 Remotion 制作电影级产品视频:提供106 张镜头配方卡和可复用的视频魔板。适用于 Claude Code 与 Codex以及所有其他智能体Markdown00
HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。Python09
DragonOSDragonOS is an operating system developed from scratch using Rust, with Linux compatibility. It is designed for **Serverless** scenarios. 使用Rust从0自研内核,具有Linux兼容性的操作系统,面向云计算Serverless场景而设计。Rust00
Spark-X2.5-1.7BSpark-X2.5-1.7B 旨在让强大的 AI 更加实用、高效且易于获取。这些模型在广泛的日常任务中表现出色,涵盖对话、写作、翻译、推理、编程、工具调用和智能体工作流,并在同等规模的开源模型中取得领先结果。Spark-X2.5 将面向效率的架构与最高 1M tokens 的原生上下文窗口相结合,并支持 200 多种语言。Python00