Clausona 账号配置管理器
用一个命令切换 Claude Code 与 Codex CLI 账号,同时共享各自工具的配置。
- Star 数
- ★ 50
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 74/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex · Claude CodeClaude API(部分支持)
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 在一台电脑上同时使用个人和工作 Claude Code 账号、希望分别保留登录和会话历史的开发者。
- 不适合
- 只使用 Codex API 配置文件的用户
- 需要 Codex API 端点配置文件的团队
- 源码审查
- 74/100 · 存在缺口
这个 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 修复损坏的共享链接。
- 在一台电脑上同时使用个人和工作 Claude Code 账号、希望分别保留登录和会话历史的开发者。
- 需要在多个 OpenAI Codex CLI 账号间切换,又不想手动搬动
CODEX_HOME的开发者。 - 希望不同账号共用同一工具的插件、技能、钩子和设置的个人开发者或团队成员。
- 想在切换前比较各账号 Claude 或 Codex 计划额度剩余情况的用户。
- 需要用
clausona run在不同终端并行启动不同账号会话的开发者。 - 想让 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 | bashirm 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?
查看各维度的扣分理由
README 说明配置目录、凭据、会话历史、共享文件、配额查询及更新检查的边界,也指出 API 密钥的提示、stdin、Keychain/本地文件和环境或命令来源;这些具体说明支持数据流透明度满分。切换按需执行,更新默认询问,移除配置保留目录,且文档提供分离会话和修复命令,支持适度的最小权限、确认和恢复分数。依赖清单虽列出版本,但所给材料没有漏洞审查或缓解证据;发布者身份未知,仓库只说明贡献入口,不能确认维护者身份或更新责任,因此相应分数较低。
README 对账户隔离、共享配置、平台差异及网络行为给出较一致的描述;CI 文件列出 lint、类型检查、测试、构建和 bundle 冒烟检查,Superset 插件测试也覆盖错误、令牌脱敏及删除保护。这些是仓库中的检查材料,不代表本次执行。部分可靠性主张仍主要由文档陈述,所给源文件没有核心实现,因此自洽性和依赖可用性未给满分;错误状态有示例,但没有足够材料证明所有路径都有清晰提示。
README 面向在一台机器上使用多个 Claude Code 或 Codex 账户的人,涵盖个人、工作、组织、API 端点、并行会话、Superset 和配额查看等情境。它明确限定 Codex 不支持 API 配置、Windows 的链接行为以及部分历史共享差异,边界说明充分。触发方式主要靠显式命令和 shell hook,但 API 配置首次会话的密钥确认以及环境变量导致 hook 让步等情形表明触发细节仍有复杂度;平台和运行环境说明丰富,但没有核心实现可核对兼容行为。
README 以安装、快速开始、功能、工作原理、命令、FAQ 和限制组织内容,提供多个操作示例及详细平台说明;MIT 许可证文本完整。包版本标为 0.5.1-beta,CI 包含跨平台检查,但所给材料没有变更日志,版本演进证据薄弱。贡献入口存在,不过未提供清晰的维护责任或已验证发布者身份,因此维护责任仅部分明确。
命令行、JSON 列表、交互仪表盘和用量视图能让用户选择账户并查看配额;按账户隔离登录、共享设置及可选共享历史解决了具体重复配置问题。README 也说明安装 Node.js、配置 shell hook、处理密钥以及 Windows 链接限制所需的成本,因此效益较明确;不过首次配置和跨平台限制仍带来额外操作,所给材料没有核心实现或实际运行证据来证明全部收益。
README 对命令、数据目录、凭据来源、限制和网络调用给出较细的可追溯描述;CI 和插件测试为若干具体错误处理与保护措施提供了第二类仓库证据。主要产品行为仍缺少所给核心实现文件,README 中的比较内容也注明基于其他项目文档而非独立验证。CI 内容说明了计划检查,但不能据此声称这些检查已经运行或通过;因此只给中等分数。
- 本评估只依据所给静态材料;核心实现未包含在材料中,文档中的安全与兼容性说明无法在此逐项核实。
- API 配置会处理密钥;使用前应确认所选存储方式,并注意 README 所述的 Claude Code 首次会话密钥确认行为。
- Windows 上部分共享文件可能是每账户副本;启用共享前请查看 README 所述的平台限制。
常见问题
Clausona 本身是否收费?
能否在不同账号间恢复对话?
clausona config <profile> --merge-sessions 合并历史;Codex 在 macOS 和 Linux 上支持共享线程存储,Windows 则需通过线程 ID 恢复其他账号的会话。切换账号会共享哪些配置?
claude mcp add 添加的 MCP 服务器保存在各 Claude 配置文件中,不共享。Codex 能使用 API 端点配置文件吗?
Windows 上共享配置有什么限制?
clausona doctor 会报告这一情况。