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 # 文档

acm

配置管理

3 条回复 2025-08-25 00:09:04 +08:00