






























- OpenCode官网网址:https://opencode.ai/
- DeepSeek官网网址:https://www.deepseek.com/
- Windows命令行简易入门
AI大模型应用于编程领域已成为主流趋势。从早期Chat模式下帮助生成代码、定位错误、解答问题,到后来发展为集成在IDE中的AI插件,再到当前备受关注的AI智能体(Agent)编程,AI大模型编程正逐步演进为编程领域的核心开发方式。需要指出的是,这三个阶段并非简单的替代关系,而是并存演进:Chat模式与IDE插件仍是大多数开发者的日常工具,而AI智能体编程则代表了更高自主性的前沿方向。今天要介绍的,正是其中最新兴起的基于AI智能体的编程方法——例如 OpenCode 所代表的这一方向。
OpenCode 是一个开源的AI智能体编码助手,在命令行里直接和 AI 对话就能完成代码编写、Bug 修复和项目重构。它采用 Client/Server 架构,支持 75+ 种 AI 模型提供商,包括 OpenAI、Anthropic、Google Gemini 和 DeepSeek、GLM 等。
国内的DeepSeek V4 于 2026 年 4 月发布,是国内顶级开源权重模型。其有两个版本 V4-Pro、V4-Flash。
OpenCode可以与DeepSeek API结合,进行基于自然语言描述的程序开发。
主要特点:
OpenCode CLI(Command-Line Interface) 是一个开源的、模型无关的 AI 编程助手命令行工具,需要在一个终端窗口里运行。
在Windows上使用OpenCode CLI,你会遇到三种不同的运行环境(Shell或子系统),它们的定位和关系如下:
| 环境 | 性质 | 说明与适用场景 |
|---|---|---|
| CMD | 传统Shell | 功能较老,不推荐用于OpenCode |
| PowerShell | 现代Shell | 可运行 OpenCode 的基础功能。Windows Terminal等终端默认打开PowerShell。推荐初学者使用此环境!但部分高级功能或插件可能存在兼容性问题。 |
| WSL2 | 适用于Linux的Windows子系统(Windows Subsystem for Linux) | 在 Windows 系统提供完整的 Linux 环境。兼容性最好,插件全功能可用。OpenCode官方推荐在WSL下使用OpenCode。 |
说明:Windows 10 默认自带 CMD 和 PowerShell 终端程序,但默认未安装现代化的 Windows Terminal 终端应用。你可以通过 Microsoft Store 免费安装 Windows Terminal,它支持在一个窗口内同时打开 CMD、PowerShell、WSL 等多个环境,能极大提升使用体验。
使用建议:
OpenCode CLI(OpenCode命令行界面)可以安装在多种类型操作系统上,Linux与macOS操作系统下对其支持最好,Windows下官方建议先安装WSL,后然后再在其上安装OpenCode。当然如果只是初学者,想快速体验一下,在Windows下亦可直接安装。
OpenCode有命令行版(CLI)和桌面版等。但现在桌面版功能还不是特别全,建议安装OpenCode CLI。
本小节主要讲的时Windows下安装OpenCode CLI。
Win+X,选择*Windows PowerShell终端(管理员)**。也可以按Win键,输入powershell,点击 以管理员身份运行。npm i -g opencode-aiopencode -version对Windows终端、CLI不熟悉的可阅读如下文章:
如果是在WSL或macOS下,则使用如下命令安装:
curl -fsSL https://opencode.ai/install | bash
更多安装方法请参考OpenCode官网说明文档。
启动 OpenCode 之前,首先要理解项目目录这个概念。
当你编写某个程序项目,一般会包含多个文件与子目录。而项目目录就是这些文件与子目录共同所在的根文件夹。
为了演示,在D:\盘下建立一个firstprj项目,将该目录作为项目目录。
详细步骤如下:
firstprj后,执行OpenCode命令打开OpenCode终端:
具体命令如下:
d:\
md firstprj
cd firstprj
opencode
如果启动成功,则打开OpenCode TUI:

