代理服务器
在您的计算机或服务器上运行编码代理,并从代理iOS和Android应用中控制它们. 开始工作,跟踪进度,发送指令并审查您的电话结果,同时代理人员运行在自己的机器上.
此软件包安装代理服务器和 agentrific 用于macOS和Linux的命令行工具. 移动应用程序连接到您的服务器;您的寄存器、模型账户和代理程序都留在机器上。 配对设备可以断开并重新连接而无需结束运行的代理会话.
有了代理,你可以:
- 在您的 Git 仓库中管理任务和代理会话 .
- 在独立的 Git 工作树中运行编码任务 .
- 跟踪现场进展 并发送后续指令 从您的手机.
- 附加图像和文件以给出代理上下文 .
- 与同一服务器对等多个设备,并在需要时取消访问.
学习更多 (原始内容存档于2019-10-21). agentrific.com。 。 。 .
安装和启动
你需要22.19节节点 或更新,基特,和 Pi 将运行你的特工。 安装 Pi并使用运行服务器的同一 OS 账户连接您的模型账户 。 见 模式设置指南。 。 。 .
OpenTunnel被捆绑并是默认的HTTPS连接,没有单独的隧道二进制或账户. 或者在服务器和电话上安装分级,或 cloudflared 在服务器上。 也可以使用已有的HTTPS隧道或倒置代理. 代理不为您安装这些工具 。 见 连接设置指南。 。 。 .
npm install -g @agentrific/server
agentrific init
agentrific start
服务器默认为端口 4318 并将其配置和状态存储于 ~/.agentrific。其初始项目文件夹是 ~/projects; 您可以在应用程序的服务器设置中选择一个不同的文件夹 .
克劳德代码
如果 Claude 代码在服务器的 OS 账户下安装并登录, Agentrific 将自动添加 a 克劳德代码 模式连接。 运行 claude auth login 如果需要登录,请刷新模型列表。 服务器检查 PATH, (中文(简体) ), ~/.local/bin/claude 财务报告和审定财务报表 ~/.claude/local/claude;它还尊重 CLAUDE_CONFIG_DIR。 。 。 .
类似管道,此连接使用 pi-claude-agent-sdk 和克洛德特工SDK的孩子 和你们现有的CLI登录 Pi仍然拥有工具,任务历史和代理执行. SDK提供相容的克洛德可执行文件并处理证书刷新;Agentrific不将证书复制到Pi或发送给客户. 继承克洛德/Anthropic环境配置仍然适用.
当未保存默认时,一个已准备好的克洛德代码连接就成为使用其目录中的第一个Sonnet模型进行新会话的默认. 保存已保存的默认和已存在的会话选择 。 安装但未经认证的模型似乎无法使用登录指导 。 设定 AGENTRIFIC_CLAUDE_CODE=off 在启动服务器以禁用发现之前.
开发运行在开始前会编译桥梁. 其CLI-login和会话-同位素的适应被编译为已出版的套件,因此npm安装不依赖于只工作空间的Yarn补丁.
连接您的手机
在iOS或Android上打开代理应用程序. 在服务器终端中,接受默认的 OpenTunnel 连接,或选择 Tailscale Service, Cloudflare 隧道,或现有的 HTTPS 端点,然后按 页:1 以显示对齐的 QR 代码。 在应用程序中扫描并输入单独打印的六位数PIN.
在网络应用程序中已经对齐了吗? 打开 设置 ~ 对等设备 生成 QR 代码,并为另一个设备分离 PIN。 邀请书在五分钟后过期,可使用一次。 服务器必须配置一个公开的 HTTPS URL(AGENTRIFIC_PUBLIC_URL; 更改后重新启动。 仅与可信任的设备共享邀请: 配对允许作为服务器主机用户的运行代理访问 .
一旦对齐,选择一个工程,创建任务并启动代理. 服务器运行工作, 流程会返回您的设备 。 远程连接使用 HTTPS; 您的手机必须能够到达配置的服务器地址 .
见 服务器设置和配对指南 用于连接选项和配置.
有用命令
agentrific --help # Show commands and options
agentrific start --connection local # Start without a public phone connection
agentrific status # Show server status
agentrific pair # Print a fresh pairing QR code and PIN
agentrific devices # List paired devices
agentrific update --check # Check for a newer server release
访问和权限
设备在访问服务器命令和事件前必须配对. 用服务器用户权限执行编码代理,所以在账户下运行服务器,只访问您打算使用的寄存器和证书.