然后完全退出并重启 Claude Desktop。

安全。AgentKey 是 Agent 的"万能钥匙"—— 一个平台帮你的 Agent 解锁外部能力。按架构设计，我们看不到你的本地文件、凭证或 Agent 的对话。AgentKey 只采集匿名使用统计 —— 你装到了哪些 Agent、Skill 版本、升级结果 —— 永远不采集你的查询内容或返回数据。详见下方"我如何关闭遥测？"。

Claude 与 ChatGPT 的原生联网与平台覆盖有限，往往触达不到推特、链上数据等。AgentKey 让你的 Agent 能覆盖这些场景（具体以当前产品能力为准）。

AgentKey 采用订阅制。每档套餐包含每月的 credits 额度，超出部分按量计费（超额付费）。你可以随时在 console.agentkey.app 升级套餐或管理账单。具体套餐与价格见 agentkey.app。

AgentKey 有两部分，更新方式不同：

• MCP server：真正的服务端在 https://api.agentkey.app/v1/mcp，永远自动最新，不需要本地升级。@agentkey/cli 包（npx -y @agentkey/cli --auth-login）只负责把远程 HTTP MCP 配置写入各个 AI client，除非要换 API Key，否则不用再跑。

• Skill 文件（SKILL.md 加辅助脚本）：升级方式取决于你用的 client。

Claude Code

完全自动。每次会话第一次调用 skill 时会静默跑版本检查；发现新版本会提示你升级，得到你确认后跑 npx skills update -g agentkey。

Claude Desktop / Cursor 等没有 inline Bash 工具的 client

Skill 自己跑不了 inline 检查，但从 v1.4.0 起 MCP server 通过专用 metadata tool（agentkey_skill_meta）发布最新 skill 版本号。Agent 在每个会话里调一次，对比本地 skill 版本，发现差异就用你 client 对应的精确命令提示你升级。协议细节见 protocol/skill-meta-v1.md。

Desktop 一次性破冰升级：如果你 Desktop 里的 skill 还停在 1.4.0 之前，metadata tool 存在但旧 skill 不懂怎么读。先手动同步一次到最新版：

# 把 <UUID1>/<UUID2> 替换成 skills-plugin 下实际的 session 目录
# （通常就一个，找包含 skills/agentkey/SKILL.md 的那个）
DESKTOP_BASE="$HOME/Library/Application Support/Claude/local-agent-mode-sessions/skills-plugin"
LATEST_REPO_ZIP=$(mktemp -d)/agentkey.tar.gz
curl -fsSL https://github.com/chainbase-labs/agentkey/archive/refs/heads/main.tar.gz -o "$LATEST_REPO_ZIP"
tar -xzf "$LATEST_REPO_ZIP" -C "$(dirname "$LATEST_REPO_ZIP")"
find "$DESKTOP_BASE" -type d -path "*/skills/agentkey" 2>/dev/null | while read -r dst; do
  cp -R "$(dirname "$LATEST_REPO_ZIP")"/agentkey-main/skills/agentkey/. "$dst/"
done
# 然后完全退出并重启 Claude Desktop。

破冰之后，后续每次新版都会通过 metadata tool 自动告知，无需再手动操作。

任意 client：强制手动更新

# 拉最新版的 Skill 内容
npx skills update agentkey

# 锁定特定版本
npx skills add chainbase-labs/agentkey@v1.0.0

注意：npx skills update 只写 ~/.agents/skills/agentkey 和 ~/.claude/skills/agentkey 这两个目录，是 Claude Code 读取的位置。Claude Desktop 读的是自己的 sandbox 路径，npx skills update 碰不到——Desktop 升级要用上面的破冰命令。

只有在需要换 API Key 时才需要再跑一次 npx -y @agentkey/cli --auth-login。

一条命令，清理所有 Agent 与配置。

macOS / Linux

curl -fsSL https://agentkey.app/uninstall.sh | bash

Windows（PowerShell）

irm https://agentkey.app/uninstall.ps1 | iex

把 Skill 从所有 Agent 里清理掉，同时删除各 MCP 客户端里的 agentkey 条目 + API Key，清理缓存和日志。加 --keep-marketplace（bash）/ -KeepMarketplace（PowerShell）可以保留 Claude Code 的 marketplace 条目。

想手动两步卸载？

# 1. 把 Skill 从所有 Agent 里移除
npx skills remove chainbase-labs/agentkey

# 2. 在各 MCP 客户端配置里删掉 mcpServers 下的 "agentkey" 条目：
#    - Claude Code：    ~/.claude.json
#    - Claude Desktop： ~/Library/Application Support/Claude/claude_desktop_config.json  (macOS)
#                      %APPDATA%\Claude\claude_desktop_config.json                       (Windows)
#    - Cursor：         ~/.cursor/mcp.json

