aikey 快速开始
通过本地加密 Vault 管理你的 AI 凭证。本指南涵盖了从一键安装到多账号治理的所有核心流程。
先从你遇到的问题开始
如果你只是想把本机 AI 工具先跑顺，不必从概念开始读。下面这些场景对应每天最常见的 Key、OAuth、额度、账单和 Agent 授权问题。
有订阅账号，但不想碰 OAuth token
想用 Claude、Codex、Kimi 订阅账号跑本地工具，但不想把 token 粘到浏览器、脚本或第三方配置里。
登录成功，不代表下一次 chat 能跑
OAuth、callback、本地 proxy、API、Chat 链路任何一步失败，都会在任务开始后才暴露。
任务做到一半，当前账号额度耗尽
传统配置把工具和真实 Key 绑死，换账号就要改环境变量、重启工具，甚至丢掉上下文。
账单和模型可信度都说不清
月底只看到总额，或者按高价模型计费但回答质量不像，需要在本地工作流里看到信号。
切换通道后想知道这条通道稳不稳
新接入一个网关或模型，希望有个可量化的横向参考，再决定是否长期使用。
第三方 Agent 想用 Key，但真实 Key 不能交出去
用户在 AiKey Web 选择一个虚拟 Key，通过 OAuth 授权给本地 Agent。Agent 拿到的是可撤销入口，真实凭证仍留在 Vault，后续可以按 Agent 查看用量和调用摘要。
不碰 token，只授权本机工作流
没有 AiKey 前
token 被复制到环境变量、JSON 配置、脚本、浏览器页面或第三方客户端，过期和泄漏都很难追。
AiKey 介入后
Provider OAuth 账号进入本地 Vault，日常工具只看到 AiKey 本地入口或 active binding。
下一步
进入「使用 OAuth 账号」：aikey auth login claude。
登录成功以后，先确认这条链路真的能跑
场景页把「登录完成」和「本机工具能发起 chat」拆开讲清楚。测试失败时，凭证可以先保存，再按提示排查下一步。
查看「跑连通性测试」操作步骤额度耗尽时，换的是背后账号，不是当前任务
用户要保住当前 Claude Code / Cursor / Codex 会话。AiKey 用稳定 route token 接住工具入口，背后真实凭证可以通过 aikey use backup-account 切换。
账单不再只是月底的一串总额
用户每天在多个 AI 工具间切换，最需要的是这次会话花了什么、cache 有没有命中、模型返回有没有可疑信号，而不是事后再去云 dashboard 里翻。
评估当前通道的真实表现，让切换有据可依
什么时候用
切换到新通道、怀疑回答波动，或多通道横向对比时，跑一轮做参考。
怎么用
执行 aikey web trust-check，自动在浏览器里打开本地面板，几分钟出结果，无需额外安装。
结果怎么看
分数反映回答的一致性与稳定性，仅作横向参考。分数偏低可能与通道波动、限流、缓存等多种因素相关，建议结合自身使用体感综合判断。
检测原理与详细指标请参考 降智检测说明。
查看「让降智不再偷走产出」案例Agent 可以调用，但真实 Key 不离开 Vault
Web 选择虚拟 Key
用户选择允许 Agent 使用的 route token，不选择真实凭证。
OAuth 授权
授权给本地 Agent 的是可撤销入口，不是明文 KEY。
本地调用
Agent 走 AiKey 本地入口，真实 provider key 仍由 Vault 托管。
撤销与统计
按 Agent 撤销访问，按 token / provider / model 查看用量。
最新稳定版（推荐 —— 自动解析最新 GA tag）：
curl -fsSL https://aikeylabs.com/zh/i/of | bash
安装目录为 ~/.aikey/bin。
最低支持 Windows 10 1809+ / Windows 11。支持 PowerShell 7+ 或 Windows PowerShell 5.1。
$f="$env:TEMP\aikey-w.ps1"; curl.exe --ssl-no-revoke -fsSLo $f https://aikeylabs.com/zh/iw/of; & $f
安装后如需自动激活 shell，请执行：aikey hook install
使用个人 API Key
将你的 API Key 添加到本地加密 vault。
1. 添加并激活 Key
aikey add my-key aikey use my-key
2. 直接使用常用工具
本地代理会自动注入 Key，无需暴露真实凭证。
如果你有 Claude Pro/Max、ChatGPT Plus 等订阅，可以直接登录使用：
Claude (Anthropic)
Codex / ChatGPT
Kimi Code
Web 控制台
使用团队 Key
适用于管理员已在控制台创建并分配好的场景。
aikey login # 登录并授权 aikey use # 选择 Key (上下箭头 + 回车)
- 纯个人使用时：AiKey 没有「对话审计」这个功能，你的对话正文只留在你自己的电脑上。合规检测也在本机完成，命中的原文也只留在你的电脑上、不会上传。
- 用
aikey login连到公司的团队 / 集群服务端后，会变成两件事，两件都要知道： - 🔴 ① 合规检测命中时会上传一小段你写的原文（2026-08-11 更正）：本页此前写作「
合规检测也在本机完成、不上传对话正文」，这句在连到公司服务端之后已不成立。检测仍在你自己的电脑上跑，但当公司的合规隐私策略开到最高档时，命中处前后各约 24 个字符、最多 512 字节的原文片段会随合规事件上传到公司自己部署的服务器，公司管理员看得到，保留 90 天后自动清空。公司全新安装的团队版 / 集群版，这一档出厂就是开的（升级上来的老部署则维持关闭）——具体开没开，请向公司管理员确认。这个开关在公司服务端，你的电脑上开不了也关不掉。 - ② 对话审计（另一条独立开关）：如果贵公司开启了它，你的完整对话正文（提问全文 + AI 回复全文 + system prompt）会上传到公司自己部署的服务器，公司管理员可以回看。默认：单机生产版默认关，集群版安装时默认开——具体开没开，请向公司管理员确认。它和 ① 互不依赖：它关着的时候，① 的命中片段照样在传。
- 采集在打码之前：被合规检测遮蔽掉的敏感内容，在对话审计里仍然是明文可读的。
- 数据不进 AiKey 厂商：存的是贵公司自己的服务器，AiKey 不运营也无法访问。
CI / 脚本集成 (无交互)
不依赖 shell hook，适合 GitHub Actions 或定时任务。
aikey run -- python eval.py
每行依次跑 Ping(D) → Ping(代理) → API → Chat 四阶探测。
aikey test
当前已激活的 Primary 逐个体检
aikey test my-key
指定 Key 各协议全量自检
aikey test --all
Vault 内所有 Key 全量体检
临时切换 Key
在当前终端临时激活，关闭终端即失效，不修改全局设置。
aikey activate my-key # 在当前终端激活 aikey deactivate # 立即恢复全局设置
在第三方 AI 客户端中使用
查看指定 Key 的路由 token 配置：
aikey route my-key
{
"provider": {
"anthropic": {
"options": {
"baseURL": "http://127.0.0.1:27200/anthropic/v1",
}
}
},
"model": "anthropic/claude-opus-4-7"
}
日常操作速查
aikey whoami
查看当前身份和当前 Key
aikey doctor
一键自检常见问题
aikey list
列出所有可用的 Key
aikey key sync
强制同步 Key 状态
装完立刻 aikey: command not found
新 PATH 只在新开的窗口生效。请尝试重启终端。
运行 aikey use 后没看到提示符变化
PowerShell hook 未安装。请执行 aikey hook install。
aikey-proxy.exe 升级报 file in use
先关闭 proxy：aikey proxy stop，如有残留请强杀旧进程。