在中间的对话框中可以输入你想要做的事,比如可以输入:
如果没有配置,OpenCode默认使用的是免费的专为编程优化的Big Pickle大模型,编写一个小程序不成问题。
比如,输入编写一个Java类Calculator支持通过命令行给定参数"操作数1 运算符 操作数2"执行加减乘除运算并输出结果,编写好以后进行测试。不要使用pom项目。,接下来OpenCode就开始编写代码、创建文件、编译然后运行测试。如下图所示(注意:不同机器对上述提示词可能会使用不同的方法来完成该任务,在你电脑上的返回结果也许和文中截图不一致,但完成加减乘除的核心逻辑与异常处理方法,应该基本一致。):

查看一下项目目录中的文件,如下图所示:

可以看到,OpenCode生成了Calculator.java源代码文件,并编译得到了Calculator.class字节码文件。
回顾一下刚才的编码过程,我们实际上并不是直接在 PowerShell 命令行中输入自然语言让 OpenCode 执行任务,而是:
1. 什么是OpenCode TUI?与PowerShell这种CLI有什么不同?
OpenCode TUI 就是之前启动 OpenCode 后看到的那个交互式界面(Terminal User Interface,终端用户界面)。
简单来说,它是 OpenCode 的"主工作台"——一个直接在终端里运行的全功能 AI 编程助手界面。
CLI 是“输入命令→执行一次→得到结果→结束”,TUI 是“进入一个界面→与 AI 持续对话→AI 可以帮你做一系列操作”。
2.在OpenCode TUI中怎么引用文件作为上下文
可在对话框使用@文件名来引用,比如可以输入 解释 @Calculator.java。然后OpenCode就会将该文件作为上下文添加,进行解释。
3. 在在OpenCode TUI中怎么执行Shell命令
可在对话框输入!,就会切换到 Shell 模式,这是你可以输入dir进行查看。
OpenCode TUI下有很多斜杠命令(slash command),使用斜杠(/)激活。如,输入/theme可以切换TUI的界面主题。
而/models命令可以选择后台大模型,有时会有一些免费大模型可用(后面标Free的都是免费的),如下图所示:

从图片中可以看到,最近大火的 DeepSeek V4 Flash 暂时是免费使用的。
初学者还应掌握其他常见的斜杠命令,如:
/help – 帮助命令。当你忘记某个命令或不知道下一步该做什么时,输入 /help 命令名(如, /help models)会显示当前可用的所有命令和简要说明。
/new – 开始新会话(session)。如果你想清空当前会话的上下文,从头开始一个新的任务,可以使用 /new。这不会影响已修改的代码文件,只是重置了与AI的“聊天记忆”。
/exit – 退出OpenCode。当你完成工作,想要退出TUI界面时,输入 /exit 即可安全退出。
Ctrl + P - 打开命令面板 (Command Palette),会列出所有可用的斜杠命令 (/),并以搜索框的形式呈现。当你记不清具体命令(比如是 /theme 还是 /themes)时,通过 Ctrl+P 呼出面板,再输入关键词(如 theme)进行模糊搜索并执行,是最快捷的查找方式。
/init – 初始化项目上下文。当你打开一个已有的代码项目,OpenCode并不了解这个项目的具体情况。输入 /init 后,它会扫描项目结构、读取关键文件(如 package.json、README.md、requirements.txt 等),快速建立对项目的“认知”。这样后续提问时,AI就能基于你的实际项目给出更精准的回答。其将把对项目的描述放在AGENTS.md文件中,该文件是一份针对你项目定制的初始上下文文档,你可以随时手动修改和补充这个文件,让它成为项目长期有效的“AI手册”。/init命令的常见使用场景:
刚才我们在firstprj目录新建了Calculator.java并进行了编译,执行完/init命令行,OpenCode可能会这样回答你。
+ Thought: 13.1s
调查完毕。该仓库极其简单——只有 Calculator.java 和编译后的 .class 文件。没有构建系统、测试框架、CI、配置文件或隐藏文件。仓库甚至没有 git 初始化
OpenCode默认使用英文回答你的问题,可以在对话框中输入“我希望你始终使用中文回复。”
连按两次esc - 中断当前会话。有的时候开始执行某个会话的时候,发现错了,希望它停下来,可以连续按两次esc键,让当前正在运行的会话停下来。
OpenCode有Plan与Build两种模式,如图所示:


