Open Interpreter 如何在 Windows 原生 PowerShell 或 WSL 中安装并跑通首次会话？

Open Interpreter 如何在 Windows 原生 PowerShell 或 WSL 中安装并跑通首次会话？

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

在 Windows 上使用 Open Interpreter 有两条官方支持的路径：原生 PowerShell 直接安装，或在 WSL（Windows Subsystem for Linux）里按 macOS/Linux 流程安装。本文覆盖两条路径的安装命令、版本验证，以及安装后如何进入一个项目、完成首次交互式会话（provider 配置、发出第一个任务请求、处理权限确认）。

先选择：原生 PowerShell 还是 WSL

Open Interpreter 官方文档对两条路径的适用场景给出了明确区分（见 docs/windows.md）：

• 原生 Windows 项目：使用 Windows 路径和 PowerShell 约定，直接在 PowerShell 中安装。
• 项目已使用 Linux 工具链：在 WSL 中安装，使用 Linux 路径和工具。
• 沙箱行为：原生 Windows 的沙箱执行细节与 macOS/Linux 不同。如果你需要 Linux 风格的沙箱行为，官方建议使用 WSL。对于受信任的本地仓库，从默认权限开始，仅在任务需要时再放宽。

如果不确定，可以先按项目本身的工具链选：项目是纯 Windows/PowerShell 脚本就走原生路径，项目依赖 Linux 工具就走 WSL。

原生 PowerShell 安装

在 PowerShell 中执行官方安装脚本：

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

该公共安装器会下载对应平台的 release，并安装 Open Interpreter 自更新逻辑所使用的 managed standalone 布局（说明见 docs/install.md）。仓库内可对照该安装器的实际逻辑，见 scripts/install/install-open-interpreter.ps1。

前置要求（来自 docs/install.md 的 Requirements 表）：

• Windows 要求使用 PowerShell 安装；WSL 也受支持，用于 Linux 风格工作流。
• Git：文档标注为 Recommended，用于 repository-aware 会话、diff 和 review。如果项目是 Git 仓库，建议先确认已安装 Git。

WSL 安装

在 WSL 终端内使用 macOS/Linux 的安装命令：

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

安装完成后，路径与 shell 风格要跟随所选环境：WSL 中使用 Linux 路径和工具，原生 Windows 中使用 Windows 路径和 PowerShell 约定。

验证安装

安装后重启终端，然后执行：

interpreter --version

WSL 下同样适用该命令（bash中执行即可）。能打印出版本号说明二进制已就位。

后续如需更新，可执行interpreter update，或在正常交互启动时自动检查更新；在配置中设置check_for_update_on_startup = false可关闭启动时的自动检查（见 docs/install.md）。

跑通首次会话

验证通过后，进入你的项目目录启动会话。下面的my-project是 docs/quickstart.md 中的示例目录名，替换为你自己的项目路径：

cd my-project i

i是interpreter的短命令，两者都会启动交互式 TUI。

首次运行会引导你完成 provider 配置，文档列出的选项包括：

• 使用 ChatGPT 登录；
• 使用 API key；
• 通过 Ollama 或 LM Studio 连接本地模型；
• 配置其他兼容 provider。

之后可以用/model随时更换 provider、模型和 reasoning effort。

如果你使用本地模型，先启动本地服务，再直接指定 provider（见 docs/models.md）：

interpreter --oss --local-provider ollama interpreter --oss --local-provider lmstudio

--oss不带--local-provider时会使用已保存的oss_provider，或打开一个选择器，显示各默认本地端点是否在响应。注意该命令示例来自 Linux/macOS 风格文档，在原生 Windows 的 PowerShell 中执行时，前缀环境变量等 bash 写法（如CODEX_OSS_BASE_URL=... interpreter ...）需要按 PowerShell 语法改写为$env:CODEX_OSS_BASE_URL = "..."后再启动；远程本地服务器的完整 base URL 覆盖机制以文档为准。

进入 TUI 后，输入一个具体请求，例如：

add a /health endpoint that returns the build sha

Open Interpreter 会读取项目、提出工作方案、编辑文件，并通过当前激活的沙箱和审批设置执行命令。默认本地工作流下，它可以在当前工作区内工作，超出当前策略需要的操作会先询问。会话中可用/permissions查看或修改权限策略。

确认会话正常并完成收尾

判断首次会话已跑通的标志：

1. interpreter --version能输出版本号；
2. 启动i后 TUI 正常显示，首次运行出现 provider 配置引导；
3. 发出请求后，agent 会读取项目并返回工作提案或编辑结果，需要额外权限的操作会弹出审批提示。

会话结束后可以稍后恢复，保留此前的对话、上下文和工作目录：

interpreter resume --last

常用会话内命令参考 docs/quickstart.md 的“Common first commands”表，例如/review审查当前变更、/model切换模型、/permissions调整权限；TUI 快捷键与/status、/resume等会话控制命令见 docs/interactive.md。

限制与排查

• 沙箱差异：原生 Windows 沙箱的执行细节与 macOS/Linux 不同；需要 Linux 风格沙箱行为时使用 WSL（docs/windows.md）。
• 日志位置：交互式 TUI 的日志写入~/.openinterpreter/log/（WSL 下为 Linux 家目录；Windows 下对应用户目录中的.openinterpreter）。单次运行可用interpreter -c log_dir='"./.interpreter-log"'覆盖日志目录（docs/install.md）。
• 本地模型告警：若出现Model metadata for ... not found，表示本地服务器返回的模型 ID 不在兼容目录中，不必然意味着连接失败；用-m传入服务器实际暴露的模型 ID，并保持 Open Interpreter 更新以获得最新目录（docs/models.md）。
• 卸载：安装器创建的 managed standalone 布局可按 docs/install.md 中的卸载脚本移除，用户数据（配置、会话、日志、凭据）保留在.openinterpreter目录下，重装不会丢失。

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