企业官网建设流程全解析

Vibe Kanban全局设置指南：从首次启动到多代理并行，5处关键配置

【免费下载链接】vibe-kanbanGet 10X more out of Claude Code, Codex or any coding agent项目地址: https://gitcode.com/GitHub_Trending/vi/vibe-kanban

Vibe Kanban 的核心场景是让 Claude Code、Codex 等多个编码代理同时干活，而全局设置页面是新手最容易卡住的地方。这篇文章沿着真实使用路径，把需要动过的配置讲一遍：启动、配代理、加工具、远程接入，以及排错时去哪里找答案。

🚀 第一次运行：onboarding 默认值决定了什么

这一节解决"刚装好该先选什么"的问题。

用npx vibe-kanban启动后，首次会依次问你三件事：默认编码代理、IDE、通知方式。这些都不是定死的，之后随时能在 Settings → General 改。General 页放的是应用级配置：主题与语言、默认代理及其变体、编辑器、git 分支前缀、通知音效。

有两个选项值得多看一眼。分支前缀决定工作区自动创建分支的命名风格，比如前缀填vk，分支就叫vk/1a2b-implement-auth。工作区目录决定 worktree 存到哪里，改完需要重启应用，所以建议一次想清楚，避免以后找不到工作区。

🤖 沙盒与变体怎么选：把代理管住

这一节解决"同一个代理，为什么想让它表现得不一样"的问题。

Settings → Agents 是双栏界面：左边列代理，右边列它的配置变体。一个变体就是一组可整体切换的参数，比如复杂任务开规划模式、快速修复换更快的模型、审查代码时保留审批。配好的变体会出现在聊天输入栏的工具栏里，发起任务前点一下就能换。

沙盒权限以 Codex 为例分三档：read-only只能读、workspace-write可改项目内文件、danger-full-access无限制。日常用中间档就够，它让代理动得了代码但碰不到系统其余部分。带dangerously_前缀的开关会跳过确认提示，属于最后一道保险丝，别当常规项。

环境变量是每个变体自带的：填在配置表单里，启动时注入代理进程，且会覆盖你 shell 里已有的同名变量。想接第三方接口，新建一个变体配ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN即可，原来的默认配置原封不动，两个提供方来回切不用动 shell。

🔌 接入开发工具：MCP 模板与仓库脚本

这一节解决"让代理会开浏览器、会装依赖"的问题。

MCP Servers 页按代理组织：选中一个代理，下面是一排热门服务器卡片，点一下就把对应 JSON 填进配置；要加自己的，直接编辑mcpServers的 JSON。注意保存后写的是该代理的全局配置文件，脱离 Vibe Kanban 它也在。另一个容易踩的点：服务器别堆太多，工具一多，代理选错工具的概率明显上升。

仓库层面的自动化在 Projects 和 Repositories 选项卡，三个脚本最实用：dev server 命令，供内置预览浏览器显示运行中的应用；setup 脚本，代理开工前跑一次，比如装依赖；cleanup 脚本，工作区关闭时回收容器、清产物。cleanup 建议写成幂等的，命令后面挂|| true，保证重复执行不报错。

📱 手机配对与 SSH 编辑器：远程协作

这一节解决"人不在电脑旁，任务怎么办"的问题。

Remote Access 选项卡里点 Show pairing code 生成配对码，在手机浏览器登录云端页面，把主机设备和配对码填进去，之后手机上就能列出并操作那台主机上的工作区。

另一种远程场景是 Vibe Kanban 跑在服务器上、你的编辑器在本地：在 Editor 设置里填 Remote SSH Host，点"打开编辑器"时会生成远端 SSH 链接，本地 VS Code 或 Cursor 通过它连到服务器打开项目。前提是ssh user@host能免密登录，先在终端验证一遍再填配置。

🧯 排错清单：代码库为空、看日志与重置

这一节解决"卡住了先看哪里"的问题。

代理报告代码库为空，通常是仓库开了 sparse-checkout，在仓库根目录执行git sparse-checkout disable，再新建任务。想看内部细节，用RUST_LOG=debug npx vibe-kanban启动即可输出调试日志。数据库损坏是最坏情况，可以删掉应用数据目录重置（Linux 在~/.local/share/vibe-kanban），这一步会清空所有任务和设置，别当第一招用。

延伸阅读：General 设置文档、代理配置文档、排错文档。

这五处配好之后，日常基本就是换变体、看板、合代码。改权限和环境变量时，先用一个小任务验证一遍，大部分意外都能提前拦住。

【免费下载链接】vibe-kanbanGet 10X more out of Claude Code, Codex or any coding agent项目地址: https://gitcode.com/GitHub_Trending/vi/vibe-kanban