Open Interpreter CLI 快速上手：安装、更新、卸载与源码构建完全攻略

Open Interpreter CLI 快速上手安装、更新、卸载与源码构建完全攻略【免费下载链接】openinterpreterA coding agent for open models like Kimi K3 and GLM 5.3项目地址: https://gitcode.com/GitHub_Trending/op/openinterpreterOpen Interpreter 安装说白了就是装好一个会写代码的命令行助手。这个面向 Kimi K3、GLM 5.3 等开放模型的编程代理核心是一个interpreter命令本文覆盖安装前检查、一键安装、更新、卸载、源码构建与日志排查。项目速览先说它能干嘛。装完之后你在终端里敲下interpreter或者更短的别名i就进入一个交互式编码代理让它解释一下这个代码库它会自己列出目录、翻文档、梳理架构让它找出并修复 filename 里的 bug它会先更新计划再动手改代码、跑验证。整个过程就在终端里进行模型用的是 Kimi K3、GLM 5.3 这类开放模型而不是单一闭源接口。那它装完之后到底在你电脑里留下了什么、为什么卸载时敢保证不误伤其他工具别急装完验证那一步我会带你把目录结构彻底看明白。安装前准备 一键安装环境预检装之前先勾一遍这份清单动手前先花十秒钟确认几件事能省掉后面大多数装不上的困惑macOS当前发行版构建面向现代 macOS 版本太老的系统不在目标范围内。Linux使用近期的 64 位发行版即可。发行压缩包基于 musl 构建为的就是在尽量多的发行版上都能跑起来。Windows准备一个 PowerShell 环境即可如果你更习惯类 Linux 工作流在 WSL 里走 Linux 那条路也可以。Git强烈建议装一个。仓库感知的会话、差异diff与审阅功能都依赖它。网络安装脚本会在线下载对应平台的发行压缩包macOS/Linux 端还需要curl或wget之一scripts/install/install.sh 里两者都会尝试。macOS / Linux 一键安装步骤预检没问题打开终端贴这一行curl -fsSL https://www.openinterpreter.com/install | sh这条命令拉取的就是仓库里维护的 scripts/install/install.sh下载你平台的发行包、在~/.openinterpreter下铺好包结构、在~/.local/bin里放好可执行入口三步一气呵成。Windows 安装路径与命令打开 PowerShell具备用户级写入权限即可执行irm https://www.openinterpreter.com/install.ps1 | iexWindows 上可执行入口落在%LOCALAPPDATA%\Programs\Open Interpreter\bin而真正的包数据存放在%USERPROFILE%\.openinterpreter\packages\standalone——这个路径约定在卸载时还会用到。装完先验证 刚刚你的电脑上发生了什么 先说结论重启你的 shell让PATH生效然后验证interpreter --version能打印出版本号就算装成功了。此时interpreter和别名i都能直接进交互会话。那刚才那一分钟里系统里实际发生了什么可以把它理解成门牌 档案室的两层结构门牌shim~/.local/bin/interpreter和~/.local/bin/i只是两个软链指向包内的真实二进制。你日常敲命令时找的始终是这两个门牌。档案室受管包真正按版本存放的档案在~/.openinterpreter/packages/standalone/releases/版本下每个版本一格一个叫current的软链则像当前在用的指路牌始终指向最新装好的那一格。门锁standalone/install.lock是并发安装锁防止两个安装流程同时写坏档案室。理解了更新只是换一格档案、把current指路牌挪过去后面更新和卸载为什么安全就全通了。保持更新三种让 CLI 最新的姿势默认情况下独立安装会在正常交互式启动时自动检查更新你什么都不用做。但想手动掌握节奏时有三种姿势任选主动拉新版直接运行interpreter update它会拉取最新发行版并切换current指向。关掉启动自检在配置里写check_for_update_on_startup false。这个字段真实存在于配置系统由 codex-rs/config/src/config_requirements.rs 中的ConfigRequirementsToml声明并参与分层合并关掉后启动时就不会再打扰你。重跑公共安装命令再执行一遍前面那条curl | sh是官方明确支持的幂等操作随时可以把环境拉回最新状态。两个进阶细节知道即可想装指定版本而不是最新版安装脚本支持--release VERSION参数版本号需符合x.y.z或x.y.z-alpha.N/x.y.z-beta.N格式默认latest校验逻辑就在 scripts/install/install.sh 里。调试启动或更新循环问题时CLI 的 doctor 后台逻辑会维护一个叫app-server-updater.pid的文件见 codex-rs/cli/src/doctor/background.rs保证 doctor 检查在更新循环旁边运行时也是安全的。安全卸载与数据保留最快卸载方法三条命令优雅退场 macOS 和 Linux 的卸载逻辑完全一致一段脚本搞定macOS 在终端跑Linux 同理for name in interpreter i codex-code-mode-host; do path$HOME/.local/bin/$name case $(readlink $path 2/dev/null || true) in $HOME/.openinterpreter/packages/standalone/*) rm -f $path ;; esac done rm -rf $HOME/.openinterpreter/packages/standalone注意脚本里的readlink校验只有当软链目标确实指向受管 standalone 目录时才会删防止误伤你自己装的其他工具。两个平台唯一的差别在 shell 配置如果安装程序曾往配置里写过标记为Open Interpreter installer的块macOS 去~/.zprofile/~/.bash_profile里删Linux 去~/.bashrc、~/.zshrc或~/.profile里删。~/.local/bin留在PATH里是安全的——尤其是其他工具还在用它的时候。Windows 走 PowerShell脚本先验证bin目录确是指向 standalone 根目录的 junction目录联接不是就直接抛异常拒绝删除随后移除 junction、删掉 standalone 根目录最后把bin目录从用户级Path中摘除$binDir Join-Path $env:LOCALAPPDATA Programs\Open Interpreter\bin $interpreterHome Join-Path $env:USERPROFILE .openinterpreter $standaloneRoot Join-Path $interpreterHome packages\standalone if (Test-Path -LiteralPath $binDir) { $binItem Get-Item -LiteralPath $binDir -Force $binTarget [string]$binItem.Target $isManagedJunction ($binItem.Attributes -band [IO.FileAttributes]::ReparsePoint) -and $binTarget.StartsWith($standaloneRoot, [StringComparison]::OrdinalIgnoreCase) if (-not $isManagedJunction) { throw Refusing to remove $binDir because it is not an Open Interpreter managed junction. } Remove-Item -LiteralPath $binDir -Recurse -Force } Remove-Item -LiteralPath $standaloneRoot -Recurse -Force -ErrorAction SilentlyContinue $userPath [Environment]::GetEnvironmentVariable(Path, User) if (-not [string]::IsNullOrWhiteSpace($userPath)) { $nextPath ($userPath -split ; | Where-Object { -not [string]::Equals($_.TrimEnd(\), $binDir.TrimEnd(\), [StringComparison]::OrdinalIgnoreCase) }) -join ; [Environment]::SetEnvironmentVariable(Path, $nextPath, User) }跑完后打开一个新的 PowerShell 窗口让它拿到更新后的用户PATH即可。自定义路径替换规则看这里如果你安装时通过环境变量自定义过位置把上面脚本里的默认路径换成你自己的值就行环境变量作用默认值OPEN_INTERPRETER_INSTALL_DIR自定义 shim可执行文件目录~/.local/binINTERPRETER_HOME自定义主目录~/.openinterpreterCODEX_INSTALL_DIR/CODEX_HOME前两组的兼容别名仓库脚本同时读取以向后兼容同上这组变量的读取顺序可以在 scripts/install/install.sh 开头几行直接看到。想连根拔起先备份⚠️这一步不可撤销请先备份。上面所有卸载命令都有意保留~/.openinterpreter下的用户数据——你的配置、会话、日志、文件存储的凭证都还在重装后无缝衔接。如果你就是想把一切清干净macOS/Linux 上删除~/.openinterpreter整个目录Windows 上删除$env:USERPROFILE\.openinterpreter。但请记住两件事这是不可逆操作而且它碰不到存放在操作系统密钥环keyring或环境变量里的凭证那部分需要你在系统层面另行清理。开发者专区从源码构建️ 要改 CLI 源码并在本地验证的话先把仓库拿下来git clone https://gitcode.com/GitHub_Trending/op/openinterpreter然后在仓库根目录跑./scripts/build-interpreter-release.sh这里要泼一盆冷水别拿随手一条cargo build糊弄。裸编译出来的二进制只是个光板缺少入口点、打包资源和平台帮助程序这些受管布局的组成部分而安装上下文检测和自更新恰恰全靠这套文件结构才能跑通。发行版脚本产出的才是和公共安装程序完全同构的包。脚本参数一览来自其自带 usage 说明参数默认值说明--target triple当前宿主平台指定 Rust 目标三元组用于交叉构建--install-dir dir$OPEN_INTERPRETER_INSTALL_DIR/$CODEX_INSTALL_DIR否则~/.local/bin放置interpreter/ishim 的可见目录--home dir$INTERPRETER_HOME否则~/.openinterpreter主目录包会暂存在其下-j, --jobs N$CARGO_BUILD_JOBS否则1并行 Cargo 构建任务数须为正整数执行流程一句话版校验参数 → 在releases/下准备临时 staging 目录 → 调用python3 scripts/build_codex_package.py带--variant open-interpreter、--cargo-profile release注意脚本要求 Python 3.11完成真实构建 → 产物移入releases/local-target→ 原子切换current软链 → 在 shim 目录建立interpreter与i两个门牌 → 最后跑interpreter --version自检。整条链路有回归测试兜底见 scripts/test_build_interpreter_release.py。构建完成后直接执行~/.local/bin/interpreter就能启动你的本地产物若要正式对外分发请走 README_ZH.md 中描述的发布流程。出问题了查日志 交互式 TUI 的日志固定写在~/.openinterpreter/log/这个目录对应配置里的log_dir字段在 codex-rs/config/src/config_requirements.rs 中被建模为受控路径字段。只给某一次运行换个临时日志目录可以用命令行内联配置interpreter -c log_dir./.interpreter-log再看 Rust 侧日志时用标准RUST_LOG过滤语法调粒度RUST_LOGinfo interpreterRUST_LOGdebug看更细RUST_LOGinterpreterdebug只放大核心模块。日志目录配合过滤级别模型调用、工具执行、自更新这几个环节的毛病基本都能定位。常见问题速查Q装完了但终端提示interpreter命令不存在九成是PATH没生效macOS/Linux 重启 shell 再试Windows 开新的 PowerShell 窗口。也可以echo $PATH确认~/.local/bin在不在里面——安装程序有时会往 shell 配置文件里加标记块来补这条路径。Q怎么确认当前装的是哪个版本跑interpreter --version最直接。想看实物~/.openinterpreter/packages/standalone/releases/下每个版本一格档案current软链指向哪格你就在用哪格。Q卸载了再重装配置和会话还在吗在。常规卸载只清 shim 和受管包~/.openinterpreter里的配置、会话、日志、文件存储凭证原封不动。只有执行连根拔起那一步才会动它们。Q能关掉启动时的自动更新检查吗能配置里设check_for_update_on_startup false即可。Q自定义了安装路径卸载命令要改吗要。按前面替换规则那张表把脚本里的默认路径换成你当时设置的环境变量值即可。Open Interpreter 的整套生命周期其实就一句话公共脚本负责铺好门牌 档案室更新只是挪指路牌卸载则只清受管文件、数据安然无恙。接下来建议顺着读下去官方安装文档中文、快速上手、配置参考 和 示例配置把模型提供商和个性化参数也配好。【免费下载链接】openinterpreterA coding agent for open models like Kimi K3 and GLM 5.3项目地址: https://gitcode.com/GitHub_Trending/op/openinterpreter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考