Belfry 是一款支持 macOS 与 Windows 的跨平台终端，用于托管 Codex、Claude Code 等 CLI 编程智能体。它提供项目工作区、Agent 检测与状态跟踪、支持排队的提示词编辑器、服务提供商切换、SSH 会话以及 token 用量统计。没有安装 Agent 时，它依然是一个完整的终端。
功能
项目工作区
- 打开本地目录作为项目，记住最近打开过的
- 侧栏按项目分组，可折叠，宽度可拖拽（⌘B 整体收起）
- 会话自带项目归属，不同会话可以指向不同目录
- Quick Open（⌘K）可搜索并切换会话、打开最近项目或执行常用工作区动作
- 文件预览窗格可浏览当前项目目录，打开只读代码预览；终端输出中的文件路径可直接跳转，并提示磁盘变更
Agent 托管
- 自动检测 Codex 与 Claude Code：可执行文件路径、版本号，不可用时给出原因
- 会话状态区分进程生命周期（创建中/运行/已退出/出错）与当下行为（闲着/正在输出/等你选）
- 标签标题从你的第一句输入里提取，完整原文留在 tooltip
- 协作任务按目标 Agent 分别排队；Agent 忙碌或等待确认时暂缓投递，回到空闲后按顺序发送
活动通知
- 只有两件事值得打断你：Agent 把活干完了，或者它卡在一个非你点头不可的问题上
- 完成通知压 1500 ms 再发。activity 是扫屏幕文本猜出来的，正在输出 → 闲着 → 等你选 这条路很常见（spinner 先消失，权限框隔一拍才画出来），抢在中间发一条「已跑完」就是纯误报
- 你正盯着那条会话看的时候不弹——他已经看见了
- 状态放标题、身份放正文：先判断要不要现在去处理，其次才是哪条会话
- 未读数汇总到 Dock / 任务栏角标，回到应用自动清
Provider 切换
- 在官方端点与第三方中转之间切换 Codex / Claude Code 的路由，改的是 CLI 自己的配置文件，所以在 Belfry 之外直接敲 claude、codex 一样生效
- 精准字段改写：只动 ANTHROPIC_BASE_URL 这类路由键和 [model_providers.belfry] 这张表，你的 hooks、MCP 定义、项目信任记录逐字不动
- 首次打开时把配置文件里已有的设置收编成一条可切回的条目，不会静默覆盖
- 切到三方 provider 前先备份 Codex 的 ChatGPT 登录态，切回官方时原样还原
- 检测会盖过配置文件的 ANTHROPIC_* / OPENAI_* 环境变量并给出提示
终端
- 基于 xterm.js，WebGL renderer——块字符之间没有横缝
- macOS 走 Unix PTY，Windows 走 ConPTY；Shell 依次探测 PowerShell、%ComSpec%、cmd.exe
- SSH 会话直接拉起系统 OpenSSH 客户端：密码、主机指纹、2FA 都在终端里原生交互， ~/.ssh/config 的别名、密钥和 agent 原样继承
- 连接时勾选「记住密码」，密码存进系统钥匙串（macOS Keychain / Windows 凭据管理器）， 之后的连接自动填入；SSH 表单里可随时清除已保存的密码
- OSC 10/11 颜色查询在 Rust 侧直接应答。这件事绕不过去：Codex 这类 TUI 只给 100 ms 窗口，走一圈 PTY → IPC → xterm.js → IPC → PTY 经常超时，而 Windows 上超时的后果不是「没颜色」而是「猜错颜色」——Codex 会退回读 ConPTY 的黑色调色板，把输入框画成黑块
- 密码提示识别，输入不回显
- ⌘F 搜索当前终端内容，支持跨换行匹配；HTTP(S) 地址可点击打开；CJK、组合字符和 emoji 按正确宽度显示
用量统计
- 直接读本地 Codex / Claude 会话日志聚合，不发任何网络请求
- 四类 token 归一口径：input（不含缓存命中）、cachedInput、cacheWrite、output
- 按模型、按项目两个维度拆分；时间窗口可选近 7 天 / 近 30 天 / 全部
- 配额窗口与套餐类型（目前只有 Codex 的日志带这些字段，Claude 的不带）
外观
- 亮/暗主题切换，主题色同步喂给终端调色板
- 全应用字体与 10–20px 字号同步自定义，支持本机已安装字体
- 可导入多个 TTF / OTF / WOFF / WOFF2 字体，分别切换或删除，并可随时切回系统字体
- 内置 JetBrains Mono 与 HarmonyOS Sans SC
Belfry 快捷键：⌘T 新建 Shell，⌘B 折叠侧栏，⌘K 打开 Quick Open，⌘U 开关用量，⌘⇧H 开关历史， ⌘, 打开设置，⌘1–9 切换会话，⌘/ 打开快捷指令。Windows / Linux 统一使用 Ctrl+Shift 组合，避免占用 Codex 与 Claude 的原生 Ctrl 快捷键。
Beskrywing deur die uitgewer (Chinees)
Wat is Belfry?
Belfry van appmakes is Windows-sagteware met oop bronkode (kategorie: Terminale en CLI-gereedskap). Programmeertaal: Rust.
Installasie en vereistes
Die uitgewer verskaf installeerders vir 64-bis Windows (EXE (NSIS) en MSI). Dit kan net vir die huidige gebruiker geïnstalleer word, sonder administrateurregte. ’n Stil installasie is moontlik met die gedokumenteerde skakelaars van die installeerder. ’n MSI-pakket is beskikbaar vir ontplooiing met Groepbeleid, Intune of Configuration Manager.
Bywerkings en weergawegeskiedenis
Die nuutste weergawe is 0.21.13, vrygestel op 10 Oktober 2026. Die weergawegeskiedenis strek terug tot 05 September 2026: 3 vrystellings, almal gekoppel aan die amptelike lêers. Die laaste bywerking is minder as ’n maand oud.
Gewildheid en lêertipes
Die bronkode op GitHub (ChengSoon/belfry-desktop) het 26 sterre. Soortgelyke programme sluit PowerShell, Oh My Posh en Tabby in.
Projekbeskrywing op GitHub: “跨平台（macOS + Windows）AI 编程终端，托管 Codex / Claude Code 等 CLI Agent。Tauri 2 + Rust + React + xterm.js”
Voordele / Nadele
Voordele
- Oopbron: enigeen kan die kode nagaan en self bou
- MSI-pakket vir bestuurde ontplooiing
- Gedokumenteerde stil installasie
- Installeer sonder administrateurregte
- In die afgelope twee maande bygewerk
Nadele
- Geen inheemse ARM64-weergawe nie
Kortliks: Belfry is ’n oopbronprogram in die kategorie Terminale en CLI-gereedskap vir 64-bis rekenaars. Administrateurs kan dit onbewaak ontplooi.
Is dit veilig om Belfry af te laai?
- Die lêer word bedien deur github.com, die uitgewer se eie domein
- Die aflaaiskakel gebruik HTTPS
- ’n SHA256-hashwaarde is gepubliseer, sodat die lêer nagegaan kan word:
AABBBB9A88A0B39799169F9BEC7299A4B6DA43CEB0932E1AE6A8E70A151EE3AA· Maak die VirusTotal-verslag vir hierdie hashwaarde oop - Die skakel is nog nie nagegaan nie
- Die bronkode is openbaar
- ExeAtlas huisves, omvou of verander geen installeerders nie
Verwante gids: Hoe om ’n lêer se SHA256-hashwaarde op Windows na te gaan
Onlangse weergawes
Al 3 weergawes ›| Weergawe | Datum | Grootte | Lêers |
|---|---|---|---|
| 0.21.13Nuutste | 10 Oktober 2026 | — | 64-bis MSI64-bis EXE (NSIS) |
| 0.21.8 | 24 September 2026 | — | 64-bis MSI64-bis EXE (NSIS) |
| 0.19.0 | 05 September 2026 | — | 64-bis MSI64-bis EXE (NSIS) |
Installeer vanaf die opdragreël
Stil installasie ›winget install --id ChengSoon.Belfry -eBelfry_0.21.13_x64-setup.exe /SVerwante gids: Hoe om winget te gebruik: programme installeer en bywerk
Inligting
- Uitgewer
- appmakes
- Kategorie
- Terminale en CLI-gereedskap
- Lisensie
- LGPL-3.0-only
- Prys
- Gratis
- Bronkode
- github.com/ChengSoon/belfry-desktop
- Geskryf in
- Rust
- Vereis
- Windows 11 / 10
- Argitektuur
- 64-bis
- Installeerder
- EXE (NSIS), MSI
- Weergawe
- 0.21.13
- Vrygestel
- 10 Oktober 2026
- By die katalogus gevoeg
- 25 September 2026
- Weergawes gelys
- 3
- GitHub-sterre
- 26
- GitHub-vurke
- 3
- Webwerf
- github.com
- winget-ID
- ChengSoon.Belfry
- MSI-produkkode
- {F713EA13-6255-4D8E-9A9B-7FE92380D862}
Graderings en resensies
Nog geen resensies nie. Wees die eerste om dit te gradeer.
Alternatiewe vir Belfry
Sien alles ›-
Oopbron689,6 k ↓ -
Oopbron820,8 k ↓ -
Oopbron85,7 k ↓ -
Oopbron2,1 m ↓ -
Oopbron75,9 k ↓ -
Oopbron832,7 k ↓ -
Oopbron5,3 m ↓ -
Oopbron1,5 m ↓
Algemene vrae
Is Belfry gratis?
Ja. Belfry is oopbronsagteware onder die LGPL-3.0-only-lisensie.
Is dit veilig om Belfry af te laai?
Die aflaai kom van github.com, wat aan die uitgewer behoort; ExeAtlas huisves of verander nie die lêer nie. Vergelyk die SHA256-hashwaarde daarvan met die een wat hier gewys word, of maak die VirusTotal-verslag vir daardie hashwaarde oop.
Hoe installeer ek Belfry met winget?
Maak PowerShell of Windows Terminal oop en voer die winget-opdrag op hierdie bladsy uit. winget laai die amptelike installeerder af en gaan die SHA256-hashwaarde na voordat dit uitgevoer word.
Kan Belfry stil geïnstalleer word?
Ja. Die bladsy oor stil installasie gee die presiese opdrag vir elke installeerder, insluitend msiexec vir die MSI-pakket.
Werk Belfry op ARM (Windows on Arm)?
Daar is geen ARM64-weergawe nie; Windows 11 on Arm kan die 64-bis-weergawe via emulasie laat loop.
Waar kan ek ’n ouer weergawe van Belfry aflaai?
Die weergawebladsy lys al 3 weergawes met skakels na hul amptelike installeerlêers, terug tot 05 September 2026.
Kan Belfry sonder administrateurregte gebruik word?
Ja, daar is ’n installeerder per gebruiker wat nie administrateurregte nodig het nie.
Wat is alternatiewe vir Belfry?
PowerShell, Oh My Posh, Tabby, QPDF en Alacritty. Die bladsy met alternatiewe vergelyk hulle.