一键卸载脚本还会额外清 npm/npx 缓存、旧的 shell rc 残留、CLAUDE.md 里的 AgentKey 段、MCP stdio 日志 —— 想一次清干净就用它。

AgentKey 会上报匿名使用统计（你用的 Agent、Skill 版本、升级结果 —— 永远不会上报查询内容或返回数据）。任选一种方式关闭：

# 持久关闭（推荐）
touch ~/.config/agentkey/telemetry-disabled

# 进程级临时关闭（CI / 单次会话）
AGENTKEY_TELEMETRY=0 <your command>

# 安装时直接关
curl -fsSL https://agentkey.app/install.sh | bash -s -- --no-telemetry

想重新开启，删掉 ~/.config/agentkey/telemetry-disabled 即可。

在 Agent 里试试 /agentkey status —— 会诊断 MCP 配置、版本、连通性。

可用的 Slash 命令：

还是解决不了？看下面"怎么获取帮助"那条。

安装器会自动探测本机已安装的 AI Agent（依据 vercel-labs/skills 支持列表 比对配置目录和命令行工具），自动选中它们 —— 不再弹多选框。需要覆盖时用下面的旗标：

安装器参数：

# 非交互模式（CI / 无人值守）：安装到所有检测到的 Agent，不询问
curl -fsSL https://agentkey.app/install.sh | bash -s -- --yes

# 看一下安装器在本机会自动选中哪些 Agent（看完即退出）
curl -fsSL https://agentkey.app/install.sh | bash -s -- --list-agents

# 只安装到指定的 Agent（覆盖自动检测结果）
curl -fsSL https://agentkey.app/install.sh | bash -s -- --only claude-code,cursor

# 跳过我们的检测，让 skills CLI 自己识别全部 Agent
curl -fsSL https://agentkey.app/install.sh | bash -s -- --all-agents

# 只装 Skill 或只做 MCP 授权
curl -fsSL https://agentkey.app/install.sh | bash -s -- --skip-mcp
curl -fsSL https://agentkey.app/install.sh | bash -s -- --skip-skill

PowerShell 对应参数：-Yes、-ListAgents、-Only、-AllAgents、-SkipMcp、-SkipSkill。

手动两步安装（想自己跑两条底层命令，或一键脚本在你的环境里跑不起来）：

# 1. 把 Skill 装进所有检测到的 Agent
npx skills add chainbase-labs/agentkey

# 2. 浏览器授权并注册 MCP Server
npx -y @agentkey/cli --auth-login

没 GUI / SSH / Docker？ 授权步骤会同时尝试开浏览器并把 URL 打印到终端 —— 在没法弹浏览器的机器上，直接把打印出来的 URL 复制到任何能开浏览器的设备完成授权即可。如果完全不想走 URL 跳转、想自己手动粘 Key，可以用 npx -y @agentkey/cli --setup 走交互式向导。

CLI 支持其当前 Supported agents 列表中的客户端，一键安装器会自动配置检测到的受支持客户端，其中包括 DeepSeek Harness。如果客户端未被检测到，或不支持自动配置，仍可全局安装 Skill，但需要把下面这段 MCP 片段手动贴到该客户端自己的配置里（路径因客户端而异）：

{
  "mcpServers": {
    "agentkey": {
      "type": "http",
      "url": "https://api.agentkey.app/v1/mcp",
      "headers": { "Authorization": "Bearer ak_..." }
    }
  }
}

写完后重启 Agent。你第一次在对话里触发 Skill 时，它也会引导你走这一步。

从本地 checkout 安装：

git clone https://github.com/chainbase-labs/agentkey.git
cd agentkey

# 1. 把当前工作副本装进所有检测到的 Agent
npx skills add .

# 2. 注册 MCP Server（只需一次）
npx -y @agentkey/cli --auth-login

npx skills add . 支持本地路径（也支持 file:// URL），改完 skills/agentkey/SKILL.md 再跑一次就能立刻生效，是日常迭代最快的路径。MCP 注册步骤每台机器只需一次。

想改 MCP Server 本身？ MCP server 在 AgentKey-Server/（Go），端点是 /v1/mcp。本地起服务（make run），把 MCP 配置指向 http://localhost:8081/v1/mcp 就能端到端验证。

Claude Code 插件模式 —— 直接从 marketplace 安装。插件内置不带 header 的远程 HTTP 配置，并使用 Claude Code 原生 MCP OAuth，不用粘贴 API Key，也不需要再单独跑 @agentkey/cli：

# 公开安装
claude plugin marketplace add chainbase-labs/agentkey
claude plugin install agentkey@agentkey

