☰
Open Interpreter 安装与上手指南
2026/10/2 2:09:37 网站建设 项目流程

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 | iex

macOS 或 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 执行策略为 RestrictedSet-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。

下一步

由浅入深,建议按这个顺序走:

  1. 用interpreter exec跑一次非交互任务,体验批处理与脚本化调用。
  2. 阅读 docs/windows.md 了解 Windows 下的路径与沙箱细节,或切到 WSL 获得 Linux 风格行为。
  3. 尝试内置技能与 MCP,让它在你的编辑器(ACP)里作为代理运行,把它接进现有工作流。

装好后先在可信的本地仓库里练手,确认任务行为符合预期,再逐步放开权限。

【免费下载链接】openinterpreterA coding agent for open models like Kimi K3 and GLM 5.3项目地址: https://gitcode.com/GitHub_Trending/op/openinterpreter

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询