Open Interpreter 安装与上手指南
【免费下载链接】openinterpreterA coding agent for open models like Kimi K3 and GLM 5.3项目地址: https://gitcode.com/GitHub_Trending/op/openinterpreter
Open Interpreter 是一个面向低成本模型的终端编码代理(coding agent):你在命令行里用一句自然语言描述任务,它就能读取项目、修改代码、执行命令。本文带你完成 Open Interpreter 安装,并跑通第一个真实编码任务,装好后你直接可以拿它给一个目录写 README、解释一段陌生代码,或在沙箱里运行修复脚本。
🧭 安装前:环境自检清单
先花一分钟确认本机条件,不满足时按括号里的方向处理即可,能少走很多弯路。
- 操作系统:支持 macOS、Linux、Windows;Windows 建议用原生 PowerShell,需要 Linux 风格沙箱时改用 WSL。
- 网络:安装脚本需访问 openinterpreter.com,运行时要能连通你的模型提供商(国内网络需配好代理)。
- 模型来源:准备一个 API Key,或本地起好 Ollama / LM Studio 供
--oss调用。 - Git:非必须,但涉及仓库会话、diff、代码评审时建议先装好。
- 执行策略(仅 Windows):若
irm ... | iex报"禁止运行脚本",说明执行策略是 Restricted,见下文速查表处理。
自检项和平台要求可对照 docs/install.md 与 docs/windows.md 查看。
🚀 脚本快速安装(PowerShell 一键)
适合绝大多数人。安装脚本会自动下载匹配你平台的发行版,并搭好后续自更新所需的独立安装布局,全程无需手动配置依赖。
在 Windows PowerShell 中执行这条命令,它会拉取 Windows 发行版并写入用户 PATH:
irm https://www.openinterpreter.com/install.ps1 | iexmacOS 或 Linux 用户改用这一条(两者都是"下载正确平台包 + 安装到管理目录"):
curl -fsSL https://www.openinterpreter.com/install | sh装完务必重开一个终端,再运行下面这条确认二进制可用、能打印版本号:
interpreter --version看到版本号输出,说明安装成功。之后日常升级直接跑interpreter update即可。
源码手动安装(clone 后构建)
只有当你需要定制构建、跟仓库一起开发时才走这条路;它依赖 Rust 工具链,普通使用上面一步就够了。克隆仓库,拿到最新源码:
git clone https://gitcode.com/GitHub_Trending/op/openinterpreter进入目录后运行仓库自带的发布脚本。不要用临时的cargo build代替——脚本会构建并打包与线上安装器一致的完整布局,包含入口、捆绑资源和平台辅助文件:
cd openinterpreter ./scripts/build-interpreter-release.sh构建产物即与脚本安装得到的二进制等价,可直接运行验证。
🎯 跑通第一个任务
现在进入你实际的项目目录,启动一次交互会话(interpreter或别名i都可以):
interpreter首次启动会引导你选择模型提供商并填入 API Key;若打算用本地模型,也可在这一步选本地端点。随后给一句真实任务,例如"给当前目录写一个 README",或"Find and fix a bug in main.py"。它不会立刻动手:会先列出计划,再逐条请求执行命令或写文件,你确认后才落地。看到文件被创建、命令有返回输出,就说明整条链路通了。
下面是它在终端里执行任务的真实画面:底部显示当前模型与推理档位,上方是它的计划与执行进度。
会话内随时可以用/model切换提供商和模型、用/harness切换模型行为档位,无需退出重进。
📋 高频问题速查
只收录最常被问到的几条,先对照再排查:
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
'interpreter' 不是内部或外部命令 | 新装的 PATH 未生效 | 重开一个 PowerShell 再试;仍不行用完整路径定位 |
| 脚本报"在此系统上禁止运行脚本" | PowerShell 执行策略为 Restricted | Set-ExecutionPolicy RemoteSigned -Scope CurrentUser后重试,或改用 WSL |
| 进入后连不上模型 / 无响应 | 未配置 API Key,或代理未开 | 用/model选提供商并填 Key;国内网络先配代理 |
| Windows 下沙箱行为与预期不同 | 原生 Windows 沙箱与 Linux 规则不同 | 需要 Linux 风格沙箱时改用 WSL 安装 |
⚙️ 按需调整配置:模型、Harness 与推理强度
只挑三个最影响体验的项,其余保持默认即可。
模型与推理强度:推理强度决定它思考的深度,取值从minimal(快速小改)到high/xhigh(复杂调试、重构、评审)。可以在 TUI 里用/model调整,或写进配置(TOML,位于~/.openinterpreter):
model_provider = "moonshotai" model = "kimi-k3" model_reasoning_effort = "medium"Harness(模型行为档位):不同模型有不同的最佳提示与工具面,用/harness切换,或在配置里写harness = "kimi-code";不设置时它会按所选模型自动推断,详见 docs/harness.md。
本地模型(可选,合并成一条命令即可,注释里区分用途):先在本机起好服务,再用下面这条让 Open Interpreter 直连本地端点;ollama换成lmstudio即指向 LM Studio,远程服务可用CODEX_OSS_BASE_URL覆盖地址:
interpreter --oss --local-provider ollama模型列表、各提供商可用的模型 ID 与推理控制形态,参考 docs/models.md。
下一步
由浅入深,建议按这个顺序走:
- 用
interpreter exec跑一次非交互任务,体验批处理与脚本化调用。 - 阅读 docs/windows.md 了解 Windows 下的路径与沙箱细节,或切到 WSL 获得 Linux 风格行为。
- 尝试内置技能与 MCP,让它在你的编辑器(ACP)里作为代理运行,把它接进现有工作流。
装好后先在可信的本地仓库里练手,确认任务行为符合预期,再逐步放开权限。
【免费下载链接】openinterpreterA coding agent for open models like Kimi K3 and GLM 5.3项目地址: https://gitcode.com/GitHub_Trending/op/openinterpreter
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考