# …或从本地 checkout 安装，用于开发
claude plugin marketplace add /absolute/path/to/agentkey
claude plugin install agentkey@agentkey

安装后运行 /reload-plugins，打开 /mcp，选择 AgentKey 并点击 Authenticate，然后在浏览器完成登录。也可以在终端运行 claude mcp login plugin:agentkey:agentkey 启动同一个 OAuth 流程。插件的 .mcp.json 会刻意保持无 Authorization header：一旦配置这个 header，Claude Code 就会把 server 判定为 header 认证，并在 401 后屏蔽 OAuth fallback。改了本地 checkout 后用 claude plugin update agentkey 重新加载。日常 Skill 迭代仍是 Skills CLI 最快；插件路径是 Claude Code 用户的 OAuth 安装方式。

Codex 插件模式 —— 从本仓库自带的 marketplace 安装。认证走 OAuth（安装时浏览器登录），不用粘贴 API Key，也不需要再单独跑 @agentkey/cli：

# 公开安装
codex plugin marketplace add chainbase-labs/agentkey
# 然后在 Codex 里运行 /plugins 安装 AgentKey，
# 或者：codex plugin install agentkey@agentkey

插件清单在 .codex-plugin/plugin.json；它捆绑了同一个 Skill，外加一条远程 HTTP MCP 配置（.codex-plugin/mcp.json），通过 MCP OAuth（RFC 9728 自动发现）对 https://api.agentkey.app/v1/mcp 做认证。Codex 提示时用你的 AgentKey 账号登录即可。

Kimi Code 插件模式 —— 直接在 Kimi Code 中安装本仓库。插件清单同时捆绑 Skill，并通过客户端归因路由 https://api.agentkey.app/kimi/v1/mcp 提供内联的远程 HTTP MCP 配置，不用粘贴 API Key，也不需要再单独跑 @agentkey/cli：

# 公开安装
/plugins install https://github.com/chainbase-labs/agentkey

# 或从本地 checkout 安装，用于开发
/plugins install /absolute/path/to/agentkey

安装成功后 Kimi 会显示 Run /new or /reload to apply plugin changes.。执行 /reload；当 Kimi 提示插件 MCP 需要 OAuth 时，执行 /mcp-config login plugin-agentkey:agentkey 并在浏览器完成授权，之后即可提出原本的 AgentKey 查询。

Kimi 会把本地插件复制到自己的托管目录。修改原 checkout 后，需要重新执行 /plugins install /absolute/path/to/agentkey，再执行一次 /reload。

如果你曾为旧版 AgentKey plugin 手工通过 /mcp-config 添加过用户全局的 agentkey 条目，请在 reload 前执行一次 /mcp-config remove agentkey 删除旧条目。现在 plugin 会维护自己的命名空间 MCP；同时保留两份会造成工具和鉴权流程重复。

Cursor 插件模式 —— 插件上架后，从 Cursor Marketplace 安装 AgentKey。.cursor-plugin/plugin.json 这个 Cursor 原生清单会同时捆绑同一个 Skill 和内联的远程 HTTP MCP 配置，因此不用粘贴 API Key，也不需要再单独运行 @agentkey/cli。Cursor 提示 MCP 需要认证时，在浏览器完成 AgentKey 登录即可。

维护者需要先把插件推送到公开 Git 仓库，再到 cursor.com/marketplace/publish 提交仓库地址。提交前请使用当前版本 Cursor 实际安装测试，确认 OAuth 完成后 agentkey Skill 和 MCP server 都能正常加载。清单遵循 Cursor 插件参考，其中所有组件路径都必须相对于插件根目录。

Gemini CLI 扩展模式 —— 把本仓库直接安装为 extension。根目录的 gemini-extension.json 会捆绑现有 AgentKey skill 和远程 Streamable HTTP MCP server，不用粘贴 API Key，也不需要再单独跑 @agentkey/cli：

# 公开安装
gemini extensions install https://github.com/chainbase-labs/agentkey

# 或链接本地 checkout，用于开发
gemini extensions link /absolute/path/to/agentkey

安装或链接后重启 Gemini CLI。首次连接时，extension 的 oauth.enabled 会要求 Gemini 自动启动原生浏览器授权；完成授权后执行 /mcp reload 和 /mcp list，确认 agentkey 已连接。如果 Gemini 只提示需要认证，或者浏览器流程被关闭，则执行 /mcp auth agentkey 手动重新发起。Gemini 会保存并自动刷新 OAuth token，因此通常只需要登录一次。Extension 模式下不要再添加一条用户级 MCP 配置，也不要运行 @agentkey/cli --auth-login。

