OpenCode Windows PowerShell 完整安装使用教程OpenCode 是一款开源的 AI 编程助手可以在终端里通过自然语言帮你读代码、改文件、跑命令。本文基于 Windows PowerShell 环境从零开始讲清安装、配置 DeepSeek、思考强度、粘贴图片、选择模型、查看历史等核心操作。一、安装 Node.js 与 OpenCodeOpenCode 依赖 Node.js 运行推荐安装 LTS 版本。访问 nodejs.org下载Windows Installer (.msi)的 LTS 版本。双击运行安装包一路 Next 即可。安装完成后打开 PowerShellWin R 输入powershell回车验证环境node-v npm-v如果能看到版本号说明 Node.js 环境就绪。在 PowerShell 中执行以下命令全局安装 OpenCodenpm install-g opencode-ai验证安装opencode--version更新opencode到最新稳定版 在cmd执行下面命令即可opencode upgrade启动之前设置一下 环境变量 主要是通过/editor 会自动打开txt然后输入内容 这样可以回车之类的操作更方便$env:EDITORnotepad启动为 cd到你的项目里面opencode这样就启动完成了。二、配置 DeepSeekDeepSeek 官方文档已给出接入 OpenCode 的标准流程。建议先将 OpenCode 升级到≥ v1.18.30避免兼容性问题。2.1 交互配置推荐启动 OpenCode 后在输入框中依次操作输入/connect输入deepseek并选择该供应商填入你的 DeepSeek API KeyAPI Key 会自动持久化到~/.local/share/opencode/auth.json。2.2 环境变量方式适合脚本化$env:DEEPSEEK_API_KEYsk-your-key-hereopencode如需永久生效将其添加到系统环境变量中。2.3 验证配置配置完成后输入/models应该能看到deepseek/deepseek-v4-pro和deepseek/deepseek-v4-flash两个可选模型。三、思考强度Reasoning EffortOpenCode 支持为模型设置推理强度变体常见级别包括none、low、medium、high、xhigh。3.1 查看与切换使用快捷键variant_cycle可以在不同推理强度变体之间快速切换。3.2 配置文件设置默认值在opencode.json中为模型添加options{$schema:https://opencode.ai/config.json,model:deepseek/deepseek-v4-pro,options:{reasoning_effort:high}}3.3 插件方案opencode-adaptive-thinking该插件让 AI 代理在会话中主动调整推理强度。安装方式{plugin:[opencode-adaptive-thinking]}插件会注入系统提示并根据任务复杂度自动选择合适的推理级别。你也可以通过工具手动设置参数persist: true表示本次会话持续生效。四、打开 txt / 输入文件内容OpenCode 通过语法引用文件被引用的文件内容会自动加入当前对话上下文。在输入框中输入触发模糊文件搜索config.txt 帮我解释一下这个配置文件的含义输入文件名的一部分即可定位并引用。这种方式适合读取和处理 txt、md、log 等文本文件。五、粘贴图片在 Windows PowerShell 中CtrlV粘贴图片存在已知冲突因为该快捷键与 Windows Terminal 的粘贴功能冲突。解决方案修改快捷键绑定在opencode.json中修改input_paste的绑定{keybinds:{input_paste:ctrlaltv}}重启 OpenCode 后使用CtrlAltV即可粘贴图片。有用户反馈此方案在 opencode 1.2.1 Windows Terminal 环境下有效。补充方案如果你的模型本身不支持图片输入可以安装opencode-easy-vision插件。它会将粘贴的图片保存到磁盘并注入模型调用工具所需的指令从而为纯文本模型“补上”视觉能力。六、选择模型6.1 在 TUI 中切换直接输入/models会列出所有已配置供应商下的可用模型从中选择即可。也可以直接切换/model deepseek/deepseek-v4-pro6.2 设置默认模型在配置文件中设置{model:deepseek/deepseek-v4-pro}格式为provider_id/model_id。6.3 启动时指定opencode--model deepseek/deepseek-v4-pro# 或opencode-m deepseek/deepseek-v4-pro模型加载优先级命令行参数 配置文件 上次使用 内部优先级。七、查看历史问答日志7.1 本地数据库位置OpenCode 的历史会话存储在本地 SQLite 数据库~/.local/share/opencode/opencode.db7.2 TUI 内查看输入/session或/sessions可以浏览和切换历史会话。7.3 插件增强opencode-history-plugin安装该插件后AI 代理可以通过工具搜索历史对话相当于长期记忆{plugin:[opencode-history-plugin]}提供两个核心工具history_search关键词搜索历史消息支持 AND/OR 匹配、按角色过滤、分页history_view查看指定会话的完整记录例如让 AI 帮你找“上次关于部署脚本的讨论”它会从 SQLite 数据库中直接读取只读安全。八、常用命令速查命令作用/connect连接供应商、配置 API Key/models查看/切换模型/model provider/model直接切换指定模型/session浏览历史会话/init扫描项目生成 AGENTS.md/undo撤销上一步 AI 修改/redo恢复撤销/share生成分享链接九、遇到问题“opencode 不是内部或外部命令”关闭 PowerShell 重新打开。仍不行则检查 npm 全局路径是否在 PATH 中通常是%APPDATA%\npm。npm 安装慢配置镜像源npm config set registry https://registry.npmmirror.com或开启代理后重试。粘贴图片无效确认已按第五节修改input_paste快捷键绑定并重启 OpenCode。