OpenCode + tmux 三窗格终端布局,让“写、问、跑“不用切窗口

发布时间:2026/11/3 2:12:02
OpenCode + tmux 三窗格终端布局,让“写、问、跑“不用切窗口

OpenCode + tmux 三窗格终端布局,让"写、问、跑"不用切窗口

【免费下载链接】termaiA powerful AI coding agent. Built for the terminal.项目地址: https://gitcode.com/gh_mirrors/te/termai

改一行代码,报错、问 AI、回去改,得来回切三个窗口。OpenCode 是长在终端里的 AI 助手,tmux 负责把一个终端拆成多个窗格,两者一搭,多窗格终端工作流就成型了。

动手前确认这两件事

  • tmux 可用:tmux -V能打印出版本
  • OpenCode 已安装,which opencode能找到
  • 所选模型服务商的 API key 已配置(如ANTHROPIC_API_KEY)
  • 知道 tmux 默认前缀键是 Ctrl+b,后面操作大多是"先按前缀,再按功能键"

装 OpenCode,选一种:

brew install opencode-ai/tap/opencode # macOS / Linux # Go 用户:go install github.com/opencode-ai/opencode@latest

装完就能往下走。

把终端拆成三块——核心布局搭建

目标是一个屏里摆下三个角色:左边编辑、右上 AI、右下命令。目标布局:

+-------------+------------+ | | opencode | | nvim +------------+ | | $ _ | +-------------+------------+

Step 1:开会话

tmux new -s dev

带名字的会话在多项目时好区分;远程掉线后tmux attach -t dev能把整个环境找回来。

Step 2:水平分一刀

tmux split-window -h

屏幕分成左右两块,右侧成为活动窗格。左侧留一整块给编辑器,行宽舒服。

Step 3:右侧再垂直分一刀

tmux split-window -v

右侧分成上下两块。上面看 AI 的长回复,宽度够;下面跑命令、看输出。

Step 4:摆内容

nvim . # 左窗格:进编辑器 opencode # 右上窗格:起 AI 助手

右下窗格不用动,默认 shell 就够。编辑 / AI 助手 / 命令终端三个角色各就各位。

三个真实场景,跑通你的工作流

写新模块时

左侧窗格敲函数骨架,右上直接问 OpenCode:"按项目现有习惯写这个接口"。它能自己读项目文件(glob、grep、view 这些工具),给出的建议通常比通用模板更贴仓库风格。回复粘回 nvim,右下跑go build ./...验证,全程不用切窗口。

排查一个诡异 Bug

报错偏偏只在你不看的时候出现,右下就先把复现命令跑一遍,把输出落盘:make test 2>&1 | tee test.log。再到右上让 OpenCode 看这份日志,它能直接读 test.log 并对照代码猜问题。第一版判断不对,就补一个失败用例的输入输出再问;它的 bash 工具也能代你跑测试命令,基本不用挪动。

同时推进两个项目

建两个会话:tmux new -s projectA、tmux new -s projectB,各自按上一节拆成三块。tmux switch-client -t projectA来回跳,切走的是整个终端环境而不只是进程。会话管理模块 的对话记录按项目目录存放,两个项目的对话不会串。

几个容易忽略的效率细节

  • ~/.tmux.conf加一行set -g mouse on,鼠标点选窗格、拖分隔条调比例
  • 高频提示词写成 commands 目录下的 .md 文件,Ctrl+K 一键调用(自定义命令模块)
  • 长对话接近上下文上限会自动摘要,autoCompact 默认开启
  • 窗格比例失调,前缀 + Ctrl+方向键原地微调

踩过的坑

Q:编辑器聚焦时前缀键没反应?A:vim 聚焦时按键被编辑器先截走,tmux 的 Ctrl+b 自然不响应。要么开鼠标直接点窗格,要么在~/.tmux.conf里set -g prefix C-a换个不冲突的前缀键。

Q:tmux 里鼠标滚轮完全滚不动?A:没开鼠标时滚轮事件被吞,翻不了窗格历史。~/.tmux.conf加set -g mouse on并重载配置,滚轮就只滚当前窗格的历史。

Q:窗格拖来拖去,比例全乱了?A:按前缀再按l,可以在 tiled、even-horizontal 等预设布局间一键切换。精细微调resize-pane也行,日常用前缀 + Ctrl+方向键足够。

写在最后

今晚就把下午在写的项目搬进 tmux 跑一次,拆一刀,把 OpenCode 放右上。二十分钟后你会发现窗口一次没切过。用着顺手了,再把某个高频操作写成自定义命令,这套终端多窗格布局就算长在你手上了。

【免费下载链接】termaiA powerful AI coding agent. Built for the terminal.项目地址: https://gitcode.com/gh_mirrors/te/termai

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考