@pikecode/api-key-manager 2.0.0 → 2.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +444 -151
- package/bin/akm.js +340 -11
- package/package.json +29 -12
- package/src/CommandRegistry.js +58 -3
- package/src/commands/BaseCommand.js +68 -1
- package/src/commands/add/prompts.js +280 -0
- package/src/commands/add/providerSaver.js +74 -0
- package/src/commands/add/summaryPrinter.js +29 -0
- package/src/commands/add.js +54 -439
- package/src/commands/backup.js +396 -0
- package/src/commands/batch.js +313 -0
- package/src/commands/benchmark.js +323 -0
- package/src/commands/claude-clean.js +253 -0
- package/src/commands/clone.js +265 -0
- package/src/commands/current.js +89 -41
- package/src/commands/edit.js +3 -207
- package/src/commands/health.js +264 -0
- package/src/commands/list.js +120 -35
- package/src/commands/mcp.js +467 -0
- package/src/commands/remove.js +89 -26
- package/src/commands/stats.js +281 -0
- package/src/commands/switch/claude-settings-compatibility.js +113 -0
- package/src/commands/switch/launch-args-helper.js +84 -0
- package/src/commands/switch/provider-choices-helper.js +72 -0
- package/src/commands/switch/provider-details-helper.js +46 -0
- package/src/commands/switch/provider-edit-questions-helper.js +124 -0
- package/src/commands/switch/provider-launcher.js +20 -0
- package/src/commands/switch/provider-manager.js +214 -0
- package/src/commands/switch/status-helper.js +124 -0
- package/src/commands/switch/ui-screen-renderer.js +77 -0
- package/src/commands/switch.js +471 -958
- package/src/commands/validate.js +310 -0
- package/src/config.js +558 -55
- package/src/constants/index.js +234 -0
- package/src/constants/ui.js +108 -0
- package/src/index.js +11 -4
- package/src/navigation/EscNavigationManager.js +5 -5
- package/src/utils/atomic-file.js +47 -0
- package/src/utils/claude-settings.js +4 -4
- package/src/utils/codex-files.js +418 -0
- package/src/utils/codex-launcher.js +104 -0
- package/src/utils/concurrency.js +30 -0
- package/src/utils/config-opener.js +22 -2
- package/src/utils/env-launcher.js +50 -44
- package/src/utils/env-utils.js +52 -0
- package/src/utils/error-handler.js +27 -28
- package/src/utils/health-checker.js +350 -0
- package/src/utils/import-validator.js +212 -0
- package/src/utils/inquirer-setup.js +11 -0
- package/src/utils/launch-args.js +155 -0
- package/src/utils/logger.js +0 -1
- package/src/utils/provider-status-checker.js +211 -64
- package/src/utils/secrets.js +22 -0
- package/src/utils/shell-snippets.js +32 -0
- package/src/utils/terminal-format.js +22 -4
- package/src/utils/ui-helper.js +96 -86
- package/src/utils/update-checker.js +41 -12
- package/src/utils/validator.js +136 -89
- package/bin/cc.js +0 -101
- package/src/utils/storage.js +0 -55
package/README.md
CHANGED
|
@@ -1,232 +1,525 @@
|
|
|
1
|
-
# API
|
|
1
|
+
# API Key Manager (akm)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
一个 CLI 工具,用于管理和快速切换 **Claude Code** 和 **Codex CLI** 的 API 配置。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
[](https://www.npmjs.com/package/@pikecode/api-key-manager)
|
|
6
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
7
|
|
|
7
|
-
##
|
|
8
|
+
## 功能特性
|
|
8
9
|
|
|
9
|
-
|
|
10
|
+
- 🎯 **双 IDE 支持** — 同时管理 Claude Code 和 Codex CLI 配置
|
|
11
|
+
- 🔄 **快速切换** — 一键切换不同的 API 供应商
|
|
12
|
+
- ⚡ **快速启动** — `-q` 跳过参数选择,秒级启动
|
|
13
|
+
- 🧠 **智能记忆** — 自动记住上次使用的启动参数
|
|
14
|
+
- 🗑️ **批量删除** — 支持一次选择多个供应商批量删除
|
|
15
|
+
- 🔌 **MCP 管理** — 管理 Claude Code 的 MCP 服务器配置
|
|
16
|
+
- 🧹 **配置清理** — 清理 Claude Code 配置文件中的冗余数据
|
|
17
|
+
- 📋 **克隆配置** — 快速克隆现有供应商配置
|
|
18
|
+
- ✅ **配置验证** — 验证 Token 有效性和 API 可用性
|
|
19
|
+
- 🔐 **权限保护** — 本地文件存储,Unix 自动设置 0600 权限
|
|
20
|
+
- 💾 **备份恢复** — 配置导出、导入、备份功能
|
|
21
|
+
- 🌍 **跨平台** — macOS / Linux / Windows
|
|
10
22
|
|
|
11
|
-
|
|
12
|
-
- ✅ 支持 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN
|
|
13
|
-
- ✅ 快速切换不同的 API 提供商
|
|
14
|
-
- ✅ 配置第三方代理服务
|
|
15
|
-
- ✅ 快速保存和切换多套配置
|
|
23
|
+
## 安装
|
|
16
24
|
|
|
17
|
-
|
|
25
|
+
```bash
|
|
26
|
+
npm install -g @pikecode/api-key-manager
|
|
27
|
+
```
|
|
18
28
|
|
|
19
|
-
##
|
|
29
|
+
## 快速开始
|
|
20
30
|
|
|
21
|
-
|
|
31
|
+
```bash
|
|
32
|
+
# 添加供应商配置
|
|
33
|
+
akm add
|
|
22
34
|
|
|
23
|
-
|
|
35
|
+
# 交互式切换供应商并启动
|
|
36
|
+
akm
|
|
24
37
|
|
|
25
|
-
|
|
26
|
-
|
|
38
|
+
# 快速启动(使用上次参数)
|
|
39
|
+
akm my-provider -q
|
|
40
|
+
|
|
41
|
+
# 查看所有配置
|
|
42
|
+
akm list
|
|
43
|
+
|
|
44
|
+
# 查看当前配置
|
|
45
|
+
akm current
|
|
27
46
|
```
|
|
28
47
|
|
|
29
|
-
|
|
48
|
+
## 命令参考
|
|
49
|
+
|
|
50
|
+
### 核心命令
|
|
51
|
+
|
|
52
|
+
| 命令 | 说明 |
|
|
53
|
+
| ----------------------- | ------------------------------ |
|
|
54
|
+
| `akm` / `akm switch` | 交互式选择和切换供应商 |
|
|
55
|
+
| `akm add` | 添加新的供应商配置 |
|
|
56
|
+
| `akm remove [provider]` | 删除供应商配置(支持批量删除) |
|
|
57
|
+
| `akm list` | 列出所有供应商 |
|
|
58
|
+
| `akm current` | 显示当前激活的配置 |
|
|
59
|
+
| `akm edit [provider]` | 编辑供应商配置 |
|
|
60
|
+
|
|
61
|
+
### 运维命令
|
|
62
|
+
|
|
63
|
+
| 命令 | 说明 |
|
|
64
|
+
| ------------------------- | -------------------- |
|
|
65
|
+
| `akm export [file]` | 导出配置到文件 |
|
|
66
|
+
| `akm import <file>` | 从文件导入配置 |
|
|
67
|
+
| `akm backup` | 备份和恢复配置 |
|
|
68
|
+
| `akm validate [provider]` | 验证供应商配置有效性 |
|
|
69
|
+
| `akm clone [source]` | 克隆现有供应商配置 |
|
|
70
|
+
|
|
71
|
+
### 工具命令
|
|
72
|
+
|
|
73
|
+
| 命令 | 说明 |
|
|
74
|
+
| ------------------------- | ------------------------------------- |
|
|
75
|
+
| `akm stats [provider]` | 显示供应商使用统计 |
|
|
76
|
+
| `akm health [provider]` | 检查配置健康状态 |
|
|
77
|
+
| `akm batch <operation>` | 批量操作供应商 |
|
|
78
|
+
| `akm benchmark` | 供应商性能测试和对比 |
|
|
79
|
+
| `akm claude <subcommand>` | Claude Code 配置管理 (clean/analyze) |
|
|
80
|
+
| `akm mcp <subcommand>` | MCP 服务器管理 (list/add/edit/remove) |
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## 详细使用指南
|
|
85
|
+
|
|
86
|
+
### 添加供应商
|
|
30
87
|
|
|
31
88
|
```bash
|
|
89
|
+
# 交互式添加(会询问 IDE 类型)
|
|
32
90
|
akm add
|
|
91
|
+
|
|
92
|
+
# 直接添加 Claude Code 供应商
|
|
93
|
+
akm add --claude
|
|
94
|
+
|
|
95
|
+
# 直接添加 Codex CLI 供应商
|
|
96
|
+
akm add --codex
|
|
33
97
|
```
|
|
34
98
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
5. **基础 URL**(可选):如果使用第三方服务需要填写
|
|
99
|
+
添加流程分两步:
|
|
100
|
+
|
|
101
|
+
**步骤 1 — 填写供应商信息:**
|
|
102
|
+
|
|
103
|
+
- 选择 IDE 类型(Claude Code / Codex CLI)
|
|
104
|
+
- 输入供应商名称
|
|
105
|
+
- 选择认证模式(Claude Code 有两种)
|
|
106
|
+
- 输入 API 基础 URL 和 Token
|
|
44
107
|
|
|
45
|
-
|
|
108
|
+
**步骤 2 — 可选配置:**
|
|
109
|
+
|
|
110
|
+
- 启动参数
|
|
111
|
+
- 模型配置
|
|
112
|
+
|
|
113
|
+
### 认证模式
|
|
114
|
+
|
|
115
|
+
Claude Code 支持两种认证模式:
|
|
116
|
+
|
|
117
|
+
| 模式 | 环境变量 | 适用场景 |
|
|
118
|
+
| ---------- | --------------------------------------------- | ---------------- |
|
|
119
|
+
| API Key | `ANTHROPIC_API_KEY` + `ANTHROPIC_BASE_URL` | 大多数第三方代理 |
|
|
120
|
+
| Auth Token | `ANTHROPIC_AUTH_TOKEN` + `ANTHROPIC_BASE_URL` | 部分服务商 |
|
|
121
|
+
|
|
122
|
+
Codex CLI 使用 `OPENAI_API_KEY` + `OPENAI_BASE_URL`。
|
|
123
|
+
|
|
124
|
+
### 切换供应商
|
|
46
125
|
|
|
47
126
|
```bash
|
|
127
|
+
# 交互式选择
|
|
48
128
|
akm
|
|
129
|
+
|
|
130
|
+
# 直接切换到指定供应商
|
|
131
|
+
akm my-provider
|
|
132
|
+
|
|
133
|
+
# 仅显示 Claude Code 供应商
|
|
134
|
+
akm switch --claude
|
|
135
|
+
|
|
136
|
+
# 仅显示 Codex CLI 供应商
|
|
137
|
+
akm switch --codex
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
### 快速启动
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
# 使用上次的启动参数
|
|
144
|
+
akm my-provider -q
|
|
145
|
+
|
|
146
|
+
# 以空参数启动
|
|
147
|
+
akm my-provider --no-args
|
|
49
148
|
```
|
|
50
149
|
|
|
51
|
-
|
|
150
|
+
参数优先级:`--no-args` > `--quick`
|
|
52
151
|
|
|
53
|
-
|
|
152
|
+
### 查看配置
|
|
54
153
|
|
|
55
154
|
```bash
|
|
56
|
-
|
|
57
|
-
akm
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
akm
|
|
61
|
-
|
|
155
|
+
# 列出所有供应商(默认不检测状态,秒出)
|
|
156
|
+
akm list
|
|
157
|
+
|
|
158
|
+
# 列出并检测在线状态
|
|
159
|
+
akm list --status
|
|
160
|
+
|
|
161
|
+
# 按 IDE 类型过滤
|
|
162
|
+
akm list --claude
|
|
163
|
+
akm list --codex
|
|
164
|
+
akm list --json
|
|
165
|
+
|
|
166
|
+
# 查看当前激活的配置(list/current 默认完整显示 Token)
|
|
167
|
+
akm current
|
|
168
|
+
akm current --shell zsh
|
|
169
|
+
akm current --json
|
|
62
170
|
```
|
|
63
171
|
|
|
64
|
-
|
|
172
|
+
`--show-token` 作为兼容参数继续接受;本地 `list`、`current`、创建摘要和供应商详情均直接显示完整 Token。
|
|
173
|
+
分享配置时仍建议使用默认的无密钥导出。
|
|
174
|
+
|
|
175
|
+
### 克隆供应商
|
|
176
|
+
|
|
177
|
+
快速基于现有配置创建新供应商:
|
|
65
178
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
- 自动管理环境变量,无需手动配置
|
|
179
|
+
```bash
|
|
180
|
+
# 交互式选择源供应商
|
|
181
|
+
akm clone
|
|
70
182
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
- **安全清理** 清空冲突变量,确保切换成功
|
|
183
|
+
# 直接指定源供应商
|
|
184
|
+
akm clone my-provider
|
|
185
|
+
```
|
|
75
186
|
|
|
76
|
-
|
|
77
|
-
- 支持 `--continue` 参数继续上次对话
|
|
78
|
-
- 支持 `--dangerously-skip-permissions` 沙盒模式
|
|
79
|
-
- 灵活选择启动参数组合
|
|
187
|
+
克隆时可以修改名称、认证模式、Token、基础 URL 等。
|
|
80
188
|
|
|
81
|
-
###
|
|
82
|
-
- **流式检测** 供应商可用性实时检查,逐个显示结果
|
|
83
|
-
- **状态指示** 使用彩色图标直观显示供应商状态(🟢可用 / 🟡有限可用 / 🔴不可用)
|
|
84
|
-
- **延迟显示** 实时显示 API 响应延迟,帮助选择最快的服务
|
|
85
|
-
- **智能识别** 自动识别不同供应商的响应格式,兼容性强
|
|
86
|
-
- **异步更新** 状态检测不阻塞界面操作,边检测边选择
|
|
189
|
+
### 删除供应商
|
|
87
190
|
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
- **方向键** - 便捷的菜单导航
|
|
92
|
-
- **空格/A/I** - 多选操作(全选/反选)
|
|
191
|
+
```bash
|
|
192
|
+
# 交互式删除(支持批量选择)
|
|
193
|
+
akm remove
|
|
93
194
|
|
|
94
|
-
|
|
95
|
-
-
|
|
96
|
-
|
|
97
|
-
- 智能推荐常用供应商
|
|
195
|
+
# 直接删除指定供应商
|
|
196
|
+
akm remove my-provider
|
|
197
|
+
```
|
|
98
198
|
|
|
99
|
-
|
|
199
|
+
**批量删除流程:**
|
|
100
200
|
|
|
101
|
-
|
|
201
|
+
1. 使用空格键选择多个要删除的供应商
|
|
202
|
+
2. 按 Enter 确认选择
|
|
203
|
+
3. 预览将要删除的供应商列表
|
|
204
|
+
4. 最终确认后批量删除
|
|
205
|
+
|
|
206
|
+
### 编辑供应商
|
|
102
207
|
|
|
103
208
|
```bash
|
|
104
|
-
#
|
|
105
|
-
akm
|
|
209
|
+
# 交互式选择要编辑的供应商
|
|
210
|
+
akm edit
|
|
106
211
|
|
|
107
|
-
#
|
|
108
|
-
akm
|
|
212
|
+
# 直接编辑指定供应商
|
|
213
|
+
akm edit my-provider
|
|
109
214
|
```
|
|
110
215
|
|
|
111
|
-
|
|
216
|
+
**可编辑内容:**
|
|
217
|
+
|
|
218
|
+
- 供应商名称
|
|
219
|
+
- 认证模式
|
|
220
|
+
- API 基础 URL
|
|
221
|
+
- Token
|
|
222
|
+
- 启动参数
|
|
112
223
|
|
|
113
|
-
|
|
224
|
+
### MCP 服务器管理
|
|
225
|
+
|
|
226
|
+
管理 `~/.claude.json` 中的 MCP 服务器配置:
|
|
114
227
|
|
|
115
228
|
```bash
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
#
|
|
120
|
-
|
|
229
|
+
# 列出已配置的 MCP 服务器
|
|
230
|
+
akm mcp list
|
|
231
|
+
|
|
232
|
+
# 添加 MCP 服务器(支持预设模板和手动配置)
|
|
233
|
+
akm mcp add
|
|
234
|
+
|
|
235
|
+
# 编辑 MCP 服务器
|
|
236
|
+
akm mcp edit
|
|
237
|
+
|
|
238
|
+
# 删除 MCP 服务器
|
|
239
|
+
akm mcp remove
|
|
121
240
|
```
|
|
122
241
|
|
|
123
|
-
|
|
242
|
+
内置预设模板:Playwright、filesystem、memory、fetch。
|
|
243
|
+
|
|
244
|
+
### Claude Code 配置清理
|
|
245
|
+
|
|
246
|
+
清理 `~/.claude.json` 中的冗余数据(如过期的项目记录):
|
|
124
247
|
|
|
125
248
|
```bash
|
|
126
|
-
#
|
|
127
|
-
akm
|
|
249
|
+
# 清理配置
|
|
250
|
+
akm claude clean
|
|
251
|
+
|
|
252
|
+
# 分析配置(仅查看,不修改)
|
|
253
|
+
akm claude analyze
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
### 备份与迁移
|
|
257
|
+
|
|
258
|
+
```bash
|
|
259
|
+
# 创建备份
|
|
260
|
+
akm backup
|
|
128
261
|
|
|
129
|
-
#
|
|
130
|
-
akm
|
|
262
|
+
# 列出备份
|
|
263
|
+
akm backup --list
|
|
131
264
|
|
|
132
|
-
#
|
|
133
|
-
akm
|
|
265
|
+
# 恢复备份
|
|
266
|
+
akm backup --restore <file>
|
|
267
|
+
|
|
268
|
+
# 导出无密钥配置(默认,可作为模板分享)
|
|
269
|
+
akm export my-config.json
|
|
270
|
+
|
|
271
|
+
# 显式导出包含完整 Token 的配置(敏感文件)
|
|
272
|
+
akm export private-backup.json --include-secrets
|
|
273
|
+
|
|
274
|
+
# 预览导出,不写入文件
|
|
275
|
+
akm export my-config.json --dry-run
|
|
276
|
+
|
|
277
|
+
# 导入配置
|
|
278
|
+
akm import my-config.json
|
|
279
|
+
akm import my-config.json --overwrite
|
|
280
|
+
akm import my-config.json --dry-run
|
|
134
281
|
```
|
|
135
282
|
|
|
136
|
-
|
|
283
|
+
导出文件在 Unix 系统上会设置为 `0600`。默认导出会把 `authToken` 设为 `null`,并写入
|
|
284
|
+
`secretsIncluded: false`,导入后需要重新设置密钥;只有明确使用 `--include-secrets` 时才会
|
|
285
|
+
写出原始密钥。
|
|
286
|
+
`health` 默认只做本地配置健康检查;使用 `--connectivity` 才会真实调用 API,可能产生费用。
|
|
287
|
+
`--json` 和 `--dry-run` 适合脚本或自动化流程。
|
|
137
288
|
|
|
138
|
-
|
|
289
|
+
如果配置文件在当前操作期间被另一个 `akm` 进程修改,保存会停止并提示重新执行,避免覆盖较新的配置。
|
|
139
290
|
|
|
140
|
-
|
|
141
|
-
- 适用于官方 Claude Code
|
|
142
|
-
- Token 格式: `sk-ant-oat01-...`
|
|
143
|
-
- 只需要填 Token,不需要填 URL
|
|
291
|
+
### 配置验证
|
|
144
292
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
293
|
+
```bash
|
|
294
|
+
# 验证单个供应商
|
|
295
|
+
akm validate my-provider
|
|
296
|
+
|
|
297
|
+
# 验证所有供应商
|
|
298
|
+
akm validate
|
|
148
299
|
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
300
|
+
# 按 IDE 类型过滤
|
|
301
|
+
akm validate --claude
|
|
302
|
+
akm validate --codex
|
|
303
|
+
```
|
|
152
304
|
|
|
153
|
-
|
|
305
|
+
验证内容:Token 有效性、API 响应时间、配置完整性。
|
|
154
306
|
|
|
155
|
-
|
|
307
|
+
---
|
|
156
308
|
|
|
157
|
-
|
|
158
|
-
A: 配置保存在你的电脑上 `~/.akm-config.json`,只有你能访问。Token 会被加密存储。
|
|
309
|
+
## 配置示例
|
|
159
310
|
|
|
160
|
-
|
|
161
|
-
A: 如果你在 Claude Code 的设置文件(`.claude/settings.json` 或 `.claude/settings.local.json`)中配置了环境变量,这些变量可能会覆盖本工具设置的供应商配置。工具会自动检测这种冲突,并提示你备份和清理冲突的变量。
|
|
311
|
+
### Claude Code — API Key 模式
|
|
162
312
|
|
|
163
|
-
|
|
164
|
-
|
|
313
|
+
```yaml
|
|
314
|
+
供应商名称: my-claude
|
|
315
|
+
认证模式: api_key
|
|
316
|
+
Token (ANTHROPIC_API_KEY): sk-ant-api03-xxxxxxxx
|
|
317
|
+
基础URL (ANTHROPIC_BASE_URL): https://api.anthropic.com
|
|
318
|
+
```
|
|
165
319
|
|
|
166
|
-
|
|
167
|
-
A: 工具会向每个供应商的 API 发送一个简单的测试请求,根据响应时间和结果显示状态。🟢表示可用,🟡表示有限可用(响应慢或部分功能受限),🔴表示不可用,⏳表示正在检测中。状态检测采用流式模式,逐个显示结果,不会阻塞界面操作。
|
|
320
|
+
### Claude Code — Auth Token 模式
|
|
168
321
|
|
|
169
|
-
|
|
170
|
-
|
|
322
|
+
```yaml
|
|
323
|
+
供应商名称: third-party
|
|
324
|
+
认证模式: auth_token
|
|
325
|
+
Token (ANTHROPIC_AUTH_TOKEN): your-auth-token
|
|
326
|
+
基础URL (ANTHROPIC_BASE_URL): https://your-provider.com/v1
|
|
327
|
+
```
|
|
171
328
|
|
|
172
|
-
|
|
173
|
-
A: 删除配置文件 `~/.akm-config.json` 就会清空所有配置。
|
|
329
|
+
### Codex CLI
|
|
174
330
|
|
|
175
|
-
|
|
176
|
-
|
|
331
|
+
```yaml
|
|
332
|
+
供应商名称: my-codex
|
|
333
|
+
API Key (OPENAI_API_KEY): sk-xxxxxxxx
|
|
334
|
+
基础URL (OPENAI_BASE_URL): https://api.openai.com
|
|
335
|
+
```
|
|
177
336
|
|
|
178
|
-
|
|
179
|
-
A: 确保你的终端支持 ESC 键捕获。如果不行,使用 `Ctrl+C` 也可以退出程序。
|
|
337
|
+
### 多账号配置
|
|
180
338
|
|
|
181
|
-
|
|
182
|
-
|
|
339
|
+
```bash
|
|
340
|
+
# 工作账号
|
|
341
|
+
akm add --claude # 名称: work
|
|
183
342
|
|
|
184
|
-
|
|
185
|
-
|
|
343
|
+
# 个人账号
|
|
344
|
+
akm add --claude # 名称: personal
|
|
186
345
|
|
|
187
|
-
|
|
346
|
+
# 快速切换
|
|
347
|
+
akm work -q
|
|
348
|
+
akm personal -q
|
|
349
|
+
```
|
|
188
350
|
|
|
189
|
-
|
|
190
|
-
- 🎉 **重大更新** - 项目重命名为 API Key Manager,全面升级
|
|
191
|
-
- 🔄 **命令变更** - `cc` 命令升级为 `akm`
|
|
192
|
-
- 🔑 **功能扩展** - API 密钥模式现支持 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 两种 Token 类型选择
|
|
193
|
-
- 📋 **配置优化** - 配置文件从 `~/.cc-config.json` 升级为 `~/.akm-config.json`
|
|
194
|
-
- 🎯 **用户体验** - 优化交互设计,支持更灵活的 Token 类型选择
|
|
351
|
+
---
|
|
195
352
|
|
|
196
|
-
|
|
197
|
-
- ✨ 实现供应商状态流式检测和实时更新
|
|
198
|
-
- 📡 将批量检测改为流式模式,逐个显示状态结果
|
|
199
|
-
- 🎨 优化状态图标显示,支持实时延迟展示
|
|
200
|
-
- 🚀 增强UI交互,支持动态更新选择界面
|
|
201
|
-
- 🔧 改进异步调度逻辑,提升响应速度
|
|
353
|
+
## 交互式界面
|
|
202
354
|
|
|
203
|
-
###
|
|
204
|
-
- ✨ 新增供应商状态检测功能
|
|
205
|
-
- 📡 添加 ProviderStatusChecker 类用于检测供应商可用性
|
|
206
|
-
- 🎨 在供应商列表和选择界面显示实时状态信息
|
|
207
|
-
- 🟢 支持状态图标显示(可用/有限可用/不可用)和延迟时间展示
|
|
208
|
-
- 🚀 异步更新状态不阻塞界面操作
|
|
355
|
+
### 主界面
|
|
209
356
|
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
-
|
|
213
|
-
|
|
214
|
-
-
|
|
215
|
-
|
|
357
|
+
```
|
|
358
|
+
? 请选择要切换的供应商 (总计 3 个):
|
|
359
|
+
🟢 [Claude] my-claude (My Claude Account) --- 上次使用 - 可用
|
|
360
|
+
🟢 [Claude] work (Work Account) - 可用
|
|
361
|
+
❯ 🟢 [Codex] my-codex (Codex Account) - 可用
|
|
362
|
+
──────────────
|
|
363
|
+
➕ 添加新供应商
|
|
364
|
+
📋 供应商管理 (编辑/删除)
|
|
365
|
+
📁 打开配置文件
|
|
366
|
+
❌ 退出
|
|
367
|
+
```
|
|
216
368
|
|
|
217
|
-
###
|
|
218
|
-
- 🎯 优化用户界面和交互体验
|
|
219
|
-
- 📊 改进供应商使用统计功能
|
|
369
|
+
### 状态图标
|
|
220
370
|
|
|
221
|
-
|
|
371
|
+
| 图标 | 含义 |
|
|
372
|
+
| ---- | --------------- |
|
|
373
|
+
| 🟢 | API 可用 |
|
|
374
|
+
| 🟡 | 有限可用/响应慢 |
|
|
375
|
+
| 🔴 | API 不可用 |
|
|
376
|
+
| ⏳ | 正在检测 |
|
|
377
|
+
| ⚪ | 未知状态 |
|
|
222
378
|
|
|
223
|
-
|
|
224
|
-
|
|
379
|
+
### 快捷键
|
|
380
|
+
|
|
381
|
+
| 按键 | 功能 |
|
|
382
|
+
| ------ | ---------------- |
|
|
383
|
+
| ↑/↓ | 上下导航 |
|
|
384
|
+
| Space | 切换选中(多选) |
|
|
385
|
+
| A | 全选 |
|
|
386
|
+
| I | 反选 |
|
|
387
|
+
| Enter | 确认 |
|
|
388
|
+
| ESC | 返回上级 / 取消 |
|
|
389
|
+
| Ctrl+C | 退出程序 |
|
|
225
390
|
|
|
226
391
|
---
|
|
227
392
|
|
|
228
|
-
##
|
|
393
|
+
## 架构设计
|
|
394
|
+
|
|
395
|
+
```
|
|
396
|
+
┌──────────────────────────────────────────────────────┐
|
|
397
|
+
│ akm (CLI 入口) │
|
|
398
|
+
├──────────────────────────────────────────────────────┤
|
|
399
|
+
│ CommandRegistry 命令注册中心,懒加载命令模块 │
|
|
400
|
+
│ ├── 核心: add, switch, remove, list, current, edit │
|
|
401
|
+
│ ├── 运维: export, import, backup, validate, clone │
|
|
402
|
+
│ └── 工具: stats, health, batch, benchmark, │
|
|
403
|
+
│ claude-clean, mcp │
|
|
404
|
+
├──────────────────────────────────────────────────────┤
|
|
405
|
+
│ ConfigManager 配置管理 (~/.akm-config.json) │
|
|
406
|
+
│ ├── 懒加载 & 缓存 │
|
|
407
|
+
│ ├── 版本迁移 │
|
|
408
|
+
│ └── 文件权限管理 (0600) │
|
|
409
|
+
├──────────────────────────────────────────────────────┤
|
|
410
|
+
│ IDE 启动器 │
|
|
411
|
+
│ ├── env-launcher.js Claude Code(环境变量注入) │
|
|
412
|
+
│ └── codex-launcher.js Codex CLI(配置文件+环境变量) │
|
|
413
|
+
└──────────────────────────────────────────────────────┘
|
|
414
|
+
```
|
|
415
|
+
|
|
416
|
+
**切换原理:**
|
|
417
|
+
|
|
418
|
+
- **Claude Code** — 通过环境变量注入启动子进程,不修改配置文件,切换只在当前会话生效
|
|
419
|
+
- **Codex CLI** — 写入 `~/.codex/auth.json` 和 `config.toml`,切换后直接运行 `codex` 也能使用新配置
|
|
420
|
+
|
|
421
|
+
**环境变量映射:**
|
|
422
|
+
|
|
423
|
+
```
|
|
424
|
+
Claude Code:
|
|
425
|
+
api_key → ANTHROPIC_API_KEY + ANTHROPIC_BASE_URL
|
|
426
|
+
auth_token → ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL
|
|
427
|
+
(可选) → ANTHROPIC_MODEL, ANTHROPIC_SMALL_FAST_MODEL
|
|
428
|
+
|
|
429
|
+
Codex CLI:
|
|
430
|
+
→ OPENAI_API_KEY + OPENAI_BASE_URL
|
|
431
|
+
```
|
|
432
|
+
|
|
433
|
+
---
|
|
434
|
+
|
|
435
|
+
## 配置文件
|
|
436
|
+
|
|
437
|
+
位置:`~/.akm-config.json`
|
|
438
|
+
|
|
439
|
+
```json
|
|
440
|
+
{
|
|
441
|
+
"version": "2.0.0",
|
|
442
|
+
"currentProvider": "my-claude",
|
|
443
|
+
"providers": {
|
|
444
|
+
"my-claude": {
|
|
445
|
+
"name": "my-claude",
|
|
446
|
+
"displayName": "My Claude",
|
|
447
|
+
"ideName": "claude",
|
|
448
|
+
"authMode": "api_key",
|
|
449
|
+
"authToken": "sk-ant-api03-xxx",
|
|
450
|
+
"baseUrl": "https://api.anthropic.com",
|
|
451
|
+
"launchArgs": ["--continue"],
|
|
452
|
+
"models": {
|
|
453
|
+
"primary": "claude-sonnet-4",
|
|
454
|
+
"smallFast": "claude-haiku-4"
|
|
455
|
+
},
|
|
456
|
+
"createdAt": "2025-12-15T05:00:00.000Z",
|
|
457
|
+
"lastUsed": "2025-12-15T05:30:00.000Z"
|
|
458
|
+
}
|
|
459
|
+
}
|
|
460
|
+
}
|
|
461
|
+
```
|
|
462
|
+
|
|
463
|
+
---
|
|
464
|
+
|
|
465
|
+
## 常见问题
|
|
466
|
+
|
|
467
|
+
### 切换 Codex 后提示 "Token data is not available"
|
|
468
|
+
|
|
469
|
+
`~/.codex/auth.json` 格式不正确。重新切换即可:
|
|
470
|
+
|
|
471
|
+
```bash
|
|
472
|
+
akm my-codex
|
|
473
|
+
```
|
|
474
|
+
|
|
475
|
+
akm 会把活跃认证切换为 `auth_mode = "apikey"`,并写入新的 `OPENAI_API_KEY`。
|
|
476
|
+
原 ChatGPT 登录态不会混入活跃认证文件,修改前内容会保存在 `~/.codex/akm-backups/`。
|
|
477
|
+
`auth.json` 与 `config.toml` 作为一组更新;任一文件写入失败时会自动恢复两者的原始内容。
|
|
478
|
+
|
|
479
|
+
### Claude Code 切换后环境变量不生效
|
|
480
|
+
|
|
481
|
+
`~/.claude/settings.json` 中可能存在冲突的环境变量。切换时 akm 会自动检测并提示处理。
|
|
482
|
+
|
|
483
|
+
### 找不到 claude/codex 命令
|
|
484
|
+
|
|
485
|
+
需要先安装对应的 CLI 工具:
|
|
486
|
+
|
|
487
|
+
```bash
|
|
488
|
+
# Claude Code
|
|
489
|
+
npm install -g @anthropic-ai/claude-code
|
|
490
|
+
|
|
491
|
+
# Codex CLI
|
|
492
|
+
npm install -g @openai/codex
|
|
493
|
+
```
|
|
494
|
+
|
|
495
|
+
### 配置文件权限问题
|
|
496
|
+
|
|
497
|
+
akm 会自动设置权限为 `0600`。手动修复:
|
|
498
|
+
|
|
499
|
+
```bash
|
|
500
|
+
chmod 600 ~/.akm-config.json
|
|
501
|
+
```
|
|
502
|
+
|
|
503
|
+
---
|
|
504
|
+
|
|
505
|
+
## 系统要求
|
|
506
|
+
|
|
507
|
+
- Node.js >= 20.0.0
|
|
508
|
+
- macOS / Linux / Windows
|
|
509
|
+
|
|
510
|
+
### 2.0 升级提示
|
|
511
|
+
|
|
512
|
+
- Node.js 最低版本由 14 提升到 20。
|
|
513
|
+
- 默认导出改为无密钥模板;完整备份必须显式使用 `--include-secrets`。
|
|
514
|
+
- 远程 API 地址必须使用 HTTPS,HTTP 仅允许 localhost 和回环地址。
|
|
515
|
+
- 导入配置不能携带跳过审批或沙盒的最高权限启动参数。
|
|
516
|
+
|
|
517
|
+
## 许可证
|
|
518
|
+
|
|
519
|
+
MIT License
|
|
229
520
|
|
|
230
|
-
|
|
521
|
+
## 链接
|
|
231
522
|
|
|
232
|
-
|
|
523
|
+
- [NPM](https://www.npmjs.com/package/@pikecode/api-key-manager)
|
|
524
|
+
- [GitHub](https://github.com/pikecode/api-key-manager)
|
|
525
|
+
- [Issues](https://github.com/pikecode/api-key-manager/issues)
|