Skip to content

【开源自荐】Codes CLI - 管理多个 Claude Code 配置的命令行工具 #85

@ourines

Description

@ourines

项目地址

下载地址

项目介绍

Codes CLI 是一个用 Go 语言编写的强大命令行工具,专为需要在多个 Claude API 配置之间切换的开发者设计。

解决的问题

在使用 Claude Code 进行 AI 辅助开发时,开发者可能面临以下问题:

  • 多环境切换困难:在公司网络、家庭网络、或不同代理服务器之间切换时,需要手动修改环境变量
  • 配置管理混乱:多个 API 配置难以统一管理,容易出错
  • 重复安装 CLI:在不同项目中重复安装和配置 Claude CLI
  • 无法快速切换项目:每次需要手动 cd 到项目目录

解决方案

Codes CLI 提供了一站式的配置管理解决方案:

🔧 多配置管理
统一管理所有 Claude API 配置,支持官方 Anthropic、代理或其他提供商。不再需要手动修改环境变量,一次配置,长期使用。

🔄 快速切换
通过交互式选择器在不同配置之间一键切换,选择后自动启动 Claude Code,整个过程流畅快捷。

📁 智能目录管理

  • 自动记住上次工作目录,下次启动直接回到原位
  • 支持为常用项目设置别名,通过 codes my-project 快速启动
  • 管理多个项目,随时切换

📥 环境导入
首次运行时自动检测并导入现有的 Claude 配置环境变量,无需手动迁移,真正的开箱即用。

⚡ 自动化管理

  • 自动安装 Claude CLI(如果未安装)
  • 支持更新到指定版本
  • API 连通性验证,确保配置有效

🌍 跨平台支持
支持 Linux、macOS 和 Windows 操作系统,兼容 amd64 和 arm64 架构,提供预编译的二进制文件。

快速开始

# 下载并安装(以 Linux amd64 为例)
curl -L https://github.com/ourines/codes/releases/latest/download/codes-linux-amd64 -o codes
chmod +x codes
./codes install

# 检查环境(推荐)
codes init

# 添加配置
codes add

# 启动 Claude Code
codes

# 切换配置
codes select

# 管理项目别名
codes project add my-app /path/to/my-app
codes start my-app

适用场景

  • 需要在多个 Claude API 端点之间切换的开发者
  • 使用代理访问 Claude API 的用户
  • 管理多个 AI 项目配置的团队
  • 需要快速切换工作环境的开发者

开源信息

  • 许可证:MIT 开源许可
  • 语言:Go 1.21+
  • 支持平台:Linux/macOS/Windows (amd64 & arm64)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions