Clausona 账号配置管理器

用一个命令切换 Claude Code 与 Codex CLI 账号,同时共享各自工具的配置。

Star 数
★ 50
最近更新
今天
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具
可在哪里用
平台专用Codex · Claude CodeClaude API(部分支持)
上手难度
低 · 几分钟可跑通
开始前需要
Node.js >= 20Claude Code CLI 或 OpenAI Codex CLIWindows 上的 PowerShell 5.1+,或 macOS/Linux 上的 zsh 或 bashShell / 命令行网络访问本地文件系统MCP Server
典型场景
在一台电脑上同时使用个人和工作 Claude Code 账号、希望分别保留登录和会话历史的开发者。
不适合
  • 只使用 Codex API 配置文件的用户
  • 需要 Codex API 端点配置文件的团队

这个 Agent 能做什么,适合哪些场景?

Clausona 是面向 Claude Code 和 OpenAI Codex CLI 的本地命令行配置管理器,提供 `clausona`(以及安装时注册的 `csn`)和交互式终端仪表盘。每个账号使用独立配置目录保存登录信息与会话历史,shell hook 在启动 `claude` 或 `codex` 时设置对应的环境变量,再运行原始 CLI。插件、技能和设置等配置会在同一工具的配置目录之间共享,且可选择共享会话历史。命令行和仪表盘可查看账号的 5 小时与每周计划额度,也支持本地 Claude Code 用量记录和健康检查。它运行在用户的 macOS、Linux 或 Windows 机器上,不依赖常驻服务;配额查询和更新检查等功能会访问网络。

安装要求 Node.js >= 20,并至少安装 Claude Code CLI 或 OpenAI Codex CLI。运行 clausona init 会发现并登记已登录的账号;之后可用 clausona add 创建配置文件、用 clausona use <profile> 选择当前配置,或用 clausona run <profile> 在不切换当前选择的情况下启动某个账号。安装器提供的 shell hook 为每次 claude 或 codex 启动设置 CLAUDE_CONFIG_DIR 或 CODEX_HOME,再执行未修改的原始命令。Clausona 用链接共享各工具的指定配置,并按选项保留各账号的会话历史或合并历史;clausona list 和仪表盘读取 Claude 与 Codex 各自的用量端点以显示计划额度,clausona doctor 检查配置健康状况,clausona repair 修复损坏的共享链接。

  1. 在一台电脑上同时使用个人和工作 Claude Code 账号、希望分别保留登录和会话历史的开发者。
  2. 需要在多个 OpenAI Codex CLI 账号间切换,又不想手动搬动 CODEX_HOME 的开发者。
  3. 希望不同账号共用同一工具的插件、技能、钩子和设置的个人开发者或团队成员。
  4. 想在切换前比较各账号 Claude 或 Codex 计划额度剩余情况的用户。
  5. 需要用 clausona run 在不同终端并行启动不同账号会话的开发者。
  6. 想让 Claude Code 配置文件使用 Anthropic API、网关或自托管模型端点的用户。

如何安装或部署这个 Agent?

需要 Node.js >= 20,以及至少一个 Claude Code CLI 或 OpenAI Codex CLI。macOS/Linux 支持 zsh 或 bash;Windows 需要 PowerShell 5.1 或更高版本。使用对应安装命令:

curl -fsSL https://github.com/larcane97/clausona/releases/latest/download/install.sh | bash
irm https://github.com/larcane97/clausona/releases/latest/download/install.ps1 | iex

如果两种 CLI 都尚未登录,先运行 claude login 或 codex login。若通过 Node 版本管理器安装 Node,运行 macOS/Linux 安装命令前需先在当前 shell 激活 Node。

如何使用这个 Agent?

初始化并登记已有账号:

clausona init

切换到配置文件、查看所有账号及额度,或打开交互式仪表盘:

clausona use work
clausona list
clausona

添加另一个 Codex 账号并切换:

clausona add codex:work
clausona use codex:work

若要为 Claude Code 添加 API 配置文件,需已有 Claude 登录账号,并提供端点;密钥可由隐藏输入提示或标准输入获取:

clausona add claude:gw --api --base-url https://openrouter.ai/api
clausona use claude:gw

这个 Agent 有哪些优点和局限?

优点
  • 同时管理 Claude Code 与 Codex CLI 账号,分别保留各自登录凭据。
  • 通过配置链接共享插件、技能、钩子和设置,减少逐个账号重复配置。
  • 可查看每个账号的 5 小时与每周计划额度,并提供 --refresh 和 --no-quota 选项。
  • 支持按配置文件运行账号而不改变当前选择,也提供交互式终端仪表盘和健康检查。
  • Claude Code 可使用 API 端点配置文件,覆盖 Anthropic API、网关和自托管模型端点。
局限
  • 需要 Node.js >= 20 和至少一个已安装的 Claude Code CLI 或 OpenAI Codex CLI。
  • API 配置文件目前只适用于 Claude Code,且添加 API 配置文件前仍需至少登录一次 Claude Code。
  • Claude 使用 claude mcp add 添加的 MCP 服务器保存在各自账号配置中,不会随共享插件配置同步。
  • Codex 会话历史共享仅在 macOS 和 Linux 上支持;Windows 上只能通过会话 ID 恢复其他账号的线程。
  • 配额显示与更新检查需要网络;文档未说明使用 CLI 及其订阅账号的费用。

这个 Agent 与同类方案有什么区别?

