API Key Manager (akm)

一个 CLI 工具，用于管理和快速切换 Claude Code 和 Codex CLI 的 API 配置。

功能特性

• 🎯 双 IDE 支持 — 同时管理 Claude Code 和 Codex CLI 配置
• 🔄 快速切换 — 一键切换不同的 API 供应商
• ⚡ 快速启动 — -q 跳过参数选择，秒级启动
• 🧠 智能记忆 — 自动记住上次使用的启动参数
• 🗑️ 批量删除 — 支持一次选择多个供应商批量删除
• 🔌 MCP 管理 — 管理 Claude Code 的 MCP 服务器配置
• 🧹 配置清理 — 清理 Claude Code 配置文件中的冗余数据
• 📋 克隆配置 — 快速克隆现有供应商配置
• ✅ 配置验证 — 验证 Token 有效性和 API 可用性
• 🔐 权限保护 — 本地文件存储，Unix 自动设置 0600 权限
• 💾 备份恢复 — 配置导出、导入、备份功能
• 🌍 跨平台 — macOS / Linux / Windows

安装

npm install -g @pikecode/api-key-manager

快速开始

# 添加供应商配置
akm add

# 交互式切换供应商并启动
akm

# 快速启动（使用上次参数）
akm my-provider -q

# 查看所有配置
akm list

# 查看当前配置
akm current

命令参考

核心命令

运维命令

工具命令

详细使用指南

添加供应商

# 交互式添加（会询问 IDE 类型）
akm add

# 直接添加 Claude Code 供应商
akm add --claude

# 直接添加 Codex CLI 供应商
akm add --codex

添加流程分两步：

步骤 1 — 填写供应商信息：

• 选择 IDE 类型（Claude Code / Codex CLI）
• 输入供应商名称
• 选择认证模式（Claude Code 有两种）
• 输入 API 基础 URL 和 Token

步骤 2 — 可选配置：

• 启动参数
• 模型配置

认证模式

Claude Code 支持两种认证模式：

Codex CLI 使用 OPENAI_API_KEY + OPENAI_BASE_URL。 如果选择官方网页登录模式，AKM 会按供应商名称缓存 Codex 的官方 Session；同一个官方供应商会复用本地 Session，Session 失效时由 Codex CLI 重新触发浏览器授权。需要多个 OpenAI 官方账号时，为每个账号添加一个不同名称的 Codex 官方网页登录供应商即可。

切换供应商

# 交互式选择
akm

# 直接切换到指定供应商
akm my-provider

# 仅显示 Claude Code 供应商
akm switch --claude

# 仅显示 Codex CLI 供应商
akm switch --codex

快速启动

# 使用上次的启动参数
akm my-provider -q

# 以空参数启动
akm my-provider --no-args

# Codex 官方网页登录模式下清理当前 Session 并重新网页登录
akm openai-work --relogin

参数优先级：--no-args > --quick

查看配置

# 列出所有供应商（默认不检测状态，秒出）
akm list

# 列出并检测在线状态
akm list --status

# 按 IDE 类型过滤
akm list --claude
akm list --codex
akm list --json

# 查看当前激活的配置（list/current 默认完整显示 Token）
akm current
akm current --shell zsh
akm current --json

--show-token 作为兼容参数继续接受；本地 list、current、创建摘要和供应商详情均直接显示完整 Token。 分享配置时仍建议使用默认的无密钥导出。

克隆供应商

快速基于现有配置创建新供应商：

# 交互式选择源供应商
akm clone

# 直接指定源供应商
akm clone my-provider

克隆时可以修改名称、认证模式、Token、基础 URL 等。

删除供应商

# 交互式删除（支持批量选择）
akm remove

# 直接删除指定供应商
akm remove my-provider

批量删除流程：

1. 使用空格键选择多个要删除的供应商
2. 按 Enter 确认选择
3. 预览将要删除的供应商列表
4. 最终确认后批量删除

删除 Codex 官方网页登录供应商时，会同时清理该名称的旧 Session 缓存和独立目录中的认证；以后添加同名供应商需要重新认证。只有该供应商仍有窗口运行时才阻止删除，其他供应商不受影响。删除失败会恢复认证；该操作不会撤销服务端 Token，也不会清理共享历史、历史备份或其他账号的缓存。

