CodexBar 插件安装 3 步上手：用本地 JS/TS 文件扩展用量统计

CodexBar 插件安装 3 步上手用本地 JS/TS 文件扩展用量统计【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBarCodexBar 是一款无需登录即可查看 OpenAI Codex 与 Claude Code 用量统计的菜单栏应用它的插件系统让你用单个本地 JavaScript/TypeScript 文件接入任意自建或第三方服务的用量数据覆盖内置提供程序之外的统计需求。插件系统解决什么问题CodexBar 内置大量提供程序在 ProviderCatalog 中集中注册涵盖 ClawRouter、OpenRouter、xAI、Poe、Venice 等。但当你要统计的是自建网关、私有 LLM Proxy或某个不在内置列表里的服务时需要插件系统。一个插件就是一个本地文件在清单manifest里声明完整的网络权限和配置项通过 CodexBar 的沙箱宿主 API 发起请求返回统一的用量快照。CodexBar 会在菜单栏为它渲染一张通用的用量卡片——百分比进度条、重置时间、费用、详情行、图表都在 plugins.md 里列出了字段约定。最短安装路径插件只支持本地文件没有远程目录也不下载任何插件代码源码上限 1 MiB。三种安装方式任选其一打开 CodexBar进入Settings → Plugins点击 Install… 按钮选择一个.js或.ts文件CodexBar 会把它复制进插件目录~/.config/codexbar/providers/。直接把文件拷入~/.config/codexbar/providers/重启或在 Plugins 面板点击 Refresh。在 插件注册入口 对应面板中用 Show in Finder 按钮直接打开该目录拖入文件即可。写入后 CodexBar 会先离线校验源码与清单不联网、不给文件/cookie/密钥权限校验通过才进入下一步。审批插件网络权限的最后一道关校验通过后会出现审批面板approval sheet列出该插件精确的归一化域名、认证方式、能力、机密配置名和 cookie 域名。这里最容易卡住如果插件声明了 loopback、IP 字面量或.local域你需要把每个归一化 origin逐字输入后才可批准审批记录独立存放在~/Library/Application Support/CodexBar/plugin-approvals.json插件文件改了 instance ID、域名、认证头、能力或 cookie 域名原审批立即失效需要重新批准没有批量审批或导入通道这是有意的设计。批准并填入配置后启用插件其刷新结果就会出现在通用菜单卡片中。若插件声明了browser-cookies能力需要系统钥匙串权限允许 CodexBar 从 Chrome 读取 cookie可参考 docs/keychain-allow.png 中的授权界面。在 CLI 中运行与管理插件插件同时支持 macOS 应用与 macOS/Linux 的 CLI适合脚本和 CI 场景。CLI 提供两条命令codexbar plugins list # 列出本地发现的插件及校验错误 codexbar plugins fetch id --json # 拉取某插件的用量快照list会同时显示校验失败的插件及原因fetch在非交互终端重定向或无头环境遇到未审批的插件会直接失败关闭且 browser-cookie 插件只支持 AppCLI 下同样失败关闭。删除插件用 Settings → Plugins 面板中的 Delete…CodexBar 会一并清理插件文件、TypeScript 缓存、审批记录、实例配置/密钥和历史用量。进阶写一个最小插件最小插件只需一次defineProvider调用。完整契约字段、ctxAPI、快照结构见类型定义文件 codexbar-plugin.d.ts内置插件的现成示例在 Sources/CodexBarCore/Resources/Plugins/如clawrouter.js、openrouter.js。几个硬约束值得提前知道沙箱基于 QuickJSApple 平台可切回 JavaScriptCore没有浏览器/Node 环境无fetch、无require、无定时器、无文件系统Intl在 QuickJS 下不可用认证头由宿主持有插件无法覆盖机密配置secure类型通过ctx.settings.getSecret读取CLI 场景可用环境变量CODEXBAR_PLUGIN_ID_KEY覆盖请求默认 15 秒超时、响应上限 1 MiB、拒绝重定向宿主对 408/429/5xx 自动重试一次声明http-status能力后由插件自己处理快照至少返回一个 rate window、cost 对象、details 区块或 identity 字段百分比自动钳制到 0–100。TypeScript 插件会被内置 Sucrase 转译转译产物缓存在~/Library/Caches/CodexBar/plugins/源文件不变即为缓存命中。避坑要点插件视同本地运行的代码——读一遍 manifest 和源码再批准不要装来路不明的文件批准后 DNS 变更不在 CodexBar 威胁模型内。id不能与内置提供程序或其他已装插件重名否则校验失败。渲染面只支持通用快照和声明式 details插件不出现在 widget、状态源、token 账户、OAuth、本地成本扫描器等仅内置提供程序可用的位置也没有从未知 ID 回退到内置提供程序的兼容路径。官方文档入口插件编写与安装、内置 JS 提供程序原型、CLI 安装。【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考