Open Interpreter 命令速查表 - 终端 AI 编码代理 CLI 全参数
Open Interpreter 与其它编码代理最实质的差别是它默认会先给出执行计划、让你审阅之后再动文件——这让它适合真实项目而不是一次性沙箱，尤其是你不确定 AI 会改到哪一步的时候。什么时候该用它：任务本身是操作你本机已有环境，比如批量处理文件、改配置、跑数据脚本，而不是写一个新功能；需要能执行命令来验证结果，而不只是生成代码给你看。判断模型接法也有明确顺序：先用云端模型确认提示与安全开关都按预期工作，再换本地模型，避免同时排查两件事。安装启动、运行模式与参数、安全交互与进阶用法几组命令里，重点在安全开关的取舍——自动执行模式适合只读或受限环境，在含未提交改动的仓库里使用时应先确认工作区干净，否则一次误判就可能覆盖掉尚未提交的修改。
安装与启动 5
pip install open-interpreter通过 pip 安装 Open Interpreter
pipx install open-interpreter通过 pipx 隔离安装（推荐）
interpreter在当前目录启动交互式会话
interpreter --version查看已安装版本
interpreter --help列出全部命令与参数
运行模式与参数 7
interpreter --local使用本地模型运行（无需云端密钥）
interpreter --model gpt-4o指定云端模型
interpreter -y自动确认所有操作（谨慎使用）
interpreter --os允许代理控制操作系统
interpreter --api_base https://api.openai.com/v1接入自定义 OpenAI 兼容端点
interpreter --api_key sk-xxxx直接传入 API 密钥
interpreter --profile coding使用指定 profile 配置
安全与交互 7
interpreter --safe_mode开启安全模式，限制危险操作
interpreter --server启动 CDP 服务，供 Web UI 连接
interpreter resume --last恢复最近一次会话
/model交互中切换模型
/help显示交互帮助
/clear清空当前对话
/exit退出解释器
进阶用法 3
vim ~/.interpreter/profile.yaml编辑 profile 配置默认模型与行为
interpreter --verbose输出详细调试信息
python -c "from interpreter import interpreter; interpreter.chat('重构 utils 模块')"在 Python 中以编程方式调用
提示
- Open Interpreter 默认会先规划、再让你审阅改动，把
-y当作自动化开关而非日常默认，避免误改文件。 - 接本地模型用
--local，配合 LM Studio 或 Ollama 的 OpenAI 兼容端点，可完全离线运行。 /model可在对话中随时切换模型，长任务中途换更强模型无需重启会话。- 自动执行（-y）配合只读提示一起用最安全：既省去逐条确认，又把动作范围限制在查看和统计这类无副作用的命令上。
- 让 Agent 操作前先加一句"先只做 dry-run 并打印将要执行的命令"，是核对影响范围最省事的方式，比事后翻 git diff 更早暴露路径写错。
- 复杂任务分轮推进：第一轮只让它探索并汇报目录结构，确认理解无误后再让它动手，能避免基于错误假设写出成片的无效改动。
常见问题
Open Interpreter 和 ChatGPT 式问答有什么不同？
它在终端里直接读文件、改代码、跑命令，改动先让你审阅再应用；而纯问答只返回文本，不操作你的项目。
必须用云端 API 吗？
不必须。--local 可走本地模型，或用 --api_base 指向任意 OpenAI 兼容端点（含自建服务）。
由 巧匠 维护
公开更新于 2026年9月10日，内容持续校对官方文档。