CCK - Claude Code Key Manager

English | 中文

> 轻松管理多个 Anthropic API 密钥并启动 Claude CLI。

特性

- 🔐 安全的密钥管理 - 安全存储多个 API 密钥
- 🖥️ Web UI - 可选的可视化界面管理密钥

安装

``bash
npm install -g @otdrfu/cck
`

快速开始

`bash


添加你的第一个 API 密钥

cck add

启动 Claude CLI（交互式密钥选择）

cck

列出所有密钥

cck list
`

使用说明

$3

`bash


列出所有 API 密钥

cck list
cck ls
cck list -f # 显示完整密钥

查看指定密钥详情

cck show
cck show -f # 显示完整密钥

添加新的 API 密钥

cck add

编辑 API 密钥

cck edit

重命名密钥

cck rename

删除 API 密钥

cck remove
cck rm

复制密钥到剪贴板

cck copy
cck cp

显示当前默认密钥

cck current

切换默认密钥

cck use

导出所有密钥到文件

cck export backup.json

从文件导入密钥

cck import backup.json # 跳过已存在的密钥
cck import backup.json -o # 覆盖已存在的密钥

显示帮助

cck help
`

$3

Web UI 是一个可选功能，首次使用需要安装依赖。运行时会提示你是否安装（约需 2-3 分钟）。

`bash


启动 Web 管理界面（首次运行会提示安装）

cck web

或先手动安装

cck web --install

指定端口

cck web --port 8080

不自动打开浏览器

cck web --no-open
`

> 注意：Web UI 文件会安装到 ~/.cck/web。你可以在提示时选择跳过，之后通过 cck web --install 手动安装。

Web UI 提供以下功能：
- 📋 密钥列表展示（卡片式布局）
- ➕ 添加/编辑/删除密钥
- 🔍 搜索过滤
- ✅ 密钥有效性验证
- 📤 导入/导出
- 🌙 深色模式支持
- 🌍 语言切换（中/英）

$3

`bash


交互式密钥选择

cck

使用默认密钥

cck --use-default

使用指定密钥

cck --key

传递参数给 Claude CLI

cck -r # 重置会话
cck --verbose # 详细输出
cck -r --verbose # 组合参数

混合 CCK 和 Claude 选项

cck --key prod -r --verbose
`

配置

创建 ~/.cckrc 文件来自定义行为：

`json
{
"version": "1.0.0",
"keysFile": "~/.cck/keys.json",
"cacheFile": "~/.cck/cache",
"logLevel": "info",
"display": {
"colorEnabled": true
}
}
`

开发

`bash


克隆仓库

git clone https://github.com/todrfu/claude-code-key-manager.git
cd claude-code-key-manager

安装依赖

npm install
cd web && npm install && cd ..

构建

npm run build

运行测试

npm test

开发模式

npm run dev
`

发布

`bash


补丁版本发布 (0.5.0 -> 0.5.1)

npm run release:patch

次版本发布 (0.5.0 -> 0.6.0)

npm run release:minor

主版本发布 (0.5.0 -> 1.0.0)

npm run release:major
``

许可证

MIT © todrfu

贡献

欢迎贡献！提交 PR 前请阅读 CONTRIBUTING.md。

更新日志

查看 CHANGELOG.md 了解版本历史。