如果 Gemini 提示 ~/.agents/skills/agentkey 覆盖了 extension 捆绑的 Skill，这是独立的 Skill 优先级告警，不是 OAuth 失败。之前安装的用户级 Skill 优先级更高；当两份版本一致时可以安全保留，尤其是其他 Agent 也依赖这个共享目录时。只有确认其他 Agent 不再需要它之后，才执行 gemini skills uninstall agentkey --scope user，再运行 /skills reload。

Antigravity 2.0 / Antigravity CLI 插件模式 —— 两个运行时共用根目录的 plugin.json、mcp_config.json 和现有 skills/。MCP 配置使用 Antigravity 规定的 serverUrl，并通过动态客户端注册自动发现 OAuth，不用粘贴 API Key、不用配置 OAuth client secret，也不需要再单独运行 @agentkey/cli。

Antigravity 2.0 可按 workspace 或全局范围放置插件，完成后重启 Antigravity：

# Workspace 范围
git clone https://github.com/chainbase-labs/agentkey.git /path/to/workspace/.agents/plugins/agentkey

# 或全局范围
git clone https://github.com/chainbase-labs/agentkey.git ~/.gemini/config/plugins/agentkey

Antigravity CLI 使用本地 checkout 安装并确认注册结果：

agy plugin install /absolute/path/to/agentkey
agy plugin list

Antigravity 发现插件后，应认证插件捆绑的 MCP 配置，不要重复添加另一条 server：

• **Antigravity 2.0：**打开 Settings → Customizations → Installed MCP Servers，在 AgentKey 旁点击 Authenticate；在浏览器完成授权后，把 authorization code 复制回设置面板并提交。Server 会自动重连；状态没有更新时点击 Refresh。
• **Antigravity CLI：**打开 /mcp，选择 agentkey 并点击 Authenticate，按界面给出的浏览器/验证码流程完成授权；在同一面板 reload server，确认 AgentKey 工具已经出现。如果仍是 disconnected，可直接在这里检查连接日志。

不要在 mcp_config.json 中写入静态 header、access token 或 OAuth client credential。AgentKey 已发布 protected-resource 与 authorization-server metadata，并提供 dynamic registration endpoint，两个 Antigravity 运行时都应通过这些元数据完成发现。

仓库结构：

agentkey/
├── .claude-plugin/plugin.json   # Claude Code 插件清单
├── .codex-plugin/
│   ├── plugin.json              # Codex 插件清单
│   └── mcp.json                 # Codex MCP 配置（OAuth，无 user_config）
├── .cursor-plugin/
│   └── plugin.json              # Cursor 清单，捆绑 Skill 与内联 MCP OAuth
├── .kimi-plugin/
│   └── plugin.json              # Kimi 清单，内联 MCP OAuth 配置
├── .agents/plugins/marketplace.json  # Codex marketplace（本仓库即自己的 marketplace）
├── .mcp.json                    # Claude 插件 MCP 配置（OAuth 自动发现，无 headers）
├── gemini-extension.json        # Gemini CLI 扩展清单（MCP OAuth + skills）
├── plugin.json                  # Antigravity 桌面端/CLI 插件清单
├── mcp_config.json              # Antigravity 远程 MCP 配置（serverUrl + OAuth）
├── skills/agentkey/
│   ├── SKILL.md                 # 决策树 & 路由规则
│   ├── scripts/                 # check-update 辅助脚本
│   └── version.txt              # 由 release-please 自动维护
└── scripts/
    ├── build-release-assets.sh  # 构建 Skill + Gemini GitHub Release 产物
    ├── install.sh               # 一键安装脚本（mac/linux）
    ├── install.ps1              # Windows PowerShell 安装脚本
    ├── uninstall.sh             # 一键卸载脚本（mac/linux）
    └── uninstall.ps1            # Windows PowerShell 卸载脚本

发布新版本（Maintainer）： 发版由 release-please 自动触发。合并一个 feat: 或 fix: 的 PR 后，release-please 会开一个 Release PR，自动 bump skills/agentkey/version.txt、四个带版本号的插件清单、gemini-extension.json 和 CHANGELOG.md。Antigravity schema 没有 version 字段，因此根目录 plugin.json 不参与版本同步。合并这个 Release PR 即会创建 tag + GitHub Release，保留 agentkey.skill 产物，并上传根目录包含 gemini-extension.json 的平台命名 Gemini 扩展压缩包。

早期内测阶段，产品仍有不少不完善之处，还请担待。功能建议与问题反馈欢迎通过 GitHub Issues 或下面的 Telegram 与我们联系。

• Telegram： t.me/AgentKey_Official —— 通用咨询、支持、需求反馈
• 问题反馈： GitHub Issues
• 发布公告： ⭐ Star 本项目即可在有新版本时收到通知