用途:作为本地凭据注入代理,让智能体通过 localhost 调用外部服务,密钥不进入智能体进程。启动前需已用 agent-id-vault init 生成含至少一个凭据的便携保险库。
主要能力:代理在内存持有已解锁保险库的主密钥,接收 HTTP 请求并注入凭据后转发上游。两种请求形态:URL 重写(推荐)为 http://<proxy>/<credname>/<upstream-host>/<path>,credname 选择凭据,下一段为上游主机(按该凭据允许列表校验),其余原样转发;HTTP_PROXY 桩注入为旧模式,仅支持纯 HTTP 上游。凭据类型包括 bearer、basic、header、query、cookie、cookie-jar、totp、solana-keypair、evm-keypair,按类型注入。钱包类凭据不注入头部,而是在 JSON-RPC 请求体内签名:Solana 的 sendTransaction 参数被签名,其余方法透传;EVM 的 eth_sendTransaction 被改写为 eth_sendRawTransaction,用 EIP-1559 交易签名,需显式提供 chainId、nonce、gas、maxFeePerGas、maxPriorityFeePerGas,from 若存在须与凭据地址一致。支持只读访问级别(--access ro),默认拒绝写入;访问级别、主机允许列表,以及启动时 --require-consent 的按(凭据、主机)人工授权构成授权门。
使用方式:启动命令 node CLI start --port 48771(CLI 即 ${CLAUDE_PLUGIN_ROOT}/bin/cli.mjs)。可选 --unlock-form、--passphrase-file、--idle-timeout、--auth-token-file。示例:curl http://localhost:48771/github-pat/api.github.com/user。CLI 会打印建议的环境变量导出,如 export AGENT_ID_PROXY=http://127.0.0.1:48771。停止与状态:node CLI stop、node CLI status。
适用场景:智能体需要调用带密钥的外部 API、在共享环境中避免明文密钥暴露、钱包签名类 RPC 调用。
限制:URL 重写模式下仅上游段为 HTTPS,智能体到代理段按设计为明文 HTTP 回环;--auth-token-file 只控制谁可使用,不加密。安全提示:该技能预先批准 Bash(curl:*),会授权任意出站 HTTP,存在外泄通道风险,高风险场景建议去掉统一 curl 授权并逐次批准。空闲自动锁定后行为取决于启动时的解锁方式。凭据在代理运行期间新增时,仅在 agent-key 自动解锁下会被重新读取。桩注入旧模式仅按方法/主机/路径执行访问级别,POST 隧道的读取不被分类,建议用 URL 重写模式。其他细节以官方资料为准,暂未提供的部分不在此展开。