Vibe Kanban 全局设置怎么配：环境变量和代理参数一步到位

Vibe Kanban 全局设置怎么配：环境变量和代理参数一步到位

【免费下载链接】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 这类编程代理。想换 API 地址、调权限、加工具，都去全局设置里改。改完对之后的任务生效。

前置准备

• 已安装并登录 Vibe Kanban
• 本机装好至少一个编程代理
• 第三方 API 的密钥已申请
• 走远程场景时 SSH 免密已配好

🔧 分步操作

1. 打开设置页，看默认配置

在 Workspaces 界面点齿轮图标，进入设置。

通用设置：主题、默认代理、编辑器

• 主题（Theme）：选浅色或深色
• 默认代理（Default Coding Agent）：新建任务默认用哪个代理
• 变体（Variant）：该代理下默认选中的配置

如果每次建任务都要手动换代理，就检查这一项，创建任务时会预选中。

2. 给代理新建一个配置变体

进入设置里的 Agents 页，点配置列表旁的加号。

左侧选代理，右侧管理它的配置变体

• 配置名称（Configuration Name）：如PRODUCTION、DEVELOPMENT
• 沙盒策略（Sandbox）：Codex 可选read-only、workspace-write
• 审批级别（Approval）：untrusted、on-failure、never等
• Default 徽标：点一下，把该变体设为默认

如果只想复制现有配置改一部分，就用 Clone from 选个模板。

3. 在配置里加环境变量

打开刚建的变体，找到「环境变量（Environment Variables）」区域。

每行 KEY 和 value 都注入到代理进程

• ANTHROPIC_BASE_URL：第三方 API 地址
• ANTHROPIC_AUTH_TOKEN：对应的 API 密钥
• 覆盖规则：配置里的变量优先于 shell 里的同名变量

如果代理报鉴权失败，就检查密钥是否复制完整。

4. 给代理挂上 MCP 服务器

进入 Settings 的 MCP Servers 页，选中目标代理。

JSON 编辑器直接改该代理的 MCP 配置

• Agent 下拉框：MCP 配置按代理分开存储
• Server Configuration JSON：添加mcpServers条目
• Save Settings：点保存后写入代理的全局配置

如果 JSON 报错，就先删掉刚加的条目再检查格式。

🚀 进阶调优

用第三方 API 跑 Claude Code

给 Claude Code 单独建一个变体，比如叫OPENROUTER。

把 Claude Code 指向 OpenRouter 地址

环境变量里填三行：ANTHROPIC_BASE_URL填https://openrouter.ai/api，ANTHROPIC_AUTH_TOKEN填你的密钥，再把ANTHROPIC_API_KEY置为空字符串。

最后一行不能省。置空后 Claude Code 才放弃官方地址，不会回落到 Anthropic。

远程 SSH 打开编辑器

Vibe Kanban 部署在服务器、代码也在服务器上时，配 SSH 远程打开编辑器。

仅 VS Code、Cursor、Windsurf 支持远程 SSH

在 General 的 Editor 区域填Remote SSH Host，写服务器地址。点「Open in Editor」时，本地编辑器通过 SSH 连上去打开项目。

一键装热门 MCP 服务器

MCP Servers 页提供热门服务器卡片，点一下就插入现成的 JSON 配置。

Playwright、Context7 等常用模板

适合 Playwright（浏览器自动化）、Context7（查文档）这类常用工具。装完点Save Settings生效。

⚠️ 避坑清单

• 现象：代理还是走官方 API 地址原因：没把ANTHROPIC_API_KEY置空，Claude Code 回落官方解法：环境变量里显式设ANTHROPIC_API_KEY=""
• 现象：加了 MCP 服务器不生效原因：只改了 JSON，没点保存解法：点Save Settings，再看代理日志确认
• 现象：代理变慢、工具选择变差原因：一个代理挂了太多 MCP 服务器解法：每个代理只留 2~3 个常用的
• 现象：代理删了不该删的文件原因：开了dangerously_skip_permissions跳过所有确认解法：日常用审批模式，只在受信任环境放开

全局设置核心就三块：默认值在 General，行为参数在 Agents，工具扩展在 MCP Servers。详细参数见 全局设置说明、代理配置 和 MCP 服务器。

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