Plan 模式:计划模式,在该模式下OpenCode不会生成与修改任何代码,只有读代码的权限并负责分析需求和生成方案;
Build 模式:构建模式,在该模式下可以执行代码编写与文件修改。
建议工作流:
Tab 键进入 Plan 模式,可以通过自然语言和后台的大模型沟通需求、设计方案。比如,对前面的新建的Calculator,你想要编写一个简单的基于Java Swing的图形界面版本的计算器。你可以在 Plan 模式下,输入如下指令:
可以为其编写一个Swing GUI界面吗?
OpenCode就会进行分析,并尝试给出设计方案,如下图所示:

注意:其在给出的设计方案的过程中会和你进行交互等待你确认后再逐步继续下去。
图中OpenCode在询问“界面布局”要怎么选,如果在这里选择3. Type your own answer,你可以自己描述你想要的布局。
图中还可以看到,后面还将对“运算模式”、“文件结构”进行询问。这里进行了如下选择:

这时候按enter就对设计方案进行了提交。提交后后台大模型经过一番规划后,会询问“需要开始执行吗?”,如果按“是”,会发现现在处于 Plan 模式无法编辑文件,如下图所示:

这时候,按 Tab 键切换到 Build 模式,输入“继续”,大模型就开始吭哧吭哧干活了,包括修改代码、新建文件、编译、测试运行。而这整个过程你都可以观察,如下图所示:

吭哧吭哧干完活后,他就会进行一个总结,如下图所示:

我们使用'/exit'推出OpenCode后,然后运行java CalculatorSwing,会看到如下界面:

界面风格嘛,只能说是朴实无华。怎么才能让界面更美观一点,你在 Plan 模式下设置 “界面布局” 的时候可以详细描述。
当然,现在也还可以改。你这时候希望再次进入opencode并继续上次的会话,可在命令行下使用如下命令:
opencode --continue或opencode -c
然后按 Tab 切换到 Plan 模式,告诉它“重新设计一个稍微现代感、美观一点的界面”。然后OpenCode经过一番规划,重新设计,如下图所示:

规划完后,再次切换到 Build 模式,重新编写、编译、测试运行。看看他重新设计的界面,如下图所示:

