claude-key-manager/README.md

🚀 Claude Key Manager 4.1.3 - 修复密钥验证问题，支持更多密钥格式

# 🚀 Claude Key Manager 4.0

> **终极Claude API密钥管理工具 - 纯Node.js重构版**

[![npm version](https://badge.fury.io/js/claude-key-manager.svg)](https://www.npmjs.com/package/claude-key-manager)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## ✨ 新功能特性

- 🗑️ **安全删除** - 二次确认，防止误删
- 🎯 **交互式菜单** - 输入 `/` 即可触发，直观易用  
- 🔒 **系统密钥存储** - 使用keytar，安全可靠
- ⚡ **纯Node.js** - 无需编译，即装即用
- 🎨 **美观界面** - 彩色输出，状态清晰
- 🔄 **智能切换** - 删除当前密钥时自动切换
- 📋 **版本管理** - 自动检查更新，一键升级
- 🔔 **更新提醒** - 启动时智能提醒新版本

## 🚀 快速开始

### 安装

```bash
# 全局安装
npm install -g claude-key-manager

# 或使用简短别名 
npm install -g claude-key-manager && alias ck='claude-key'
```

### 基本使用

```bash
# 🎯 交互模式 (推荐)
claude-key          # 启动后输入 / 进入菜单
claude-key interactive    # 直接进入交互模式

# 📝 命令行模式
claude-key add sk-ant-your-key-here --name work
claude-key list
claude-key switch work  
claude-key delete old-key
claude-key current
claude-key version    # 检查版本和更新
claude-key update     # 更新到最新版本
```

## 🎯 交互式菜单

你最想要的功能！启动工具后输入 `/` 即可看到：

```
🚀 Claude Key Manager 4.0
┌─────────────────────────────────────┐
│ 纯Node.js重构版 - 交互式菜单模式    │
└─────────────────────────────────────┘

📊 状态信息:
   密钥总数: 3
   当前密钥: work

? 选择要执行的操作: 
  📝 添加新的API密钥
  📋 列出所有密钥 (3个)
  🔄 切换当前使用的密钥
❯ 🗑️  删除密钥 (你要的功能!)
  👁️  查看当前密钥详情
  🔧 高级选项...
  ────────────
  ❓ 显示帮助信息
  🚪 退出
```

## 🔧 命令详解

| 命令 | 描述 | 示例 |
|------|------|------|
| `add` | 添加新密钥 | `claude-key add sk-ant-xxx --name prod` |
| `list` | 列出所有密钥 | `claude-key list --verbose` |
| `switch` | 切换当前密钥 | `claude-key switch prod` |
| `delete` | 删除密钥 | `claude-key delete old-key --force` |
| `current` | 显示当前密钥 | `claude-key current` |
| `version` | 显示版本信息并检查更新 | `claude-key version` |
| `update` | 检查并更新到最新版本 | `claude-key update` |
| `interactive` | 交互模式 | `claude-key interactive` |

## 🛡️ 安全特性

- **系统密钥存储**: 使用操作系统的安全密钥存储 (Keychain/Credential Manager)
- **二次确认删除**: 防止意外删除重要密钥
- **密钥格式验证**: 确保输入的是有效的Claude API密钥  
- **智能备份提醒**: 删除前提醒备份重要配置

## 🆚 4.0 vs 3.0

| 特性 | 3.0 (Rust混合) | 4.0 (纯Node.js) |
|------|----------------|-----------------|
| 安装复杂度 | 需要二进制文件 | 纯npm install |
| 启动速度 | 较慢 | 超快 |
| 交互菜单 | ❌ | ✅ |
| 安全删除 | 基础 | 二次确认 |
| 版本管理 | ❌ | ✅ 自动检查更新 |
| 更新机制 | 手动 | 一键更新 |
| 开发维护 | 复杂 | 简单 |

## 🔥 架构重构亮点

1. **移除Rust依赖** - 不再需要平台特定的二进制文件
2. **统一技术栈** - 纯JavaScript/Node.js生态
3. **更好的错误处理** - 友好的错误信息和恢复机制  
4. **模块化设计** - 清晰的代码结构，易于扩展

## 📦 依赖项

- `keytar` - 系统密钥存储
- `commander` - CLI框架
- `inquirer` - 交互式命令
- `chalk` - 彩色输出
- `conf` - 配置管理

## 🚧 开发和贡献

```bash
git clone https://github.com/Yajunceng/claude-key-manager.git
cd claude-key-manager
npm install
npm test
```

## 📝 License

MIT © [Yajunceng](https://github.com/Yajunceng)

---

**🎉 享受更简洁、更安全、更快速的Claude密钥管理体验！**