README 将 Clausona 与 claude-swap、codex-auth、aisw 和 claude-code-profiles 对比:其列出的差异包括同时支持 Claude Code 与 Codex CLI、按账号保留历史并共享插件和设置,以及展示每个账号的计划额度。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Clausona 账号配置管理器 当前 74 · 存在缺口 命令行工具 ★ 50 今天 TypeScript Codex · Claude Code
Herdr 智能体终端运行环境 49 · 缺口较多 命令行工具免费 ★ 43k 1 天前 Rust —
Jean 桌面 AI 开发助手 47 · 缺口较多 桌面应用免费 + 模型费 ★ 1.3k 今天 TypeScript Codex · Claude Code · OpenAI API · Claude API
AGF 本地编码会话查找器 96 · 表现优秀 命令行工具免费 ★ 157 8 天前 Rust Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
存在缺口
74/ 100 五分制 3.7 / 5
信任安全 18/29
可靠稳定 9/14
适用触发 15/18
规范维护 15/18
有效结果 12/13
证据核验 5/8
查看各维度的扣分理由
信任安全18 / 29 · 3.1/5

README 说明配置目录、凭据、会话历史、共享文件、配额查询及更新检查的边界,也指出 API 密钥的提示、stdin、Keychain/本地文件和环境或命令来源;这些具体说明支持数据流透明度满分。切换按需执行,更新默认询问,移除配置保留目录,且文档提供分离会话和修复命令,支持适度的最小权限、确认和恢复分数。依赖清单虽列出版本,但所给材料没有漏洞审查或缓解证据;发布者身份未知,仓库只说明贡献入口,不能确认维护者身份或更新责任,因此相应分数较低。

可靠稳定9 / 14 · 3.2/5

README 对账户隔离、共享配置、平台差异及网络行为给出较一致的描述;CI 文件列出 lint、类型检查、测试、构建和 bundle 冒烟检查,Superset 插件测试也覆盖错误、令牌脱敏及删除保护。这些是仓库中的检查材料,不代表本次执行。部分可靠性主张仍主要由文档陈述,所给源文件没有核心实现,因此自洽性和依赖可用性未给满分;错误状态有示例,但没有足够材料证明所有路径都有清晰提示。

适用触发15 / 18 · 4.2/5

README 面向在一台机器上使用多个 Claude Code 或 Codex 账户的人,涵盖个人、工作、组织、API 端点、并行会话、Superset 和配额查看等情境。它明确限定 Codex 不支持 API 配置、Windows 的链接行为以及部分历史共享差异,边界说明充分。触发方式主要靠显式命令和 shell hook,但 API 配置首次会话的密钥确认以及环境变量导致 hook 让步等情形表明触发细节仍有复杂度;平台和运行环境说明丰富,但没有核心实现可核对兼容行为。

规范维护15 / 18 · 4.2/5

README 以安装、快速开始、功能、工作原理、命令、FAQ 和限制组织内容,提供多个操作示例及详细平台说明;MIT 许可证文本完整。包版本标为 0.5.1-beta,CI 包含跨平台检查,但所给材料没有变更日志,版本演进证据薄弱。贡献入口存在,不过未提供清晰的维护责任或已验证发布者身份,因此维护责任仅部分明确。

有效结果12 / 13 · 4.6/5

命令行、JSON 列表、交互仪表盘和用量视图能让用户选择账户并查看配额;按账户隔离登录、共享设置及可选共享历史解决了具体重复配置问题。README 也说明安装 Node.js、配置 shell hook、处理密钥以及 Windows 链接限制所需的成本,因此效益较明确;不过首次配置和跨平台限制仍带来额外操作,所给材料没有核心实现或实际运行证据来证明全部收益。

证据核验5 / 8 · 3.1/5

README 对命令、数据目录、凭据来源、限制和网络调用给出较细的可追溯描述;CI 和插件测试为若干具体错误处理与保护措施提供了第二类仓库证据。主要产品行为仍缺少所给核心实现文件,README 中的比较内容也注明基于其他项目文档而非独立验证。CI 内容说明了计划检查,但不能据此声称这些检查已经运行或通过;因此只给中等分数。

风险与缓解建议
  • 本评估只依据所给静态材料;核心实现未包含在材料中,文档中的安全与兼容性说明无法在此逐项核实。
  • API 配置会处理密钥;使用前应确认所选存储方式,并注意 README 所述的 Claude Code 首次会话密钥确认行为。
  • Windows 上部分共享文件可能是每账户副本;启用共享前请查看 README 所述的平台限制。
证据充分度:低 评估于 2026年10月9日 审查版本 085e7303d61c 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →

常见问题

Clausona 本身是否收费?
README 标注 MIT 许可证,但没有说明使用 Claude Code 或 Codex CLI 所需账号、订阅或 API 的费用,因此无法据此确定整体使用成本。
能否在不同账号间恢复对话?
可以选择共享会话历史。Claude Code 可通过 clausona config <profile> --merge-sessions 合并历史;Codex 在 macOS 和 Linux 上支持共享线程存储,Windows 则需通过线程 ID 恢复其他账号的会话。
切换账号会共享哪些配置?
插件、技能和指定设置会在同一工具的配置文件间共享;登录信息始终按账号隔离。用 claude mcp add 添加的 MCP 服务器保存在各 Claude 配置文件中,不共享。
Codex 能使用 API 端点配置文件吗?
目前不支持。README 说明 API 配置文件仅适用于 Claude Code。
Windows 上共享配置有什么限制?
Windows 使用 PowerShell 5.1 或更高版本。启用 Developer Mode 后才能创建共享文件符号链接;否则部分整体写入的文件会作为每账号副本保留,clausona doctor 会报告这一情况。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents