akm - Anthropic Key Management
█████
░░███
██████ ░███ █████ █████████████
░░░░░███ ░███░░███ ░░███░░███░░███
███████ ░██████░ ░███ ░███ ░███
███░░███ ░███░░███ ░███ ░███ ░███
░░████████ ████ █████ █████░███ █████
░░░░░░░░ ░░░░ ░░░░░ ░░░░░ ░░░ ░░░░░
一个用于管理 Anthropic API 密钥和环境变量的命令行工具。
简介
akm (Anthropic Key Management) 是一个轻量级的 CLI 工具，用于快速切换不同的 Anthropic 代理配置。它通过管理 ~/.claude/settings.json 和 ~/.claude/config.json 文件来设置环境变量和 API 密钥，让你能够轻松地在不同的 API 代理服务之间切换。同时支持 Claude Code 和 Claude Code for VS Code v2.0+ 插件。
特性
- 🔐 管理多个 Anthropic API 代理配置
- 🚀 快速切换不同的代理环境
- 📝 简单易用的命令行界面
- 🔒 使用文件锁确保配置安全
- 🌐 支持连接性测试
- 💻 同时兼容 Claude Code 和 Claude Code for VS Code v2.0+ 插件
安装
npm install -g @xes/akm
使用方法
总览
Usage: akm [options] [command]
Options:
-v, --version display version number
--verbose output extra debugging information
--debug output complete debugging information (includes HTTP requests & response headers)
--timeout <seconds> override default timeout for test command (in seconds) (default: "10")
-h, --help display help for command
Commands:
ls|list list all proxy configurations with current marker
add <name> <base_url> <api_key> [model] [small_model] add a new proxy configuration
use <name> switch to a specific proxy configuration
unuse <name> stop using a specific proxy configuration
del|delete <name> delete a proxy configuration
rename <name> <new_name> rename a proxy configuration
test <name> test connectivity to a proxy configuration
help [command] display help for command
Examples:
akm ls # list all configurations
akm add kimi https://api.moonshot.cn/anthropic sk-xxx # add new configuration
akm add kimi https://api.moonshot.cn/anthropic sk-xxx kimi-k2-turbo-preview kimi-k2-turbo-preview # add with models
akm use kimi # switch to kimi (immediately effective)
akm unuse kimi # stop using any proxy
akm test kimi # test kimi connection
akm del kimi # delete kimi
akm rename kimi moonshot # rename configuration
Global Options:
--verbose Show detailed output
--debug Show debug information including HTTP details
--timeout <sec> Set timeout for test command (default: 10s)
添加代理配置
# 添加基本代理配置
akm add kimi https://api.moonshot.cn/anthropic sk-your-api-key
# 添加带模型配置的代理
akm add kimi https://api.moonshot.cn/anthropic sk-your-api-key kimi-k2-turbo-preview kimi-k2-turbo-preview
列出所有配置
akm ls
切换到指定代理
akm use kimi
停止使用当前代理
akm unuse kimi
测试代理连接
akm test kimi
删除代理配置
akm del kimi
重命名代理配置
akm rename kimi moonshot
配置文件
~/.claude/settings.json
Claude CLI 的配置文件，akm 会自动管理其中的环境变量：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.anthropic.com",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxx",
"ANTHROPIC_MODEL": "kimi-k2-turbo-preview",
"ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2-turbo-preview"
}
}
注意：
ANTHROPIC_MODEL和ANTHROPIC_SMALL_FAST_MODEL仅在配置中提供了相应的模型参数时才会被设置。
~/.claude/config.json
Claude Code for VS Code 插件的配置文件，akm 会自动管理 API 密钥：
{
"primaryApiKey": "sk-xxxxx"
}
从 v1.2.0 开始，akm 同时支持 Claude Code 和 Claude Code for VS Code v2.0+ 插件。执行
akm use命令时会同时更新两个配置文件。
命令详情
| 命令 | 描述 | 示例 |
|---|---|---|
add <name> <url> <key> [model] [small_model] | 添加新的代理配置，可选择指定模型 | akm add proxy1 https://api.example.com sk-key model_id small_model_id |
ls | 列出所有配置，标记当前使用的 | akm ls |
use <name> | 切换到指定代理 | akm use proxy1 |
unuse <name> | 停止使用当前代理 | akm unuse proxy1 |
test [name] | 测试代理连接（默认测试当前代理） | akm test proxy1 |
del <name> | 删除指定配置 | akm del proxy1 |
rename <old> <new> | 重命名配置 | akm rename proxy1 proxy2 |
开发
环境要求
- Node.js >= 18.0.0
- pnpm（推荐）或 npm
开发命令
# 安装依赖
pnpm install
# 开发模式（监视文件变化）
pnpm dev
# 构建项目
pnpm build
# 运行测试
pnpm test
# 运行带覆盖率的测试
pnpm test:coverage
# 类型检查
pnpm typecheck
# 代码检查
pnpm lint
# 修复代码格式
pnpm lint:fix
# 格式化代码
pnpm format
项目结构
src/
├── index.ts # CLI 入口，使用 commander 定义命令
├── actions.ts # 所有命令的具体实现逻辑
├── config.ts # ConfigManager - 管理 ~/.akmrc 配置文件
├── shell.ts # ClaudeSettingsManager - 管理 ~/.claude/settings.json
├── services.ts # API 服务，用于 akm test 命令
├── logger.ts # 日志工具，基于 chalk
├── constants.ts # 常量定义
└── types.ts # TypeScript 类型定义
技术栈
- 运行时: Node.js ≥ 18, TypeScript
- CLI 框架: commander
- 配置解析: ini
- 终端样式: chalk
- 文件锁定: proper-lockfile
- 测试框架: vitest
- 构建工具: tsdown
- 代码检查: ESLint 9, typescript-eslint 8
错误处理
项目使用自定义的 AkmError 类统一处理错误，包含明确的退出码：
0: 成功1: 参数错误/重名冲突2: 网络失败/API 失败3: 配置不存在4: 文件写入失败5: 未知异常
CHANGELOG
[1.2.0] - 2025-10-09
Added
- 支持 Claude Code for VS Code v2.0+ 插件兼容性
- 新增对
~/.claude/config.json文件的自动管理 - 执行
akm use命令时会同时更新settings.json和config.json文件 - 在
config.json中设置primaryApiKey字段，确保 VS Code 插件正常工作
Updated
- 优化了
ClaudeSettingsManager类，新增updatePrimaryApiKey()方法 - 更新了
onUse()命令逻辑，同时管理两个配置文件 - 完善了文档说明，添加了 VS Code 插件兼容性的相关信息
[1.1.0] - 2025-08-25
Added
- 支持可选的模型参数：
akm add命令现在接受可选的[model]和[small_model]参数 - 新增环境变量
ANTHROPIC_MODEL和ANTHROPIC_SMALL_FAST_MODEL的自动管理 - 模型配置会保存到
~/.akmrc配置文件中，并在使用时自动设置相应的环境变量 - 向后兼容：现有配置不受影响，模型参数完全可选
Updated
- 更新了所有相关文档，包括 README.md、设计文档和产品需求文档
- 优化了代码结构以支持可选的模型配置
- 更新了示例和帮助信息
[1.0.2] - 2025-07-24
Changed
- 从 package.json 动态读取版本号，确保版本一致性
- 优化版本管理机制
[1.0.1] - 2025-07-24
Changed
- 将环境变量名称从
ANTHROPIC_API_KEY更改为ANTHROPIC_AUTH_TOKEN - 更新所有文档和代码中的环境变量引用
- 添加向后兼容性处理，自动清理旧的
ANTHROPIC_API_KEY配置
Updated Files
- 源代码：
constants.ts,shell.ts - 文档：
README.md,CLAUDE.md,prd.md,design-doc.md
[1.0.0] - 2025-07-15
Added
- 初始版本发布
- 支持管理多个 Anthropic API 代理配置
- 提供完整的 CLI 命令：add, use, unuse, del, rename, test, ls
- 自动管理
~/.claude/settings.json文件 - 支持连接性测试功能
- 完整的文档和开发指南
许可证
MIT License