快速上手 AiKey
把 Claude、Codex、Kimi 的账号与 KEY，收进一座可路由的 Vault。本指南将协助你安装 CLI，并在本地建立安全的凭证金库。
curl -fsSL https://aikeylabs.com/zh/i/of | sh01. 安装 CLI + source
执行安装脚本后，让 PATH 立即生效。完成后你可以看到 aikey 已安装到 ~/.aikey/bin。
$ source ~/.zshrc # 或 source ~/.bashrc02. 打开 aikey web
会自动在浏览器打开本地 Vault 控制台，首次打开页面时列表为空。
$ aikey web03. 添加凭证并安装 hook
在 Vault 页面添加 API Key 或通过 aikey auth login 登录 OAuth 账号。点击顶部横幅安装 Shell Hook。
$ aikey auth login claude # 登录 Provider OAuth 账号✔ 凭证已存入本地加密金库04. 运行工具并查看小票
在新终端运行常用 CLI。退出会话后，AiKey 会打印费用小票（cost receipt），实时把控成本。
$ claude # 或 kimi, codex[Cost Receipt] Token: 4,200 | Est: $0.0805. 快速切换 Key
额度不足时，通过 Web 端点击切换或 CLI 全局/临时切换。无需修改代码或环境变量，下一次请求即生效。
$ aikey use my-key # 全局切换$ aikey activate my-key # 仅当前终端临时激活06. 查看用量统计
直接打开本地控制台的 Usage 页，看每个 Key / Provider 的用量趋势、cache token 占比和成本分析。也可以在 aikey web 控制台里手动点 Usage 进入。
$ aikey web usage控制台里可以做什么
运行 aikey web 后，会打开本地 Vault 控制台。第一次进入时 Key 列表为空，你可以从这里添加凭证、安装 hook、切换 active Key，并查看用量与 token 结构。
My Vault
真实凭证留在本地 Vault
claude-main
anthropic / active binding
vk_••••21kimi-backup
kimi_code / standby
vk_••••90Tokens
1.2M
Cache
42%
Provider
3
Vault 添加凭证
在 My Vault 添加 API Key 或 OAuth 账号，真实凭证只进入本地 Vault。
Import 批量导入
已有多把 Key 时，可以从 Import 入口集中导入，减少逐个复制。
切换 active Key
在 Web 端切换当前 active 绑定，让新请求使用新的账号或 Key。
Usage / Dashboard
查看用量趋势、token 结构、cache token 占比和 provider 分布。
http://127.0.0.1:27200，需先在终端运行 aikey web 启动控制台后再点击；端口默认 27200，如自定义请改用本机实际地址。常用命令速查
日常开发中的高频指令，所有命令均可用短别名 ak 调用
查看所有已添加的 Key 和别名
切换全局激活的 Key
查看当前身份和当前激活的 Key
查看 shell 注入与 proxy 进程环境
合并配置代理或自定义环境变量
自动检查并修复常见环境问题
全量体检所有 Key 的连通性
查看第三方客户端接入配置
CI/脚本场景下的无交互运行
故障排除与自愈
Proxy 进程无响应？
执行 aikey proxy restart 重启代理服务。如果 Key 状态不正确，尝试 aikey key sync。
需要出网代理？
使用 aikey env set https_proxy=http://127.0.0.1:7890 并重启 proxy 即可。