T3 Code快速配对教程t3 pair 一条命令生成二维码手机秒连开发机完整指南【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3codeT3 Code 是一款跑在本地开发机上的 AI 编码 Agent 图形界面Web 桌面端支持 Codex、Claude Code、Cursor 等多家模型提供商。而t3 pair是它最省心的远程入口在开发机终端敲一条命令即可为已运行的 T3 Code 服务签发电一次性配对令牌并把配对 URL 直接渲染成终端二维码——手机扫一眼几秒内就能连上开发机继续指挥你的 Agent 干活。配对前准备先让服务器跑起来t3 pair面向的是已经运行中的服务器它不会替你启动服务。先确认以下条件开发机已安装 Node.js版本要求^22.16 || ^23.11 || 24.10T3 Code 服务在运行桌面 App 正在使用或者已执行过npx t3 serve如果服务是全新的可以先用npx t3latest快速启动一次没有运行中的服务器时t3 pair会明确告诉你没找到并指引你去执行npx t3 serve或npx t3 connect不会误操作。安装细节可参考官方文档docs/user/install.md、docs/user/remote-access.md一键生成配对二维码npx t3 pair在运行 T3 Code 服务器的那台开发机上打开终端执行npx t3 pair命令会自动完成三件事发现运行中的服务读取服务持久化的server-runtime.json位于~/.t3共享目录或在 git worktree 内开发时优先匹配该 worktree 自己的开发服务器并真实探测进程是否在应答签发一次性配对令牌默认 5 分钟有效打印二维码终端里直接渲染 QR 码同时附上配对 URL、令牌和过期时间。输出大致长这样Pairing with my-laptop (http://192.168.1.20:3773). ▓▓▓▓▓ ▄▄▄ ▓▓▓ ← 终端二维码 ... Pairing URL: http://192.168.1.20:3773/pair?... Token: XXXXXXXX Expires: 2026-08-28T04:05:00Z整个过程不重启任何服务对正在跑的会话零打扰。手机扫码秒连3 步完成配对掏出手机用T3 Code 移动 App或任意扫码工具扫终端里的二维码手机端会带着一次性令牌访问开发机上的配对 URL服务器验证后为该设备创建一个已认证会话配对完成手机上即可看到开发机上的项目、会话和 Agent 输出。之后手机访问是会话制的不需要反复使用原令牌——除非你要配对第二台设备。如果手机不在身边、不方便扫码也可以在 App 的Add Environment表单里手动填写主机地址和令牌效果相同。常用参数速查表参数作用示例--ttl自定义令牌有效期默认 5 分钟npx t3 pair --ttl 1h--label令牌在服务器连接列表中的显示名--label my-iphone--tailscale通过 Tailscale Serve 的 HTTPS 地址配对见下节npx t3 pair --tailscale--tailscale-serve-port指定 Tailscale Serve 的 HTTPS 端口默认 443--tailscale-serve-port 8443--base-dir指定要配对的数据目录多实例场景--base-dir /path/to/.t3进阶跨网配对用 Tailscale如果服务只绑定在 loopback127.0.0.1手机是打不开的t3 pair会在输出里提醒你。此时推荐把设备组进同一个tailnet如 Tailscale然后npx t3 pair --tailscale该参数会自动把服务发布到 Tailscale Serve 的 HTTPS 端点https://机器名.tailnet.ts.net/首次访问稍等几秒即可——Tailscale 在按需签发 HTTPS 证书。配对 URL 走 tailnet 地址不需要把服务暴露到公网。注意事项映射会持久保留取消用tailscale serve --https443 off如果该 HTTPS 端口已被另一个 T3 Code 服务占用命令会报错并提示你换个端口桌面 App 用户也可以在Settings → Connections → Enable Tailscale HTTPS里用同样的方式开启常见问题快速排查扫了码连不上 / 提示 URL 不可达说明服务只监听在本地回环地址。要么加--tailscale走 tailnet要么重启服务并用--host绑定局域网或 tailnet IP例如npx t3 serve --host $(tailscale ip -4)。提示 No running T3 Code server found开发机上没有活着的 T3 服务。先npx t3 serve启动一个无头模式同样会打印二维码再回来配对。令牌过期了怎么办令牌是一次性的且有时效默认 5 分钟。重跑一次t3 pair即可代价为零。手机 App 和远程服务器版本不一致界面会出现版本提示会话里 Settings → Connections。按提示操作T3 Code 有时能自动帮你更新并重新连接远程服务否则它会给出一条要在服务器机器上执行的命令。不想让别人连了用t3 auth管理访问查看活动会话、吊销旧的配对链接或会话。配对着手处理docs/user/remote-access.md安全小贴士把配对 URL 和令牌当密码对待谁拿到有效凭证谁就能在有效期内创建会话优先绑定可信的私有地址如 tailnet IP避免把服务广泛暴露不信任的设备用完后用t3 auth及时吊销相关资源官方远程访问文档docs/user/remote-access.md安装指南docs/user/install.mdt3 pair命令源码apps/server/src/cli/pair.tsCLI 命令入口apps/server/src/bin.ts一句话总结服务器上跑着 T3 Code终端敲npx t3 pair掏出手机扫码几十秒后你的开发机就装进了口袋。【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考