ACM (AI Configuration Manager)
类似 nvm 、nrm 的 AI API 配置切换工具，让您轻松管理和切换多个 Claude API 配置。
特性
- 🚀 一键切换多个 AI API 配置
- 📝 简单的命令行界面
- 🔧 支持添加、删除、列表和当前配置管理
- 💾 自动配置文件管理
- 🔄 环境变量自动设置
- 🌍 多语言支持 (中文/English)
- 🎯 自动语言检测
快速开始
安装方式
方式 1: NPM 全局安装 (推荐)
npm install -g ai-config-manager
方式 2: 手动安装
维护可能不及时
git clone <repository-url>
cd ai-config-manager
./install.sh
基本用法
# 查看所有可用配置
acm list
或 acm ls
# 切换到指定配置
acm use Alias
eg.
acm use openai
# 添加新配置
acm add [Alias] [key] [api url] [type]
type:
key = ANTHROPIC_AUTH_TOKEN
token = ANTHROPIC_BASE_URL
eg.
acm add Claudecode sk-xxx https://api.claudecode.com key
# 删除配置
acm remove Claudecode
# 查看当前配置
acm current
# 切换语言
acm lang en
切换界面语言或显示当前语言。
- 无参数：显示当前语言
- `zh`：切换到中文
- `en`：切换到英文
# 查看帮助
acm help
配置文件
配置文件位于 ~/.claude_config
环境变量
ACM 会自动设置以下环境变量：
ANTHROPIC_AUTH_TOKEN: API 认证令牌ANTHROPIC_BASE_URL: API 基础 URL
多语言支持
ACM 支持中文和英文界面，具有以下特性：
- 自动检测：根据系统环境变量自动选择语言
- 手动切换：使用
acm lang <zh|en>命令切换 - 持久化：语言设置保存在
~/.acm_lang文件 - 实时生效：切换后立即生效，无需重启
语言切换示例
# 查看当前语言
acm lang
# 切换到英文
acm lang en
# 切换到中文
acm lang zh
卸载
NPM 安装的版本
npm uninstall -g ai-config-manager
手动安装的版本
./uninstall.sh
工作原理
- 配置存储: 所有配置存储在
~/.claude_config文件中 - 当前配置跟踪: 当前使用的配置记录在
~/.claude_current文件中(待改进) - 环境变量设置: 使用
acm use命令时自动导出相应的环境变量 - 配置验证: 提供完整的错误处理和配置验证机制
故障排除
如果遇到问题，请检查：
- 配置文件
~/.claude_config是否存在且格式正确 - API 密钥是否有效
- 网络连接是否正常
- 环境变量是否正确设置
使用 acm current 命令可以查看当前配置状态和诊断信息。
NPM 包发布
如果您想发布到 npm：
- 更新
package.json中的包名和仓库信息 - 登录 npm：
npm login - 发布包：
npm publish
开发
本地开发
# 安装依赖
npm install
# 编译 TypeScript
npm run build
# 监听模式编译
npm run dev
# 链接到全局测试
npm link
# 测试命令
acm help
# 取消链接
npm unlink -g ai-config-manager
项目结构
acm/
├── src/ # TypeScript 源代码
│ ├── bin/
│ │ └── acm.ts # CLI 入口文件
│ ├── lib/
│ │ ├── index.ts # 主模块导出
│ │ ├── config.ts # 配置文件管理
│ │ └── commands.ts # 命令实现
│ └── types/
│ └── index.ts # 类型定义
├── dist/ # 编译后的 JavaScript 文件
├── package.json # NPM 包配置
├── tsconfig.json # TypeScript 配置
├── install.sh # 手动安装脚本
├── uninstall.sh # 手动卸载脚本
├── acm # Bash 版本脚本
└── README.md # 文档
Select Language