T3 Code 是 pingdotgg 团队(Theo 的团队)开源的「编码 Agent 控制台」。它本身不是模型,也不是 harness:它调用你机器上已经装好、登录好的 Claude Code、Codex、Cursor CLI、OpenCode 等工具,再给它们套上桌面端、网页端和手机端界面。仓库采用 MIT 许可,截至 2026 年 11 月 12 日 GitHub 星标约 5.7 万。据 X 搜索计数,近 7 天每天提到「T3 Code / t3code」的帖子约 800 到 1100 条。
2026 年 11 月 12 日(北京时间,UTC+8),我们在一台 Linux x64 机器上实测了 npm 当天的 T3 Code 0.1.9。客户端是 Claude Code 2.1.319 和 Codex CLI 0.167.0,两端都接 AICodeWith API Key。本文写的都是这次实际跑到的步骤、输出和报错。
先看结论
| 问题 | 答案 |
|---|---|
| T3 Code 是什么? | 编码 Agent 的统一控制台(GUI + 网页 + 手机端),负责调用已装好的 Claude Code、Codex 等 CLI,本身不提供模型,也不转售 token。 |
| 怎么装? | macOS / Linux 用官方 install.sh,Windows 用 install.ps1,只想试一次用 npx t3@latest;命令见下文「安装 T3 Code」。 |
| 能不能不用官方订阅、改用第三方 API Key? | 能。T3 Code 沿用 CLI 自己的配置:Claude Code 读 ~/.claude/settings.json,Codex 读 ~/.codex/config.toml。两个 CLI 单独能跑,T3 Code 就能调用。 |
| 实测结果 | T3 Code 识别出 Claude 为「Custom API endpoint」且已认证,Codex 状态 ready。同一道修 bug 加补测试的任务,Claude Code 端用时约 30.4 秒,Codex 端约 32.5 秒,两端测试全部通过。 |
| 最需要注意的一点 | 官方文档写明新线程的默认权限是 Full access:命令和改文件都不再弹窗确认。在真实仓库里用之前,先把默认权限改成 Supervised 或 Auto。 |
T3 Code 是什么
据 T3 Code 官方 FAQ,harness 负责把模型变成 Agent,也就是给模型工具、执行工具、回传结果。Claude Code 和 Codex 就是这一层。T3 Code 不做这层,它调用这些 harness,没有它们就不能工作。官方的比喻是:模型是厨师,harness 是厨房,T3 Code 是一家可以「自带厨房」的餐厅。
它的几个主要卖点(据官网与 GitHub README):
- 自带订阅(Bring your own sub):用你已有的 Claude Code、Codex、Cursor、Grok Build、OpenCode、Antigravity 等登录,T3 Code 不转售 token。
- 一处管多个 Agent:每个线程可以选不同的 provider 和模型,线程默认写到各自的分支,可以一键提交、推送、开 PR。
- 远程与手机端:在任意机器上运行
t3 up,再用手机 App 或浏览器连接。 - 完全开源:MIT 许可,可以 fork 后自己改、自己部署。
如果你平时在 Claude Code 和 Codex 之间来回切换,可以先看《Claude Code 跑一半怎么交给 Codex》。T3 Code 把这种切换放到同一个界面里完成。
安装 T3 Code
官方给了三种方式(据 install.md):
# macOS / Linux:安装 t3 命令到 ~/.local/bin
curl -fsSL https://t3.codes/install.sh | sh
# 不安装,直接试一次(需要 Node.js)
npx t3@latest
# Windows PowerShell
irm https://t3.codes/install.ps1 | iex
桌面版可以从 GitHub Releases 下载,也可以用包管理器安装:Windows winget install T3Tools.T3Code,macOS brew install --cask t3-code,Arch yay -S t3code-bin。
装好后常用的命令:
| 要做的事 | 命令 |
|---|---|
| 启动服务并打开网页端 | t3 |
| 只启动服务、不开浏览器(服务器 / SSH 场景) | t3 serve |
| 让手机或其他设备连进来 | t3 up |
| 后台常驻 | t3 service install |
| 升级 | t3 update |
| 命令行开线程、发消息、看结果 | t3 thread start / send / show |
我们这次用 npx -y t3@0.1.9 serve --no-browser 启动,大约 20 秒后(含 npx 首次下载)输出 T3 Code server is ready. 和 Connection string: http://localhost:3773,同时打印配对 token 和二维码,供手机端连接。
第一步:先让 Claude Code 和 Codex 单独能跑
官方文档的前提写得很直接:至少装好并登录一个 provider,T3 Code 才能开线程。用订阅的话,分别运行 claude auth login 和 codex login。用第三方 API Key 的话,只要把两个 CLI 的全局配置写好就行,T3 Code 会照着用。
Claude Code:写全局 ~/.claude/settings.json(第三方 API 的完整说明见《Claude Code 第三方 API 配置》):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "你的 AICodeWith API Key"
}
}
Codex:写全局 ~/.codex/config.toml(安装见《Codex 安装教程》,字段含义见《Codex config.toml 配置指南》):
model_provider = "aicodewith"
model = "gpt-6.1-sol"
[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "你的 AICodeWith API Key"
写完先在终端单独验证一次,两端都应该回一句话:
claude -p "Reply with exactly: pong"
codex exec --skip-git-repo-check "Reply with exactly: pong"
我们这次两条命令都返回 pong,Claude Code 用时约 3.0 秒,Codex 约 3.7 秒。这一步不通,T3 Code 里也不会通,所以排错先从这里开始。
第二步:在 T3 Code 里确认 provider 状态
启动 t3 或 t3 serve 后,T3 Code 会自动探测 PATH 上的 CLI。打开网页端的 Settings → Providers 能看到每个 provider 的状态。我们这次读到的探测结果:
| Provider | 版本 | 状态 | 认证 | 探测到的部分模型 |
|---|---|---|---|---|
| Claude(实例 id claudeAgent) | 2.1.319 | ready | authenticated,类型 customEndpoint(Custom API endpoint) | claude-opus-5-5、claude-sonnet-5-5、claude-fable-5-2 等 |
| Codex(实例 id codex) | 0.167.0 | ready | unknown(API Key 方式不经过 ChatGPT 登录,这是正常的) | gpt-6.1-sol、gpt-6.1-terra、gpt-6-sol 等 |
也就是说,T3 Code 认出了 Claude Code 走的是自定义 API 端点,模型列表也来自你配置的服务。
除了全局配置,T3 Code 还支持「多实例」,适合一台机器同时用订阅和 API Key:
- 在 Settings → Providers 里新增一个 provider 实例。据官方文档,每个实例可以有自己的环境变量,例如 API Key 或自定义 base URL;密钥要标记为 sensitive,保存后不会再明文显示。
- Claude 还可以给每个实例指定不同的
CLAUDE_CONFIG_DIR,例如保留默认目录给订阅账号,另建~/.claude_api放 API Key 配置。不同配置目录的线程互相隔离。 - 找不到 CLI 时(常见于 nvm、mise 等版本管理器),在 provider 设置里填 Binary path。
第三步:开线程跑一个真实任务
网页端点 New thread、选 provider 和模型就能开始。服务器上没有浏览器时,可以用 t3 thread 命令行,这也是我们这次实测用的方式:
cd your-project
t3 project add .
t3 thread start . "calc.py 里的 add 函数有 bug,请修复它,并新增 test_calc.py 用 unittest 测试,最后运行测试并报告结果。" \
--provider claudeAgent --model claude-opus-5-5 --wait
--wait 会等 Agent 做完,再把它的回复打印出来。Codex 端把参数换成 --provider codex --model gpt-6.1-sol。测试项目只有一个文件,add 被故意写成了 return a-b。
| 端 | 墙钟耗时 | 结果 |
|---|---|---|
| T3 Code → Claude Code(claude-opus-5-5) | 约 30.4 秒 | 改成 return a+b,新增 6 个 unittest 用例,Ran 6 tests ... OK |
| T3 Code → Codex(gpt-6.1-sol) | 约 32.5 秒 | 改成 a + b,新增 5 个用例,「5 个测试全部通过(OK)」;我们退出后在同一目录再跑一次 python3 -m unittest test_calc,仍是 OK |
Claude Code 端在回复里提到,前两次写测试文件时丢了缩进,出现 IndentationError,第三次改用脚本生成文件后才通过。所以 Agent 的自述要看,但最终以你自己重跑测试为准。
默认权限是 Full access,先改
这是实测中最值得提醒的一点。据官方 Permission modes 文档,新线程的初始默认值是 Full access,命令和改文件都不再询问。我们在进程列表里看到,T3 Code 启动 Claude Code 时带的就是 --permission-mode=bypassPermissions。
建议在 Settings → Threads → New threads → Permissions 改默认值:
| 模式 | 行为 |
|---|---|
| Supervised | 执行命令、改文件前都要你批准 |
| Auto-accept edits | 改文件自动批准,其他操作仍可能要批准 |
| Auto | 用 provider 自带的自动审查放行常规操作,其余操作问你 |
| Full access | 不弹任何确认 |
在真实仓库里,建议至少用 Supervised 或 Auto。团队机器可以用 managed policy 限制最高可选的模式。
常见报错与解法
| 报错 / 现象 | 原因 | 解法 |
|---|---|---|
| No T3 Code project matches '.'. Pass a project id or a path inside a project. | 当前目录还没加成 T3 Code 项目(我们实测遇到) | 先 t3 project add .,或启动时加 --auto-bootstrap-project-from-cwd |
| Provider instance "claude" is disabled for project ... | 命令行里 --provider 填的不是实例 id。我们实测时填 claude 报这个错,改成 claudeAgent 后通过 | 用 Settings → Providers 里显示的实例 id;同时确认该 provider 已启用 |
| Provider 显示未安装 / 找不到 | CLI 不在服务进程的 PATH 上(常见于 nvm、mise) | 在 provider 设置里填 Binary path,或者把 CLI 装到全局 |
| 线程里报 401 / 认证失败 | Key 错误或过期,或配置没写对 | 先在终端单独跑 claude -p / codex exec,按《Codex 401 排查》逐条检查 Key、base_url 和登录状态;终端能通后再回 T3 Code |
| 429 Too Many Requests | 触发限流或使用窗口 | 先按服务端返回的提示等待或降并发,详见《Codex 429 怎么解决》 |
| t3 提示已有服务在运行 | 同一数据目录只能跑一个服务 | 直接连接正在运行的那个服务;要另起一个独立服务,就换一个 --base-dir |
| 手机或外网连不上 | 远程链路问题(据 @TheElricLi 的用户反馈,在外面手机和 iPad 都连不上) | 官方建议查看 T3 Connect 排障文档,或改用 Tailscale 自建链路 |
401 和 429 的完整排查步骤见《Codex 401 Unauthorized 怎么解决》和《Codex 429 Too Many Requests 怎么解决》。远程连接问题的用户反馈来自 @TheElricLi 的帖子。
FAQ
T3 Code 能用 Claude Code 订阅吗?
据官方 FAQ,可以。它调用你本机已登录的 Claude Code,订阅照常使用。官方 FAQ 还称 T3 Code 在 Claude Code、Codex、Google Antigravity 的服务条款范围内,这是 T3 Code 官方自己的说法。
用第三方 API Key 要在 T3 Code 里另外填吗?
不用。CLI 的全局配置写好就行,本文实测就是这么跑的。想让订阅和 API Key 并存,再用 provider 多实例或 CLAUDE_CONFIG_DIR 分开配置。
T3 Code 和 Codex 桌面版、Claude Desktop 有什么区别?
后两者各自只服务一家的 Agent。T3 Code 把多家 Agent 放进同一个界面,还加了远程访问和手机端,代价是多一层服务进程要维护。
服务器上没有图形界面能用吗?
能。用 t3 serve 启动,再用 t3 thread 命令行,或者从另一台设备通过 t3 up 或配对链接连进来。



