用途：该指南用于在 Nansen CLI 中做路由决策，判断某个研究问题应交给 nansen agent（AI 分析）还是直接调用 CLI 数据命令。
主要能力：
- 需要解读或跨多数据源综合时使用 nansen agent，例如分析钱包、查看 ETH 聪明钱动态。示例：nansen agent "What are top smart money tokens on Solana today and why?"、nansen agent "Analyse wallet 0x123... -- is this a smart trader?"，深度分析可加 --expert。成本为 200 credits（fast）或 750 credits（expert）。
- 需要具体结构化数据（价格、成交量、持有者、资金流）或确定性问题时使用直接 CLI 命令，便于管道输出或建表。示例：nansen research token screener --chain ethereum --smart-money --limit 10、nansen research smart-money netflow --chain solana、nansen research profiler balance --address 0x123... --chain ethereum。成本为每次调用 5-50 credits。
- 需要叙述加数据时，用 agent 做叙述、CLI 取数据。
反面模式：不要用 nansen agent 做简单取数（贵约 40 倍）；不要用原始 CLI 做开放式分析；不要串联 3 次以上 agent 调用，应先用 CLI 取原始数据，再调用一次 agent 综合。
认证：Nansen 账户 API 调用接受选定的 nansen:api 浏览器会话或具有相同权限的传统 API key；NANSEN_API_KEY 优先；可运行 nansen auth status 做离线选择。登录方面：普通 nansen login 请求新的浏览器批准，--no-browser 会打印链接/代码供在另一设备批准；显式 login --human 或 login --api-key 保留旧版 key 设置。浏览器登录不授予钱包签名、特权服务身份或持久 MCP 集成 key；浏览器会话不可授权钱包签名，也不能导出为 MCP key。浏览器登录在 CLI 2.0.0 的 macOS arm64 预览范围内可用。遇到匿名选择、无效状态、恢复被阻断/不确定或实际认证失败时应停止，不得降级为匿名 x402 支付。