Open Interpreter 快速上手：从安装到调参的 3 步完整指南
Open Interpreter 快速上手从安装到调参的 3 步完整指南【免费下载链接】openinterpreterA coding agent for open models like Kimi K3项目地址: https://gitcode.com/GitHub_Trending/op/openinterpreterOpen Interpreter 是一个面向 Kimi K3 等低成本开源模型的免费终端编码代理。它能读懂你的代码库、编辑文件、运行命令并审查差异全程在本地终端完成。读完本文你会完成安装、跑通第一个会话并掌握模型、沙箱和权限的常用调参方法。这个工具帮你解决什么如果你习惯用 OpenAI 系模型Open Interpreter 可以看作一个换掉供应商的 Codex它基于 OpenAI Codex 的 Rust 实现但刻意做成提供商无关让低价开源模型Kimi K3、DeepSeek、Qwen甚至本地 Ollama 模型也能获得接近商用代理的效果。它适合这几类场景想让编码代理跑在便宜模型上控制 API 成本想在本地机器上用 Ollama / LM Studio 的开源模型写代码需要一个能接入现有工作流的代理兼容 ACP 协议和 Codex SDK还能复用仓库里的AGENTS.md和.agents/skills目录需要注意它不再是早期那个pip 安装后用自然语言执行 Python的库而是一个独立的终端应用二进制名为interpreter。环境准备与安装一条命令装完系统要求macOS / 64 位 Linux / WindowsPowerShell均可Linux 发行包用 musl 静态构建兼容性较好建议装好 Git仓库感知的会话、差异和审阅功能依赖它macOS / Linuxcurl -fsSL https://www.openinterpreter.com/install | shWindowsirm https://www.openinterpreter.com/install.ps1 | iex安装后重新打开一个终端验证是否成功interpreter --version从源码构建可选如果你要改代码或自己打发布包把仓库克隆下来git clone https://gitcode.com/GitHub_Trending/op/open-interpreter核心实现位于codex-rs/目录中文文档在docs/zh/Python 与 TypeScript SDK 在sdk/。构建发行版包用仓库脚本scripts/build-interpreter-release.sh不要直接用临时cargo build替代因为自更新和安装上下文检测依赖完整的受管包布局。首次运行5 分钟拿到第一个结果在任意项目目录里启动会话i是interpreter的简写cd my-project i第一次运行会引导你选择模型来源可以用 ChatGPT 账号登录、填各家 API 密钥或指向本地的 Ollama / LM Studio。之后随时用/model切换。然后输入一个具体的请求比如add a /health endpoint that returns the build sha它会先读项目、给出工作计划再动手改文件、跑命令。默认的权限姿态是工作区内自由操作越权动作先问你确认用/permissions可以调整。干到一半退出下次这样接着干interpreter resume --last进阶玩法exec、本地模型与编辑器接入非交互模式脚本和 CI 用不需要全屏界面时用interpreter exec跑单任务结果直接打到 stdoutinterpreter exec summarize the changes in the last commit支持从 stdin 读提示interpreter exec -、git diff管道输入加--json输出逐行 JSON 事件方便接进流水线。本地开源模型内置两个本地提供商先启动本地服务再指向它Ollama默认http://localhost:11434/v1LM Studio默认http://localhost:1234/v1interpreter --oss --local-provider ollama服务器在别的机器上就先用环境变量CODEX_OSS_BASE_URL指定完整的/v1地址再加--local-provider启动。切换 Harness不同模型需要不同的外壳harness才能发挥最好效果。/harness可以在 native、claude-code、kimi-code、deepseek-tui、minimal 等之间切换大部分提供商其实会自动选默认值Kimi 用kimi-codeDeepSeek 用claude-code-bare一般不用手动动。接进编辑器和 SDKACP配置编辑器启动interpreter acp即可在支持 Agent Client Protocol 的客户端里用它Codex SDK已用new Codex()的代码只需一行codexPathOverride: interpreter指过来协议完全兼容行为调参常用参数一次讲清配置分三层优先级从低到高内置默认值 → 用户配置~/.openinterpreter/config.toml→ 项目配置.openinterpreter/config.toml仅受信项目→ 命令行-c keyvalue一次性覆盖。在 TUI 里用/debug-config能看到每个值的实际来源。最常用的几个键写在 TOML 里model/model_provider默认模型与提供商如kimi-k3配moonshotaimodel_reasoning_effort推理力度minimal到xhigh简单编辑用 low硬核调试用 highsandbox_moderead-only/workspace-write/danger-full-access控制代理能写多大范围approval_policyuntrusted/on-request/never控制多严格地弹窗确认personality回复风格friendly/pragmatic/none想给不同任务设不同人格可以定义命名配置组再启动[profiles.review] model_reasoning_effort high sandbox_mode read-only然后interpreter --profile review即可。临时改单个值用-c比如interpreter -c modeldeepseek-v4-pro。常见坑与下一步装完找不到命令重新打开终端让 PATH 生效macOS/Linux 的二进制在~/.local/bin下提示Model metadata for ... not found这不是连不上服务器只是本地模型 ID 不在兼容目录里用-m传入服务器暴露的准确 ID 即可切换模型后表现变差换模型会使提示缓存失效直接开新会话/new而不是在同一会话里切更新与卸载interpreter update显式更新卸载命令会保留~/.openinterpreter下的配置和会话数据重装修复时不丢东西想继续深入建议按这个顺序读仓库里的中文文档docs/zh/quickstart.md流程总览、docs/zh/sandbox.md沙箱与批准细节、docs/zh/harness.md各提供商 harness 兼容矩阵、docs/zh/providers.md各家 API 密钥配置。【免费下载链接】openinterpreterA coding agent for open models like Kimi K3项目地址: https://gitcode.com/GitHub_Trending/op/openinterpreter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考