领取体验码

从源码运行 AASC

在 macOS、Windows 或 Linux 上使用 Node.js 22.12 及更新版本从源码运行服务，再通过浏览器访问与桌面应用相同的控制面板。

紧凑看板：四列九张会话卡片，其中两个等待处理。

紧凑看板：四列九张会话卡片，其中两个等待处理。

安装

需要 Node.js 22.12 及更新版本、Git，以及 Claude Code 或 Codex CLI（0.130 及更新版本）。macOS 和 Linux 还需安装 jq，供钩子将事件匹配到正确终端。

$git clone https://github.com/coding-by-feng/ai-agent-session-center.git$cd ai-agent-session-center$npm install$npm rebuild better-sqlite3 node-pty$npm run build$npm start

npm rebuild 会为当前 Node 版本构建两个原生模块。若失败，请安装编译工具：macOS 使用 Xcode Command Line Tools， build-essential 用于 Linux，Windows 使用 Visual Studio Build Tools。

后续更新时，先运行 git pull，再运行 npm install， npm run build 以及 npm start。

首次运行

启动服务
npm start 每次启动都会为 Claude Code（以及已启用的 Codex）注册钩子，并在浏览器中打开 http://localhost:3333 。
启动 AI 工具
在终端中启动 claude 或 codex，会话随后会出现在 LIVE 看板。
打开会话
点击会话，查看终端、对话、项目文件、笔记与队列。

常用命令

npm start: 构建后启动服务，控制面板位于 localhost:3333。
npm start -- --port 4444: 指定其他端口，例如同时运行第二个实例。
npm run set-password: 设置其他设备登录使用的密码。
npm run uninstall-hooks: 移除 Claude Code 与 Codex 设置中的 AASC 钩子。
npm run reset: 备份后移除钩子，并删除历史与设置。

从其他设备访问

先用 npm run set-password，设置密码，再在其他设备上打开 http://<电脑地址>:3333 。未设置密码时，仅本机可访问。

会话只有在共享后才对其他设备可见，手机浏览器会使用适合手机的布局：查看手机指南。