Open Interpreter：终端里的低成本模型编码 Agent｜安装与 Harness 切换指南

仓库：https://github.com/OpenInterpreter/OpenInterpreter 官方文档：https://www.openinterpreter.com/docs/terminal 许可证：Apache-2.0 运行形态：终端 CLI（i / interpreter），无 Web 端口

1. 项目简介

Open Interpreter 是一个面向低成本模型优化的终端编码 Agent。当前版本用 Rust 重写，基于 OpenAI Codex harness，目标是把各家模型的"推荐 harness"（Kimi Code、Claude Code、DeepSeek TUI 等）都模拟出来，让你在同一个 TUI 里跑不同模型。

1.1 核心信息一览

1.2 适用场景

• 想在终端里跑编码 Agent，又不想被单一厂商锁定；
• 想用低成本模型（Kimi、DeepSeek、Qwen、GLM 等）跑出接近旗舰模型的效果；
• 想在支持 ACP 的编辑器里把它当后端 agent；
• 已经在用 OpenAI Codex SDK，想一行切换到 interpreter 二进制。

1.3 能力边界（官方口径）

• 这是新的 Rust 版本，基于 Codex；原版 Python 项目由社区 fork endolith/open-interpreter 维护；
• 内置 QA skill 可以驱动浏览器（agent-browser）或原生应用（trycua），但需要相应依赖；
• 产品化数据尽量走共享标准（AGENTS.md、.agents/skills、MCP、ACP），产品自身配置只放在 ~/.openinterpreter。

2. 功能特性

• 原生沙箱：在 macOS / Linux / Windows 上以原生沙箱执行命令；
• Harness 模拟：/harness 在 10 种 harness 之间切换（native、claude-code、claude-code-bare、zcode、kimi-code、kimi-cli、qwen-code、deepseek-tui、swe-agent、minimal）；
• 多 Provider：TUI 里 /model 切换 provider 与模型；interpreter --chat-completions 走任意 OpenAI 兼容端点；
• ACP 兼容：interpreter acp 作为 ACP agent 给编辑器用；
• Codex SDK 兼容：一行 codexPathOverride: "interpreter" 即可替换；
• 可移植目录：复用 AGENTS.md、共享 .agents/skills、MCP，不锁产品格式；
• Computer Use：内置 QA skill 操作浏览器与原生 App。

3. 官方界面预览

官方 README 顶部 hero 图，展示 Open Interpreter 在终端中运行的样子。

4. 官方跳转链接汇总

• 仓库主页：https://github.com/OpenInterpreter/OpenInterpreter
• 文档首页：https://www.openinterpreter.com/docs/terminal
• Quickstart：https://www.openinterpreter.com/docs/terminal/quickstart
• 安装指南：https://www.openinterpreter.com/docs/terminal/install
• 配置：https://www.openinterpreter.com/docs/terminal/config
• CLI 参考：https://www.openinterpreter.com/docs/terminal/cli-reference
• Harness 列表：https://www.openinterpreter.com/docs/terminal/harness
• Provider 指南：https://www.openinterpreter.com/docs/terminal/providers
• ACP 指南：https://www.openinterpreter.com/docs/terminal/acp
• 社区 fork（旧 Python 版）：https://github.com/endolith/open-interpreter

5. 前置要求与服务器配置

• macOS / Linux / Windows 任一桌面系统；
• 一个或多个模型 Provider 凭据（Kimi、DeepSeek、OpenAI、Anthropic、Z.AI/GLM 等）；
• 无 GPU 要求、无端口、无数据库；
• Windows 用 PowerShell 执行安装脚本。

6. 方式一：一键脚本安装（官方推荐）

macOS / Linux：

curl -fsSL https://www.openinterpreter.com/install | sh

Windows（PowerShell）：

irm https://www.openinterpreter.com/install.ps1 | iex

安装完成后，在终端输入：

i
# 或
interpreter

进入 TUI。在 TUI 内：

> /harness        # 切换 harness
> /model          # 切换模型 / provider

7. 方式二：源码 / 本地运行

官方 README 提供了脚本入口但未给完整源码构建步骤；从仓库构建需要 Rust 工具链。开发者可参考仓库根目录的 scripts/ 与 docs/。

想在已经基于 OpenAI Codex SDK 的项目里接入：

-const codex = new Codex();
+const codex = new Codex({ codexPathOverride: "interpreter" });

想在 ACP 编辑器里使用：配置客户端启动 interpreter acp，见 ACP 指南。

8. 配置项说明

Provider 凭据通过官方文档里各 provider 页面配置（Kimi K3、DeepSeek、Z.AI/GLM 等）。

9. 常用运维命令

# 启动 TUI
i
interpreter

# 以 exec 模式跑一次性任务
interpreter exec --chat-completions "写一个快速排序"

# 以 ACP 模式给编辑器
interpreter acp

# 重新生成 provider catalog（开发者用）
python3 scripts/write_provider_catalog.py

# 本地兼容性检查
scripts/test-codex-sdk-compat.sh

10. 常见故障排查

• 安装脚本被网络拦：手动从 GitHub releases 下载二进制；
• 模型连不上：先 /model 检查 provider 与 base_url，再用 --chat-completions 指向 OpenAI 兼容端点；
• harness 切换后行为异常：回到 native 或 minimal harness 对比；
• Windows 策略禁止 ps1：PowerShell 管理员执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser；
• 想找旧 Python 版：见 endolith/open-interpreter fork。

11. 风险与合规说明

• Apache-2.0 许可；
• Agent 会在沙箱内执行命令，建议在隔离环境 / 容器中运行不信任任务；
• 各模型 Provider 账号产生的费用由你承担；
• 本文为社区部署笔记，命令以官方文档与仓库 README 最新版本为准。