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 快捷键。
Descripción del desarrollador (chino)
¿Qué es Belfry?
Detrás de Belfry está appmakes; se trata de software de código abierto para Windows incluido en la categoría Terminales y línea de comandos. Está escrito en Rust.
Instalación y requisitos
El desarrollador ofrece instaladores EXE (NSIS) y MSI para Windows de 64 bits. Se puede instalar solo para el usuario actual, sin permisos de administrador. Admite instalación silenciosa con los parámetros documentados del instalador. Existe un paquete MSI para desplegarlo con directivas de grupo, Intune o Configuration Manager.
Actualizaciones e historial de versiones
La versión actual es la 0.21.13, publicada el 10 de octubre de 2026. El historial llega hasta 5 de septiembre de 2026: 3 versiones, todas enlazadas a los archivos oficiales. La última actualización tiene menos de un mes.
Popularidad y tipos de archivo
El código fuente en GitHub (ChengSoon/belfry-desktop) tiene 26 estrellas. Entre los programas similares figuran PowerShell, Oh My Posh y Tabby.
Descripción del proyecto en GitHub: “跨平台（macOS + Windows）AI 编程终端，托管 Codex / Claude Code 等 CLI Agent。Tauri 2 + Rust + React + xterm.js”
Ventajas / Inconvenientes
Ventajas
- Código abierto: cualquiera puede revisar y compilar el código
- Paquete MSI para despliegues gestionados
- Instalación silenciosa documentada
- Se instala sin permisos de administrador
- Actualizado en los últimos dos meses
Inconvenientes
- Sin versión nativa para ARM64
En resumen: Belfry es un programa de código abierto de la categoría Terminales y línea de comandos, disponible para equipos de 64 bits. Los administradores de sistemas pueden desplegarlo de forma desatendida.
¿Es seguro descargar Belfry?
- El archivo se sirve desde github.com, el dominio del propio desarrollador
- El enlace de descarga usa HTTPS
- Hay un hash SHA256 publicado para verificar el archivo:
AABBBB9A88A0B39799169F9BEC7299A4B6DA43CEB0932E1AE6A8E70A151EE3AA· Abrir el informe de VirusTotal de este hash - El enlace aún no se ha comprobado
- El código fuente es público
- ExeAtlas no aloja, envuelve ni modifica instaladores
Guía relacionada: Cómo comprobar el hash SHA256 de un archivo en Windows
Versiones recientes
Las 3 versiones ›| Versión | Fecha | Tamaño | Archivos |
|---|---|---|---|
| 0.21.13Última | 10 de octubre de 2026 | — | 64 bits MSI64 bits EXE (NSIS) |
| 0.21.8 | 24 de septiembre de 2026 | — | 64 bits MSI64 bits EXE (NSIS) |
| 0.19.0 | 5 de septiembre de 2026 | — | 64 bits MSI64 bits EXE (NSIS) |
Instalar desde la línea de comandos
Instalación silenciosa ›winget install --id ChengSoon.Belfry -eBelfry_0.21.13_x64-setup.exe /SGuía relacionada: Cómo usar winget: instalar y actualizar programas
Información
- Desarrollador
- appmakes
- Categoría
- Terminales y línea de comandos
- Licencia
- LGPL-3.0-only
- Precio
- Gratis
- Código fuente
- github.com/ChengSoon/belfry-desktop
- Lenguaje
- Rust
- Requisitos
- Windows 11 / 10
- Arquitectura
- 64 bits
- Instalador
- EXE (NSIS), MSI
- Versión
- 0.21.13
- Fecha de publicación
- 10 de octubre de 2026
- Añadido al catálogo
- 25 de septiembre de 2026
- Versiones registradas
- 3
- Estrellas en GitHub
- 26
- Forks en GitHub
- 3
- Sitio web
- github.com
- ID de winget
- ChengSoon.Belfry
- Código de producto MSI
- {F713EA13-6255-4D8E-9A9B-7FE92380D862}
Valoraciones y opiniones
Todavía no hay opiniones.
Alternativas a Belfry
Ver todo ›-
Código abierto689,6 mil ↓ -
Código abierto820,8 mil ↓ -
Código abierto85,7 mil ↓ -
Código abierto2,1 M ↓ -
Código abierto75,9 mil ↓ -
Código abierto832,7 mil ↓ -
Código abierto5,3 M ↓ -
Código abierto1,5 M ↓
Preguntas frecuentes
¿Es gratis Belfry?
Sí. Belfry es software de código abierto con licencia LGPL-3.0-only.
¿Es seguro descargar Belfry?
La descarga procede de github.com, un dominio del propio desarrollador. ExeAtlas no aloja ni modifica el archivo. Se puede comparar su hash SHA256 con el que aparece aquí o abrir el informe de VirusTotal de ese hash.
¿Cómo instalar Belfry con winget?
Basta con abrir PowerShell o Terminal Windows y ejecutar el comando winget que figura en esta página. winget descarga el instalador oficial y comprueba su hash SHA256 antes de ejecutarlo.
¿Se puede instalar Belfry en modo silencioso?
Sí. La página de instalación silenciosa recoge el comando exacto para cada instalador, incluido msiexec para el paquete MSI.
¿Funciona Belfry en ARM (Windows on Arm)?
No hay versión para ARM64; Windows 11 on Arm puede ejecutar la versión de 64 bits mediante emulación.
¿Dónde descargar versiones anteriores de Belfry?
La página de versiones recoge las 3 versiones con enlaces a sus instaladores oficiales, desde 5 de septiembre de 2026.
¿Se puede usar Belfry sin permisos de administrador?
Sí, existe un instalador por usuario que no necesita permisos de administrador.
¿Qué alternativas hay a Belfry?
PowerShell, Oh My Posh, Tabby, QPDF y Alacritty. La página de alternativas los compara.
