一、基础概念
Vibe Coding：基于 AI 编程代理的开发模式，通过自然语言指令即可快速完成应用开发。
OpenCode：开源 AI 编程代理工具，支持 TUI、CLI、Web、IDE 插件、桌面版多种使用形态。
二、OpenCode 安装（Ubuntu 24.04 环境）
2.1 环境准备
登录 Ubuntu 24.04 系统，切换至 root 用户获取管理员权限，用于系统级软件安装。
2.2 Node.js 环境部署
OpenCode 基于 Node.js 开发，需先部署运行环境：
执行 NodeSource 官方脚本，自动配置 Node.js 24.x 对应的 apt 软件源；脚本执行后自动集成 npm 包管理器。
通过 apt 命令安装 nodejs 软件包。
执行 npm 相关命令验证安装，返回使用说明即表示安装成功。
2.3 OpenCode 安装
使用 npm 全局安装 opencode-ai 包。
执行 opencode 命令验证，正常进入交互界面即表示安装成功。
三、OpenCode 基础使用
3.1 启动与退出
启动：终端执行 opencode 命令，进入交互界面。
退出：按下 Ctrl+C，或在交互界面输入 /quit、/q、/exit 命令。
3.2 工作目录规则
执行 opencode 命令的当前目录即为工具的工作目录。
OpenCode 默认仅可对工作目录及其子目录内的文件进行读取、修改操作。
最佳实践：提前创建项目目录，进入该目录后再启动 OpenCode。
3.3 基础配置
主题切换：输入 /themes 命令，切换界面主题。
模型选择：输入 /models 命令，选择交互使用的大语言模型。
命令面板：按下 Ctrl+P 打开命令面板，执行全量功能操作。
3.4 内置免费模型
OpenCode 自带四款免费模型：Big Pickle Free、Hy3 preview Free、MiniMax M2.5 Free、Nemotron 3 Super Free。
特点：无需付费即可使用，存在调用额度上限；适合入门试用，密集开发场景下额度不足。
四、Agent 智能体机制
4.1 Agent 核心定义
Agent 即智能体，是 AI 应用开发领域的核心概念。
本质是预设的系统提示词，定义了大语言模型的人设、核心功能、交互约束。
作用是对通用大语言模型的能力进行定向约束，使其专注于特定任务。
4.2 四类内置 Agent
Plan：仅回答问题、不修改代码；用于技术提问、方案设计、项目规划。
Build：可回答问题、可修改代码；是代码开发的主力智能体。
General：独立子智能体，拥有单独的上下文窗口；用于处理与主线无关的子问题，工具可自动调度。
Explore：用于解析现有项目代码；辅助开发者快速理解陌生项目的结构与逻辑。
4.3 Agent 切换方式
Build 与 Plan 切换：按下 Tab 键快速切换。
General 与 Explore 切换：输入 @ 前缀触发选择。
五、实战案例：C 语言控制台贪吃蛇
5.1 开发流程
创建项目目录 snake，并进入该目录。
启动 OpenCode，输入开发指令：使用 C 语言编写控制台版本贪吃蛇。
工具自动执行：查看目录结构 → 编写代码 → 检查编译环境 → 尝试编译运行。
若缺少依赖，工具会提示安装方式；安装完成后可指令工具继续执行。
发现程序问题后，可直接描述问题，工具自动迭代修复代码。
5.2 关键操作
终止当前操作：快速双击 ESC 键。
恢复中断操作：输入 “请继续” 类指令。
消耗监控：界面实时显示 token 使用量、上下文占比、费用情况。
5.3 依赖组件
编译工具：gcc 编译器。
终端图形库：ncurses 库，对应开发包为 libncurses-dev（Debian/Ubuntu 系）。
六、LLM 记忆与上下文机制
6.1 记忆实现原理
大语言模型本身不具备记忆能力，对话记忆由 OpenCode 工具维护。
实现逻辑：每次交互时，OpenCode 会将系统提示词、历史对话记录、当前用户指令一并发送给大语言模型，使其表现出 “记忆” 能力。
三类提示词：系统提示词（工具内置）、用户提示词（用户输入）、AI 提示词（模型回复）。
6.2 上下文窗口
大语言模型单次请求能够处理的 token 总量存在上限，该上限称为上下文窗口；不同模型的上下文窗口规格不同。
上下文会随对话轮次持续累加，超出窗口上限会导致功能异常。
6.3 上下文管理方案
新建独立会话：执行 /new 命令开启新会话；开发独立功能时使用，避免上下文冗余。
会话内容压缩：执行 /summary（等价 /compact）命令，让大语言模型总结历史会话内容，压缩上下文占用。
持久化记忆：项目根目录创建 AGENTS.md 文件，OpenCode 每次启动时自动读取，作为持久化系统提示词。
会话管理：执行 /sessions 命令，查看、切换历史会话。
七、MiniMax Token Plan 配置
7.1 套餐概述
原名 Coding Plan，现更名为 Token Plan，是 MiniMax 推出的编程专用大模型订阅服务。
特点：国内大模型，访问延迟低，价格相对低廉，编程能力达标。
7.2 套餐档位与额度规则
提供多档按月 / 按年订阅套餐，入门档为 Starter，适合基础开发需求。
额度规则：
按 5 小时为周期重置模型调用次数。
每周设有总调用额度上限。
基础版为常规推理速度，极速版支持更高 TPS 的高速推理。
7.3 配置步骤
进入 MiniMax 开放平台官网，注册并登录账号。
进入 Token Plan 页面，选择对应套餐完成订阅支付。
在账户管理中获取 Token Plan Key（即 API Key）。
启动 OpenCode，执行 /models 命令，选择查看所有提供商。
选择对应地区的 MiniMax Coding Plan 提供商（国服为 minimaxi.com，国际服为 minimax.io）。
粘贴 API Key 并确认，完成提供商接入。
回到模型选择界面，选择对应版本的模型（如 MiniMax-M2.7）。
7.4 注意事项
国服（minimaxi.com）访问速度优于国际服（minimax.io），优先选择国服。
基础版套餐不支持 highspeed 高速模型，强行使用会产生额外费用。
基础版在低峰期速度较快，白天高峰期可能出现排队。
API Key 为账户身份凭证，严禁泄露，否则可能导致额度被盗用。
不推荐购买年付套餐：大语言模型迭代速度极快，年付灵活性差。
八、常用命令与快捷键
类型 操作 功能说明
快捷键 Tab 切换 Build/Plan Agent
快捷键 Ctrl+P 打开命令面板
快捷键 Ctrl+C 退出 OpenCode 程序
快捷键 双击 ESC 中断当前正在执行的操作
命令 /new 新建独立会话
命令 /models 打开模型选择与配置界面
命令 /themes 切换界面主题
命令 /sessions 打开历史会话管理
命令 /summary /compact 压缩总结当前会话上下文
命令 /connect 添加 AI 模型提供商
命令 /export 将当前对话导出为 Markdown 文件
命令 /help 显示帮助信息
命令 /undo 撤销上一步操作（需项目为 Git 仓库）
命令 /quit /q /exit 退出 OpenCode 程序
九、代码
1. 环境安装命令
# 切换至 root 用户
sudo -i
# 添加 Node.js 24.x apt 软件源（自动集成 npm）
curl -sL https://deb.nodesource.com/setup_24.x | bash -
# 安装 Node.js
apt install nodejs
# 验证 npm 安装
npm -v
2. OpenCode 安装与验证
# 全局安装 OpenCode
npm i -g opencode-ai
# 验证安装（进入交互界面即成功）
opencode
3. 贪吃蛇项目操作命令
# 创建项目目录并进入
mkdir -p project/snake
cd project/snake
# 启动 OpenCode 后进行开发
opencode
# 手动安装编译依赖（Ubuntu/Debian 系）
# 安装 gcc 编译器
sudo apt install gcc
# 安装 ncurses 开发库
sudo apt install libncurses-dev
# 手动编译贪吃蛇程序
gcc snake.c -o snake -lncurses
# 运行程序
./snake
————————————————
版权声明：本文为CSDN博主「艾莉丝努力练剑」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/2401_89899187/article/details/162589509