AgnesCode 逆向工程

认证协议与 AI 通信协议完整分析

深入分析 AgnesCode 的授权登录机制、AI 交互协议，为构建反向代理提供底层技术支撑

开始阅读

查看源码

🔐 认证协议

完整 OAuth2 授权流程、Deep Link 协议、OAuth Token 交换、API Key 认证、Token 生命周期管理

🔌 通信协议

ACP WebSocket (JSON-RPC 2.0)、Agnes BFF API、agnest 本地 HTTP API、Electron IPC 协议、AI 提供商路由

📚 参考手册

端到端工程化参考、协议深度分析、反向代理实现蓝图、模型清单与定价、额度与速率限制

项目背景

AgnesCode 是一款 AI 编程助手桌面应用。本项目通过逆向分析其认证协议和 AI 通信协议，产出了：

12 份技术文档 — 涵盖认证体系、通信协议、后端架构、AI 提供商路由等
Python SDK — 可直接使用的认证 + AI 调用客户端
反向代理框架 — 为构建 AI 中转代理提供底层技术支撑

无论你是想了解其技术实现细节，还是基于其协议构建自己的工具，这里都有你需要的参考信息。

快速开始

bash

# 安装依赖
pip install httpx

# 设置 JWT Token
export AGNES_JWT_TOKEN="你的JWT Token"

# 使用 SDK
python3 -c "
from agnes_sdk import AgnesClient
import os
client = AgnesClient(jwt_token=os.environ['AGNES_JWT_TOKEN'])
client.authenticate()
models = client.list_models()
for m in models:
    print(f'{\"✅\" if not m.is_member_only else \"🔒\"} {m.id}')
"

可用模型

模型	提供商	免费/付费	输入上限	输出上限
agnes-2.0-flash	agnes	免费	512K	65K
agnes-2.5-flash 🧪	agnes	免费	512K	65K
glm-5.2	智谱 AI	会员	1M	131K
deepseek-v4-pro	deepseek	会员	1M	393K
gemini-3.5-flash	google	会员	1M	65K
gpt-5.5	openai	会员	10M	131K
claude-opus-4-8	anthropic	会员	1M	131K