XylemNode

接入指南

work-buddy

面向知识工作者的本地优先 agent 运行时，跑在 Claude Code 与 MCP 之上，把散落的日志、任务、项目、日程和浏览器标签收成可复用的多步工作流。它自己不直连模型，请求最终都由 Claude Code 发出——把 Claude Code 指向 XylemNode，它的全部工作流就一起走这条通路。

获取 API Key
官网 / 下载
  1. 01

    先备好 Claude Code

    work-buddy 是 Claude Code 的扩展层，唯一的硬性前置就是 Claude Code（命令行版或桌面版都行）。Obsidian 现在只是可选的兼容集成——日志、任务、项目、合约、个人知识和日程都有原生实现，不接笔记库也能完整使用。

    # 确认 Claude Code 已就绪
claude --version
  2. 02

    把 Claude Code 指向 XylemNode

    这一步决定 work-buddy 实际用哪个模型。在 Claude Code 的 settings.json 里填好地址、令牌和模型名；走原生 Anthropic 协议，地址不带 /v1。已经照本页 Claude Code 一节配过的，这步可以跳过。

    {
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xylemnode.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_MODEL": "gpt-5.6-sol"
  }
}
  3. 03

    安装 work-buddy

    到 GitHub releases 下载最新安装包直接运行，它自带 Python（依赖约 1 GB），装完后台服务就已经起来了，同时会加上开始菜单启动项和系统托盘图标。目前只提供 Windows 安装包，macOS 与 Linux 版仍在准备中，这两个平台可先按仓库 CONTRIBUTING 里的 uv 方式从源码装。

    安装包
    github.com/KadenMc/work-buddy/releases/latest
    MCP 网关
    localhost:5126
    仪表盘
    localhost:5127
  4. 04

    在 Claude Code 里打开并跑引导

    用 Claude Code 打开 work-buddy 的安装目录，它会自动连上本地的 MCP 网关；然后运行引导命令，由 agent 带着你挑要开的功能、接上自己的工具与偏好。

    /wb-setup guided
  5. 05

    日常使用

    常用工作流都是 Claude Code 里的斜杠命令（完整清单在官方 handbook）；后台服务用 wbuddy 命令管理，托盘图标也能启停并直接打开仪表盘。

    # 在 Claude Code 会话里
/wb-morning        # 早间简报、优先级与当日计划
/wb-task-triage    # 批量处理任务收件箱

# 在任意终端
wbuddy status                    # 查看后台服务状态
wbuddy start | stop | restart    # 启停后台服务
wbuddy launch                    # 需要时先启动，再打开仪表盘

三点说明

① 它通过本地 MCP 网关扩展 Claude Code，agent 用 wb_search、wb_run、wb_advance、wb_status 这几个工具发现并执行能力。之后想换模型或换服务商，都在 Claude Code 那一侧改，work-buddy 本身不用重配。 ② 官方的说法是「用你现有的 Claude Code 订阅」——一旦把 ANTHROPIC_BASE_URL 指到 XylemNode，请求就不再走 Anthropic 订阅，而是计入 XylemNode 的 credits。若此前登录过官方账号并出现冲突，先 /logout 再重开。 ③ 它的工作流里例行步骤跑的是普通代码，只在需要判断时才叫模型，但后台小任务仍会频繁触发；想让这些也走同一条通路，就在 Claude Code 配置里补一行 ANTHROPIC_DEFAULT_HAIKU_MODEL 指到同一个模型。另外它目前是 0.x 阶段的 beta 软件，小版本之间可能出现破坏性变更。

常见问题

work-buddy 怎么换模型？Claude Code 里又看不到 wb_ 开头的工具？

它没有自己的模型设置——请求全部由 Claude Code 发出，所以换模型只有一个入口：改 Claude Code 的 settings.json（ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL），改完重开 Claude Code 会话才生效，之后它所有工作流都跟着走 XylemNode。看不到 wb_ 工具，通常是会话开错了目录：官方说明是用 Claude Code 打开 work-buddy 的安装目录，它才会自动连上本地 MCP 网关。后台服务可在任意终端用 wbuddy status 确认，没起来就 wbuddy start。还有一点别忽略：目前只提供 Windows 安装包，macOS 与 Linux 版官方标注为即将推出，这两个平台要先按仓库 CONTRIBUTING 里的 uv 方式从源码装。