realiti4/claude-swap

说明与用途

**项目简介（2‑3 句）**
realiti4/claude‑swap 是一个 Python 小工具，可在同一台机器上快速切换多个 Claude Code 账户，方便开发者在不同项目或团队之间切换身份而无需手动登录/登出。

---

价值点

1. **多账号切换即插即用**：只需一条命令即可在已配置好的 Claude 账户之间切换，省去重复登录的时间和操作错误。
2. **提升工作流连贯性**：在需要分别使用不同 API 额度或不同团队权限的场景（如内部测试、客户演示、跨项目协作）中，保持上下文一致性。
3. **开源透明**：代码量小、依赖少，便于审计和二次定制，适合内部原型或安全合规要求较高的组织。

---

典型接入方式

| 步骤 | 操作 | 说明 |
|------|------|------|
| 1️⃣ | **克隆仓库** git clone https://github.com/realiti4/claude-swap.git | 获取最新代码。 |
| 2️⃣ | **安装依赖** pip install -r requirements.txt | 仅依赖 requests 等常见库，无系统级依赖。 |
| 3️⃣ | **配置账户** 在项目根目录创建 accounts.yaml（或使用环境变量），示例：<br>accounts:<br> - name: dev<br> token: <YOUR_TOKEN_1><br> - name: prod<br> token: <YOUR_TOKEN_2> | 将所有 Claude Code 账户的 API Token 写入，支持名称别名。 |
| 4️⃣ | **切换账户** 运行 python claude_swap.py switch dev 或 claude-swap switch prod（可包装成 CLI） | 当前会话的 Token 会写入 ~/.claude_token（或自定义路径），后续调用 Claude API 时自动使用。 |
| 5️⃣ | **在业务代码中使用** 直接读取 ~/.claude_token，如 os.getenv("CLAUDE_TOKEN")，无需改动已有调用逻辑。 | 只要业务代码从统一位置读取 Token，即可实现无感切换。 |

> **可选**：将 claude-swap 包装为 Docker 镜像或 CI/CD 步骤，在自动化流水线中实现“切换到测试账号 → 运行测试 → 切换回生产账号”的完整闭环。

---

生产可用性评估

| 维度 | 评估 | 说明 |
|------|------|------|
| **成熟度** | **中等**（适用于原型、内部工具） | 项目近期（2026‑06‑23）有更新，星标 616、Fork 61，活跃度尚可，但贡献者主要为单一维护者。 |
| **依赖与维护** | 依赖少（仅 Python 标准库 + requests），代码量小，易于审计。 | 需要自行监控 upstream 是否继续维护，若出现 API 变更需自行更新。 |
| **安全性** | 需要自行审查 Token 存储方式。 | 项目本身不提供加密存储，建议配合 Vault、AWS Secrets Manager 等方案。 |
| **部署成本** | 低 | 只需 Python 环境或轻量容器，无额外服务。 |
| **适用场景** | 原型验证、内部 CI 流、水线测试、跨团队协作。 | 对外公开服务或高并发场景建议自行实现更完整的凭证管理。 |
| **推荐使用方式** | **内部**：在受控网络或 CI 环境中使用；**生产**：若业务对凭证切换有严格合规要求，建议在此基础上实现审计日志和加密存储后再投入。 |

**结论**：realiti4/claude-swap 通过极简的配置即可实现多 Claude Code 账户的快速切换，适合作为内部原型或开发/测试流程的加速器。若要在生产环境大规模使用，建议在其基础上加入安全凭证管理、审计日志以及容错机制后再正式上线。

实际用途

realiti4/claude-swap may be useful when its README and activity match a concrete workflow.

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.