编辑供应商

# 交互式选择要编辑的供应商
akm edit

# 直接编辑指定供应商
akm edit my-provider

可编辑内容：

• 供应商名称
• 认证模式
• API 基础 URL
• Token
• 启动参数

MCP 服务器管理

管理 ~/.claude.json 中的 MCP 服务器配置：

# 列出已配置的 MCP 服务器
akm mcp list

# 添加 MCP 服务器（支持预设模板和手动配置）
akm mcp add

# 编辑 MCP 服务器
akm mcp edit

# 删除 MCP 服务器
akm mcp remove

内置预设模板：Playwright、filesystem、memory、fetch。

Claude Code 配置清理

清理 ~/.claude.json 中的冗余数据（如过期的项目记录）：

# 清理配置
akm claude clean

# 分析配置（仅查看，不修改）
akm claude analyze

备份与迁移

# 创建备份
akm backup

# 列出备份
akm backup --list

# 恢复备份
akm backup --restore <file>

# 导出无密钥配置（默认，可作为模板分享）
akm export my-config.json

# 显式导出包含完整 Token 的配置（敏感文件）
akm export private-backup.json --include-secrets

# 预览导出，不写入文件
akm export my-config.json --dry-run

# 导入配置
akm import my-config.json
akm import my-config.json --overwrite
akm import my-config.json --dry-run

导出文件在 Unix 系统上会设置为 0600。默认导出会把 authToken 设为 null，并写入 secretsIncluded: false，导入后需要重新设置密钥；只有明确使用 --include-secrets 时才会 写出原始密钥。 health 默认只做本地配置健康检查；使用 --connectivity 才会真实调用 API，可能产生费用。 --json 和 --dry-run 适合脚本或自动化流程。

如果配置文件在当前操作期间被另一个 akm 进程修改，保存会停止并提示重新执行，避免覆盖较新的配置。

配置验证

# 验证单个供应商
akm validate my-provider

# 验证所有供应商
akm validate

# 按 IDE 类型过滤
akm validate --claude
akm validate --codex

验证内容：Token 有效性、API 响应时间、配置完整性。

配置示例

Claude Code — API Key 模式

供应商名称: my-claude
认证模式: api_key
Token (ANTHROPIC_API_KEY): sk-ant-api03-xxxxxxxx
基础URL (ANTHROPIC_BASE_URL): https://api.anthropic.com

Claude Code — Auth Token 模式

供应商名称: third-party
认证模式: auth_token
Token (ANTHROPIC_AUTH_TOKEN): your-auth-token
基础URL (ANTHROPIC_BASE_URL): https://your-provider.com/v1

Codex CLI

供应商名称: my-codex
API Key (OPENAI_API_KEY): sk-xxxxxxxx
基础URL (OPENAI_BASE_URL): https://api.openai.com

官方网页登录模式可以配置多个供应商名称，例如 openai-work、openai-personal。AKM 会把它们的 Session 分开缓存，切换时只恢复对应供应商的 Session。需要强制换号或重新授权时运行：

akm openai-work --relogin

Codex 官方多账号

每个官方账号都应创建一个独立的 Codex 官方网页登录供应商，供应商名称就是 Session 隔离键。

# 添加个人 OpenAI 官方账号
akm add --codex
# 认证方式选择: 官方网页登录
# 供应商名称填写: openai-personal

# 添加工作 OpenAI 官方账号
akm add --codex
# 认证方式选择: 官方网页登录
# 供应商名称填写: openai-work

首次启动某个官方供应商时，如果该供应商还没有自己的 Session，Codex 会打开浏览器授权；授权完成后 AKM 会按供应商名称缓存 Session。

# 首次启动个人账号，会绑定 openai-personal 的 Session
akm openai-personal

# 首次启动工作账号，会重新网页授权，不复用 openai-personal
akm openai-work

日常切换时直接使用供应商名称即可：

akm openai-personal
akm openai-work

需要换号、Session 异常或希望重新网页登录时，使用 --relogin 清理当前供应商的 Session：

akm openai-work --relogin
akm switch openai-work --relogin

会话恢复与运行保护

同一供应商可以打开多个窗口，不同供应商也可以同时运行。一个窗口退出当前 Codex 会话后，可以再启动任意供应商，不影响其他窗口。