怎么样?比刚才好看的多吧。当然符合不符合你的要求,还是要由你决定。
可以看到,即使使用 OpenCode 外加如此强大的大模型,编写程序也不是一蹴而就的。因为 AI 大模型虽然强大,但它并不了解你的真实需求。人机之间需要在不断的交互迭代中反复琢磨、修改,才能逐步逼近理想的结果。
这就像盖房子:AI 是一位技术娴熟的施工队,而你才是设计师。你描述一个模糊的愿景,施工队先搭出毛坯;你看了说“窗户再大一点,卧室放东边”,施工队再调整。几轮沟通后,房子才真正符合你的心意。
OpenCode 的 Plan 模式和 Build 模式,正是为了这种“沟通-执行-反馈”的迭代而设计:
所以,不必追求一次描述就让 AI 写出完美代码。多试、多改、多沟通,才是人机协作的正确节奏。
OpenCode 本身包含一些免费的大模型,比如内置的 Big Pickle,对于上文那种小程序的编写,它能轻松拿捏。
不过,面对复杂的程序,免费使用的大模型可能就力不从心了。而且免费福利未必长久。
所以,如果你确实有复杂任务需要处理,推荐购买 DeepSeek API(国产、便宜、放心),然后在 OpenCode 中配置好。如此一来,你就能拥有 OpenCode 就可以调用 DeepSeek API。需要注意的是:DeepSeek API调用会产生费用。
怎么做,简单来说只有进行如下几个步骤就行:
/connectDeepSeek填入你的 API KeyMedium,如果觉得速度太慢或效果不好,可通过/variants选择其他推理深度。搞定。接下来,你就能用上 OpenCode + DeepSeek 这套“大杀器”组合!
注意:如果刚才配置了deepseek-v4-flash,建议再配一个deepseek-v4-pro,方便以后根据不同的任务类型进行切换。
使用/models命令即可进行模型切换。
除了前面介绍的 /init、/connect 等基础命令,OpenCode 还提供了丰富的斜杠命令,帮助你更高效地管理会话和代码改动。以下是几个最常用的命令:
| 命令 | 功能 | 使用场景 |
|---|---|---|
/help |
显示帮助信息 | 忘记命令时快速查阅 |
/models |
查看并切换可用模型 | 在不同模型间切换,如从 DeepSeek V4 Flash 切换到 V4 Pro |
/compact |
压缩会话上下文 | 当会话上下文太长、Token 接近上限时,让 AI 总结历史并释放空间 |
/undo |
撤销上一步操作 | AI 改错了文件或方向跑偏时,一键回滚 |
/redo |
重做撤销的操作 | 撤销后想恢复,用这个命令 |
/share |
生成会话分享链接 | 需要把对话记录分享给同事或保存到文档时使用 |
/export |
导出会话为 JSON 文件 | 备份重要会话或离线分析 |
/new |
开始新会话 | 清空当前会话,重新开始一个干净的任务 |
记不住不要紧,Ctrl + P快捷键可以打开命令列表。
常用命令应用说明:
善用 /compact 保持对话流畅:长时间使用 OpenCode 后,对话历史会越来越长,不仅消耗 Token,AI 的响应速度也会变慢。输入 /compact 后,AI 会自动总结关键信息并“忘记”不重要的细节,相当于给大脑做了一次清理。
/undo 是你的后悔药:Build 模式下 AI 会直接修改文件。如果改出来的代码不是你想要的,别慌,输入 /undo 就能撤销上一次操作,比 Git 回滚还方便 。
切换模型有快捷键**:除了输入 /models,你也可以按 Ctrl+X 再按 m 快速打开模型选择面板,在 DeepSeek V4 Flash(便宜快速)和 V4 Pro(更强推理)之间按需切换 。
认识前导键 Ctrl+x:
Ctrl+x 键为前导键,先按下并松开 Ctrl+X(作为“准备”信号),然后再按下另一个功能键(如 C、N、S),来触发对应的命令。常用的有:
压缩会话,Ctrl+x 后按 C
新建会话,Ctrl+X 后按 N
撤销操作,Ctrl+X 后按 U
列出模型,Ctrl+X 后按 M
会话列表,Ctrl+X 后按 L
退出程序,Ctrl+X 后按 Q
其他常用快捷键:
Shift + Enter, 输入框换行
Esc,中断 AI 响应。AI 正在生成内容时,按一次可立即停止;按两次可强制中断
Ctrl + C,清空输入/退出程序
PgUp / PgDn 消息向上/向下翻页
F2 / Shift + F2 循环切换最近使用的模型
上面通过OpenCode创建并重构项目的过程,完全使用 OpenCode CLI 通过自然语言完成。但有时,稍微复杂一点的项目,还是希望能在IDEA管理(代码查看、编译、调试、代码管理等)同时能利用OpenCode的强大功能。如何实现?首先,IDEA的版本至少要是2026.1.2。
如下步骤中,前三步主要是通过在命令行中进入IDEA中项目或模块的目录中,然后直接启动 OpenCode TUI。
第四步是将OpenCode深度整合到IDEA中,可以直接使用IDEA的AI Chat,功能更加强大。
/init,生成 AGENTS.md 项目说明文件。配置好以后的界面如下:

