如何用一行命令免费体验T3 Code：npx t3@latest快速上手教程

如何用一行命令免费体验T3 Code：npx t3@latest快速上手教程

【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3code

T3 Code 是一款开源的 AI 编码 Agent 控制台：只需在终端输入一行命令npx t3@latest，即可免费在本地启动服务，通过网页、手机 App 或桌面端统一指挥你机器上的 Claude Code、Codex、Cursor 等 AI 编程助手。本文带你快速完成第一次上手，从启动到手机远程控制只需几分钟。

T3 Code 是什么？为什么值得试

简单说，T3 Code 是一个"Agent 驾驶舱"：它不替你调用大模型，而是接管你电脑上已经装好的编码 Agent CLI，把多个任务线程、代码变更 Diff、权限审批集中到一个现代化界面里。

其中 Codex 和 Claude 默认开启，其余可在Settings中手动打开。你已有的订阅直接在 T3 Code 中使用，无需额外购买 API 额度——这也是它"免费体验"的关键。

一行命令快速启动：npx t3@latest 完整步骤

前置条件（只需满足两条）：

1. 机器已安装 Node.js22.16+、23.11+或24.10+；
2. 至少一个上表中的 Agent CLI 已安装并完成登录（登录要在运行 T3 Code 的这台机器上执行）。

启动步骤🚀：

1. 打开终端，进入你的项目目录；
2. 执行npx t3@latest，首次运行会自动拉取最新版并启动本地后端 + 打开浏览器；
3. 想查看完整 CLI 参考，运行npx t3@latest --help。

没有全局安装、不污染环境，用完即走，是官方推荐的"零安装试玩"方式。核心服务代码位于仓库的apps/server/，网页前端在apps/web/。

界面速览：像管理项目一样管理 AI 任务

进入后你会看到三块核心区域：

• 左侧任务列表：每个项目下的 AI 任务线程，状态一目了然（Working / Completed / 失败原因）；
• 中间会话区：Agent 的思考过程、工具调用、命令执行结果全部流式展示，关键操作支持内联"批准/拒绝"；
• 变更 Diff 面板：修改的文件以红绿色 diff 呈现，支持查看单个文件变更。

权限模式决定 Agent 的自主程度，可在输入框处逐任务切换：

• Supervised：执行命令和改文件前都要你批准，适合新任务；
• Auto-accept edits：自动放行文件编辑，命令仍需审批，适合重构；
• Auto：常规操作自动执行，高风险操作才询问；
• Full access：完全放权（默认），适合可丢弃的 worktree。

更多细节可参考仓库内docs/user/permission-modes.md文档。

手机远程访问：npx t3 pair 扫码配对

T3 Code 的一大亮点是"人在哪，Agent 就在哪" 📱。服务器运行中时，只需再敲一行：

npx t3 pair

终端会打印一次性配对 URL 和二维码，用官方 iOS / Android App 或网页端app.t3.codes扫码，即可从手机上查看并指挥电脑上的 AI 任务。需要跨网络时，可用npx t3 pair --tailscale通过 Tailscale 隧道安全接入。移动端与桌面端共用的连接逻辑在apps/mobile/和packages/client-runtime/。

想长期用？安装桌面应用

试玩满意后，可安装独立桌面端（Windows：winget install T3Tools.T3Code；macOS：brew install --cask t3-code；Arch：AUR 的t3code-bin），它会把后台服务常驻运行，Linux 下还支持后台服务模式，详见docs/user/background-service.md。

常见问题

Q：npx t3@latest 卡住或报错？确认 Node 版本 ≥ 22.16，且终端网络可正常拉取 npm 包。Q：启动后看不到我的 Agent？该 CLI 是否在PATH中？可在 Settings 的提供商卡片里手动指定 Binary path。Q：费用怎么算？T3 Code 本身免费开源，模型消耗沿用你各 Agent 的原有订阅，Usage 页面还能统计 token 与等效成本（docs/user/usage.md）。

写在最后

一行npx t3@latest，就把分散在多个终端里的 AI 编程助手收进了一个控制台：任务线程、Diff 审查、权限审批、手机远程，全部就绪。建议从 Supervised 模式跑一个小任务起步，熟悉后再切到 Full access 全速推进。完整文档入口在仓库docs/目录，祝使用愉快 ✅

【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3code