AKM 使用 <CODEX_HOME>/akm-providers/<供应商标识>/ 保存各供应商独立的 auth.json、config.toml 和 SQLite 运行状态，根目录默认为 ~/.codex。不再覆盖根目录认证，也不再使用旧的 .akm-launch.lock 限制窗口数量。直接运行原生 codex 仍使用其原有配置；请通过 akm <供应商> 使用隔离配置。

首次启动会复制根目录的配置与 AGENTS.md，并迁移同名官方 Session 缓存；不会继承其他账号的认证。后续 Codex 刷新的 Token 直接保存在该供应商目录，不再在窗口退出时覆盖回共享认证文件。根目录后续配置修改不会自动覆盖已创建的独立配置。

sessions 和 archived_sessions 通过目录链接共享，历史文件无需搬迁；SQLite 数据库与认证保持隔离。已有的 skills、rules、plugins 目录也会链接到原位置。Windows 使用目录联接（junction）。

选择“从历史继续”后，AKM 优先列出当前工作目录的历史（包括不同供应商），按会话文件最近修改时间排序，默认选中最近的一条；只有一条时默认选中该条。目录按规范化完整路径与真实路径匹配，不按文件夹名称匹配。当前目录没有历史时，默认选择新建会话；需要跨项目继续时，可主动选择“查看其他项目历史”，也可返回当前目录列表。列表每批展示 20 条，可选择“加载更多”，默认定位到新增批次第一条。列表使用短 ID、最近使用时间、项目名和原供应商，按终端宽度截断；确认页展示完整 ID、路径及创建时间。在其他项目列表按 ESC 返回当前目录，在当前目录列表或确认页按 ESC 取消。列表页大小按显示时的终端高度调整，最多 15 行。分批展示只减少菜单条目，首次仍扫描共享历史文件的头部元数据。单条非法元数据会被跳过。确认目标供应商后使用 codex fork <ID> 创建新对话，原历史保持不变，多个窗口可以从同一历史分叉。跨供应商继续会向新供应商发送恢复所需的上下文，因此默认不确认；非交互终端不会自动选择历史。此功能需要支持 codex fork 的 Codex CLI，已使用 0.166.0 的原生接口验证。分叉失败会显示原因，不静默丢弃历史。

供应商列表异步检测状态时保持顺序和选中项不变，合并连续刷新并跳过相同内容；状态检测失败显示在提示行，避免日志插入活动菜单。供应商条目按终端宽度截断，状态文字限制长度；截断仅影响显示，选择仍使用完整供应商名称。ESC 识别后立即取消当前提示并执行返回通知，不再延迟写入下一菜单。

取消历史选择不会改变当前供应商或使用统计。AKM 在操作系统确认子进程创建后记录使用状态；这表示进程已创建，不代表模型认证或请求已经成功。

同一供应商的首次网页登录未完成时，先完成该窗口认证，再打开更多窗口。--relogin、修改密钥或认证配置、删除官方账号需要先退出该供应商的所有窗口，其他供应商可继续运行。该选项不会撤销服务端 Token 或清理浏览器登录状态。

正常退出会清除运行记录；强杀后可能在供应商目录的 .akm-runs/ 留下记录，或留下短时 .akm-settings.lock。仅在确认该供应商相关 AKM/Codex 进程均已退出后清理这些记录；不要删除历史目录。

更新检查结果（包括失败结果）缓存在 ~/.akm-update-check.json，24 小时内不重复请求 npm。可通过 CC_NO_UPDATE_CHECK=1 禁用检查。

选择更新并重启后，旧进程会等待新版命令结束，再以相同退出码退出，不重复执行原命令。重启失败时会提示手动重新运行。

配置读写使用短时文件锁，多个终端同时修改时会提示重试，避免后保存的配置覆盖先前修改。异常强杀后若遗留 ~/.akm-config.json.lock，须确认相关 AKM 进程已退出后再清理。

多账号配置

# 工作账号
akm add --claude  # 名称: work

# 个人账号
akm add --claude  # 名称: personal

# 快速切换
akm work -q
akm personal -q

交互式界面

主界面

? 请选择要切换的供应商 (总计 3 个):
  🟢 [Claude] my-claude (My Claude Account) --- 上次使用 - 可用
  🟢 [Claude] work (Work Account) - 可用