点击图右上角的AI Chat会弹出此框,可在下面的对话框填写你的需求。
图中标记“1”下方的“+”是用来添加上下文。比如刚才添加了Calculator.java这个文件作为上下文。
图中标记“2”下方的下拉框是用于选择与添加Agent,比如刚才添加的"OpenCode"。
图中标记“3”下方的下拉框是用于选择某种Agent下所配置的模型,这里使用的是Big Pickle大模型。
图中标记“4”下方的下拉框是用于选择当前会话的模式(Plan或Build)
在此对话框中也可以使用一些 OpenCode TUI 中的斜杠命令,比如 /init 命令。运行该命令,就可在当前模块(module)的根目录下就能看到所生成 AGENTS.md。如下图所示:

这里再来详细说一下AGENTS.md文件的作用,如下文字为AI生成:
AGENTS.md 文件的作用是为 AI 编程助手提供项目特定的指令和上下文信息。它补充了 AI 无法从代码中直接推断的内容,包括项目的目录结构说明、常用命令行操作、编码规范要求、架构约束规则以及禁止执行的操作边界。AI 读取该文件后,在生成代码、执行命令或提出建议时会遵循文件中定义的规则,从而使其行为符合项目的预期标准。
通常我们需要根据自己想要创建的项目类型对该AGENTS.md进行适当的修改,添加一些工程约束,让后续的生成的代码更符合规范。当然,让初学者自己编写一个符合规范的AGENTS.md还是有一定困难的。不过,可以使用AI大模型帮我们代劳。比如,在对话框中输入如下需求:
请为当前模块的 AGENTS.md 文件补充常规项目约束条款。具体包括:遵循面向对象设计原则;涉及数据库读写时采用 DAO 模式;涉及用户界面时采用 MVC 模式等。注意:要保持AGENTS.md文件尽量精简。
OpenCode就会在后台默默地帮你修改与更新 AGENTS.md 文件。更新完后,可以打 AGENTS.md 进行查看,删除掉不符合需求的内容。
注意1:如上提示词中使用的是模块,就会只更新当前模块根目录下的AGENTS.md。如果改成项目,则更新的是项目根目录下的AGENTS.md。
注意2:要保持 AGENTS.md 尽量精简,50-100行足矣。太多的话,会导致上下文爆炸、增加token消耗,甚至发给大模型的内容被截断(明明写了,但实际上有部分内容被丢弃)。
| 使用方式 | 操作位置 | 适用场景 |
|---|---|---|
| 1. OpenCode CLI | 终端 | 复杂任务、批量操作、需要精细控制 |
| 2. IDEA 传统方式 | IDEA 编辑器 | 编码、调试、重构(不依赖 AI Assistant) |
| 3. IDEA AI Assistant | IDEA 右侧栏 | 日常问答、代码生成、解释错误(推荐) |
Visual Studio Code(VSCode) 是一个轻量级但功能强大的源代码编辑器。安装 OpenCode 时,推荐先在按照前文说明在终端安装 OpenCode CLI 工具,然后在 VSCode 集成终端中运行 opencode,扩展会自动安装;你也可以在 Extensions 中搜索 'opencode' 手动安装。
说明1:打开VSCode集成终端的方法,可以在其Termianl菜单中打开,也可按 Ctrl+Shift+ 打开。 说明2:在命令行下可使用code`命令打开VSCode
命令opencode web,启动一个Web服务器,从而可以在浏览器中访问opencode。
命令opencode web --port 4096,则可以在指定端口(这里是4096)启动Web服务器。
对于Windows用户,官方建议还是使用WSL,然后在WSL下打开web服务器,然后通过web浏览器来访问。
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。