快速上手 AiKey
把 Claude、Codex、Kimi 的账号与 KEY，收进一座可路由的 Vault。本指南将协助你安装 CLI，并在本地建立安全的凭证金库。
curl -fsSL https://github.com/aikeylabs/launch/releases/latest/download/latest-install.sh | sh6 步开启个人流
端到端日常使用流程：从安装到查看统计，完整兑现 AiKey 的核心亮点。
安装与配置
一键脚本 + Source 环境
启动控制台
运行 aikey web
01. 安装 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 / Dashboard，获取每个 Key、Provider 的用量趋势与 Token 结构分析。
常用命令速查
日常开发中的高频指令，所有命令均可用短别名 ak 调用
查看所有已添加的 Key 和别名
切换全局激活的 Key
查看当前身份和当前激活的 Key
查看 shell 注入与 proxy 进程环境
合并配置代理或自定义环境变量
自动检查并修复常见环境问题
全量体检所有 Key 的连通性
查看第三方客户端接入配置
CI/脚本场景下的无交互运行
故障排除与自愈
Proxy 进程无响应？
执行 aikey proxy restart 重启代理服务。如果 Key 状态不正确，尝试 aikey key sync。
需要出网代理？
使用 aikey env set -- export https_proxy=http://127.0.0.1:7890 并重启 proxy 即可。