❯ 🟢 [Codex] my-codex (Codex Account) - 可用
  ──────────────
  ➕ 添加新供应商
  📋 供应商管理 (编辑/删除)
  📁 打开配置文件
  ❌ 退出

状态图标

快捷键

架构设计

┌──────────────────────────────────────────────────────┐
│                    akm (CLI 入口)                     │
├──────────────────────────────────────────────────────┤
│  CommandRegistry        命令注册中心，懒加载命令模块   │
│  ├── 核心: add, switch, remove, list, current, edit  │
│  ├── 运维: export, import, backup, validate, clone   │
│  └── 工具: stats, health, batch, benchmark,          │
│           claude-clean, mcp                          │
├──────────────────────────────────────────────────────┤
│  ConfigManager          配置管理 (~/.akm-config.json) │
│  ├── 懒加载 & 缓存                                   │
│  ├── 版本迁移                                        │
│  └── 文件权限管理 (0600)                              │
├──────────────────────────────────────────────────────┤
│  IDE 启动器                                          │
│  ├── env-launcher.js    Claude Code（环境变量注入）    │
│  └── codex-launcher.js  Codex CLI（配置文件+环境变量） │
└──────────────────────────────────────────────────────┘

切换原理：

• Claude Code — 通过环境变量注入启动子进程，不修改配置文件，切换只在当前会话生效
• Codex CLI — 按供应商设置独立 CODEX_HOME，认证和运行状态隔离，会话文件共享，支持多窗口并行

环境变量映射：

Claude Code:
  api_key    → ANTHROPIC_API_KEY + ANTHROPIC_BASE_URL
  auth_token → ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL
  (可选)     → ANTHROPIC_MODEL, ANTHROPIC_SMALL_FAST_MODEL

Codex CLI:
  → OPENAI_API_KEY + OPENAI_BASE_URL

配置文件

位置：~/.akm-config.json

{
  "version": "2.0.0",
  "currentProvider": "my-claude",
  "providers": {
    "my-claude": {
      "name": "my-claude",
      "displayName": "My Claude",
      "ideName": "claude",
      "authMode": "api_key",
      "authToken": "sk-ant-api03-xxx",
      "baseUrl": "https://api.anthropic.com",
      "launchArgs": ["--continue"],
      "models": {
        "primary": "claude-sonnet-4",
        "smallFast": "claude-haiku-4"
      },
      "createdAt": "2025-12-15T05:00:00.000Z",
      "lastUsed": "2025-12-15T05:30:00.000Z"
    }
  }
}

常见问题

切换 Codex 后提示 "Token data is not available"

检查对应供应商独立目录中的 auth.json。退出该供应商的所有窗口后再启动；官方账号可使用 akm <供应商> --relogin 重新认证。若认证 JSON 已损坏，显式重新登录会先备份原始文件，再清理认证；普通启动不会覆盖损坏文件：

akm my-codex

API Key 模式会在对应供应商目录写入 auth_mode = "apikey" 和 OPENAI_API_KEY。 修改前内容保存在该供应商目录的 akm-backups/ 中，不改动其他供应商认证。 auth.json 与 config.toml 作为一组更新；任一文件写入失败时会自动恢复两者的原始内容。

Claude Code 切换后环境变量不生效

~/.claude/settings.json 中可能存在冲突的环境变量。切换时 akm 会自动检测并提示处理。

找不到 claude/codex 命令

需要先安装对应的 CLI 工具：

# Claude Code
npm install -g @anthropic-ai/claude-code

# Codex CLI
npm install -g @openai/codex

配置文件权限问题

akm 会自动设置权限为 0600。手动修复：

chmod 600 ~/.akm-config.json

系统要求

• Node.js >= 20.0.0
• macOS / Linux / Windows

2.0 升级提示

• Node.js 最低版本由 14 提升到 20。
• 默认导出改为无密钥模板；完整备份必须显式使用 --include-secrets。
• 远程 API 地址必须使用 HTTPS，HTTP 仅允许 localhost 和回环地址。
• 导入配置不能携带跳过审批或沙盒的最高权限启动参数。

许可证

MIT License

链接

• 修改记录
• NPM
• GitHub
• Issues