T3 Code快速配對(duì)教程t3 pair 一條命令生成二維碼手機(jī)秒連開(kāi)發(fā)機(jī)完整指南【免費(fèi)下載鏈接】t3code項(xiàng)目地址: https://gitcode.com/GitHub_Trending/t3/t3codeT3 Code 是一款跑在本地開(kāi)發(fā)機(jī)上的 AI 編碼 Agent 圖形界面Web 桌面端支持 Codex、Claude Code、Cursor 等多家模型提供商。而t3 pair是它最省心的遠(yuǎn)程入口在開(kāi)發(fā)機(jī)終端敲一條命令即可為已運(yùn)行的 T3 Code 服務(wù)簽發(fā)電一次性配對(duì)令牌并把配對(duì) URL 直接渲染成終端二維碼——手機(jī)掃一眼幾秒內(nèi)就能連上開(kāi)發(fā)機(jī)繼續(xù)指揮你的 Agent 干活。配對(duì)前準(zhǔn)備先讓服務(wù)器跑起來(lái)t3 pair面向的是已經(jīng)運(yùn)行中的服務(wù)器它不會(huì)替你啟動(dòng)服務(wù)。先確認(rèn)以下條件開(kāi)發(fā)機(jī)已安裝 Node.js版本要求^22.16 || ^23.11 || 24.10T3 Code 服務(wù)在運(yùn)行桌面 App 正在使用或者已執(zhí)行過(guò)npx t3 serve如果服務(wù)是全新的可以先用npx t3latest快速啟動(dòng)一次沒(méi)有運(yùn)行中的服務(wù)器時(shí)t3 pair會(huì)明確告訴你沒(méi)找到并指引你去執(zhí)行npx t3 serve或npx t3 connect不會(huì)誤操作。安裝細(xì)節(jié)可參考官方文檔docs/user/install.md、docs/user/remote-access.md一鍵生成配對(duì)二維碼npx t3 pair在運(yùn)行 T3 Code 服務(wù)器的那臺(tái)開(kāi)發(fā)機(jī)上打開(kāi)終端執(zhí)行npx t3 pair命令會(huì)自動(dòng)完成三件事發(fā)現(xiàn)運(yùn)行中的服務(wù)讀取服務(wù)持久化的server-runtime.json位于~/.t3共享目錄或在 git worktree 內(nèi)開(kāi)發(fā)時(shí)優(yōu)先匹配該 worktree 自己的開(kāi)發(fā)服務(wù)器并真實(shí)探測(cè)進(jìn)程是否在應(yīng)答簽發(fā)一次性配對(duì)令牌默認(rèn) 5 分鐘有效打印二維碼終端里直接渲染 QR 碼同時(shí)附上配對(duì) URL、令牌和過(guò)期時(shí)間。輸出大致長(zhǎng)這樣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整個(gè)過(guò)程不重啟任何服務(wù)對(duì)正在跑的會(huì)話零打擾。手機(jī)掃碼秒連3 步完成配對(duì)掏出手機(jī)用T3 Code 移動(dòng) App或任意掃碼工具掃終端里的二維碼手機(jī)端會(huì)帶著一次性令牌訪問(wèn)開(kāi)發(fā)機(jī)上的配對(duì) URL服務(wù)器驗(yàn)證后為該設(shè)備創(chuàng)建一個(gè)已認(rèn)證會(huì)話配對(duì)完成手機(jī)上即可看到開(kāi)發(fā)機(jī)上的項(xiàng)目、會(huì)話和 Agent 輸出。之后手機(jī)訪問(wèn)是會(huì)話制的不需要反復(fù)使用原令牌——除非你要配對(duì)第二臺(tái)設(shè)備。如果手機(jī)不在身邊、不方便掃碼也可以在 App 的Add Environment表單里手動(dòng)填寫(xiě)主機(jī)地址和令牌效果相同。常用參數(shù)速查表參數(shù)作用示例--ttl自定義令牌有效期默認(rèn) 5 分鐘npx t3 pair --ttl 1h--label令牌在服務(wù)器連接列表中的顯示名--label my-iphone--tailscale通過(guò) Tailscale Serve 的 HTTPS 地址配對(duì)見(jiàn)下節(jié)npx t3 pair --tailscale--tailscale-serve-port指定 Tailscale Serve 的 HTTPS 端口默認(rèn) 443--tailscale-serve-port 8443--base-dir指定要配對(duì)的數(shù)據(jù)目錄多實(shí)例場(chǎng)景--base-dir /path/to/.t3進(jìn)階跨網(wǎng)配對(duì)用 Tailscale如果服務(wù)只綁定在 loopback127.0.0.1手機(jī)是打不開(kāi)的t3 pair會(huì)在輸出里提醒你。此時(shí)推薦把設(shè)備組進(jìn)同一個(gè)tailnet如 Tailscale然后npx t3 pair --tailscale該參數(shù)會(huì)自動(dòng)把服務(wù)發(fā)布到 Tailscale Serve 的 HTTPS 端點(diǎn)https://機(jī)器名.tailnet.ts.net/首次訪問(wèn)稍等幾秒即可——Tailscale 在按需簽發(fā) HTTPS 證書(shū)。配對(duì) URL 走 tailnet 地址不需要把服務(wù)暴露到公網(wǎng)。注意事項(xiàng)映射會(huì)持久保留取消用tailscale serve --https443 off如果該 HTTPS 端口已被另一個(gè) T3 Code 服務(wù)占用命令會(huì)報(bào)錯(cuò)并提示你換個(gè)端口桌面 App 用戶也可以在Settings → Connections → Enable Tailscale HTTPS里用同樣的方式開(kāi)啟常見(jiàn)問(wèn)題快速排查掃了碼連不上 / 提示 URL 不可達(dá)說(shuō)明服務(wù)只監(jiān)聽(tīng)在本地回環(huán)地址。要么加--tailscale走 tailnet要么重啟服務(wù)并用--host綁定局域網(wǎng)或 tailnet IP例如npx t3 serve --host $(tailscale ip -4)。提示 No running T3 Code server found開(kāi)發(fā)機(jī)上沒(méi)有活著的 T3 服務(wù)。先npx t3 serve啟動(dòng)一個(gè)無(wú)頭模式同樣會(huì)打印二維碼再回來(lái)配對(duì)。令牌過(guò)期了怎么辦令牌是一次性的且有時(shí)效默認(rèn) 5 分鐘。重跑一次t3 pair即可代價(jià)為零。手機(jī) App 和遠(yuǎn)程服務(wù)器版本不一致界面會(huì)出現(xiàn)版本提示會(huì)話里 Settings → Connections。按提示操作T3 Code 有時(shí)能自動(dòng)幫你更新并重新連接遠(yuǎn)程服務(wù)否則它會(huì)給出一條要在服務(wù)器機(jī)器上執(zhí)行的命令。不想讓別人連了用t3 auth管理訪問(wèn)查看活動(dòng)會(huì)話、吊銷舊的配對(duì)鏈接或會(huì)話。配對(duì)著手處理docs/user/remote-access.md安全小貼士把配對(duì) URL 和令牌當(dāng)密碼對(duì)待誰(shuí)拿到有效憑證誰(shuí)就能在有效期內(nèi)創(chuàng)建會(huì)話優(yōu)先綁定可信的私有地址如 tailnet IP避免把服務(wù)廣泛暴露不信任的設(shè)備用完后用t3 auth及時(shí)吊銷相關(guān)資源官方遠(yuǎn)程訪問(wèn)文檔docs/user/remote-access.md安裝指南docs/user/install.mdt3 pair命令源碼apps/server/src/cli/pair.tsCLI 命令入口apps/server/src/bin.ts一句話總結(jié)服務(wù)器上跑著 T3 Code終端敲npx t3 pair掏出手機(jī)掃碼幾十秒后你的開(kāi)發(fā)機(jī)就裝進(jìn)了口袋。【免費(fèi)下載鏈接】t3code項(xiàng)目地址: https://gitcode.com/GitHub_Trending/t3/t3code創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考