---
title: "如何在Ubuntu上安装OpenCode并配置Vibe-Kanban"
type: source
tags: [opencode, ubuntu, vibe-coding, vibe-kanban]
date: 2026-04-22
---

## Source File
- [[Vibe Coding/如何在Ubuntu上安装opencode并配置Vibe-Kanban.md]]

## Summary（用中文描述）
- 核心主题：OpenCode AI 编程代理的安装、配置与使用完整指南
- 问题域：Vibe Coding 开发环境中，如何搭建基于 OpenCode 的终端 AI 编程工作流
- 方法/机制：通过官方安装脚本一键部署，运行 `/connect` 配置 LLM API Key，运行 `/init` 初始化项目并生成 `AGENTS.md`，通过 Tab 键切换 Plan/Build 模式，使用 `/undo`/`/redo` 撤销重做
- 结论/价值：OpenCode 提供了一个开源、灵活、支持任意 LLM 提供商的终端 AI 编程代理，可配合 Vibe-Kanban 实现 AI 驱动的看板式项目管理

## Key Claims（用中文描述）
- OpenCode 通过 `curl -fsSL https://opencode.ai/install | bash` 一键安装
- OpenCode 支持任意 LLM 提供商，通过 API Key 配置即可使用
- 运行 `/init` 后 OpenCode 会分析项目结构并自动生成 `AGENTS.md` 文件
- Plan 模式（Tab 键切换）禁用写入能力，只生成实现计划
- `/undo` 命令可撤销最近的修改，支持多次连续撤销

## Key Quotes
> "You should commit your project's AGENTS.md file to Git." — OpenCode 官方建议将 AGENTS.md 纳入版本控制，以帮助 OpenCode 理解项目结构和编码规范
> "Give OpenCode plenty of context and examples to help it understand what you want." — 使用 OpenCode 时，提供充足上下文和示例能显著提升实现准确性
> "Drag and drop images into the terminal to add them to the prompt." — OpenCode 支持拖拽图片进行视觉分析和参考

## Key Concepts
- [[Vibe Coding]]：使用 AI 辅助编程的工作流理念，通过自然语言描述需求，AI 代理负责代码实现
- [[Plan Mode]]：OpenCode 的计划模式，通过 Tab 键切换，禁用写入只生成实现方案
- [[AGENTS.md]]：OpenCode 为项目自动生成的角色定义文件，包含项目结构和编码规范，帮助 AI 理解项目上下文
- [[Build Mode]]：OpenCode 的构建模式，通过 Tab 键从 Plan 模式切换回来，执行实际的代码修改

## Key Entities
- [[OpenCode]]：开源 AI 编程代理，提供终端界面/桌面应用/IDE 扩展三种使用形态，支持任意 LLM 提供商
- [[OpenCode Zen]]：OpenCode 官方维护的精选模型列表，经过团队测试和验证，推荐新手使用
- [[Vibe-Kanban]]：看板式任务管理工具，与 OpenCode 配合实现 AI 驱动的项目管理工作流

## Connections
- [[如何在ubuntu上安装opencode并配置vibe-kanban]] ← 安装指南 ← [[github-上-5000-人收藏的-vibe-coding-神级指南]]
- [[OpenCode]] ← 安装与配置 ← [[如何在ubuntu上安装opencode并配置vibe-kanban]]
- [[Vibe-Kanban]] ← 配置指南 ← [[在ubuntu上安装vibe-kanban]]

## Contradictions
- 与 [[github-上-5000-人收藏的-vibe-coding-神级指南]]：
  - 冲突点：Agent 选择与工作流设计
  - 当前观点：本篇聚焦 OpenCode 单一工具的完整使用流程
  - 对方观点：综合指南涵盖多种 Agent（Claude Code、Cursor 等）及其协作方式
  - 结论：两者互补，本篇为工具安装使用指南，对方为 Vibe Coding 理念与多工具对比