T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是 pingdotgg 开源的编码 Agent 控制台,本身不带模型,调用你机器上已装好的 Claude Code、Codex、Cursor 等 CLI。本文在 Linux 上实测 T3 Code 0.1.9:讲清安装命令,Claude Code 和 Codex 先各自接上 AICodeWith API Key、再由 T3 Code 调用的配置方法,用 t3 thread 命令行跑通两端的过程,以及我们实际遇到的报错和解法。

5 分钟阅读
T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

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。本文写的都是这次实际跑到的步骤、输出和报错。

创建 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):

bash
# macOS / Linux:安装 t3 命令到 ~/.local/bin
curl -fsSL https://t3.codes/install.sh | sh

# 不安装,直接试一次(需要 Node.js)
npx t3@latest
powershell
# 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 配置》):

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "你的 AICodeWith API Key"
  }
}

Codex:写全局 ~/.codex/config.toml(安装见《Codex 安装教程》,字段含义见《Codex config.toml 配置指南》):

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"

写完先在终端单独验证一次,两端都应该回一句话:

bash
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 里也不会通,所以排错先从这里开始。

创建 API Key →

第二步:在 T3 Code 里确认 provider 状态

启动 t3 或 t3 serve 后,T3 Code 会自动探测 PATH 上的 CLI。打开网页端的 Settings → Providers 能看到每个 provider 的状态。我们这次读到的探测结果:

Provider版本状态认证探测到的部分模型
Claude(实例 id claudeAgent)2.1.319readyauthenticated,类型 customEndpoint(Custom API endpoint)claude-opus-5-5、claude-sonnet-5-5、claude-fable-5-2 等
Codex(实例 id codex)0.167.0readyunknown(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 命令行,这也是我们这次实测用的方式:

bash
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 或配对链接连进来。

创建 API Key →

资料

相关文章

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是 Vercel 在 2026 年 11 月 12 日发布的、给 Agent 用的行为(behaviors)库,版本 0.1.0-beta.1。行为写在与框架无关的 @ui-sdk/core 里,再由 React、Vue、Svelte、Solid 和 Web Components 适配器渲染。本文按官方文档整理它是什么、怎么安装、怎么给 Claude Code / Codex / Cursor 装 skill,并记录我们在测试机上的真实命令、耗时和输出。

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是 AWS 官方 2026 年 11 月 12 日(北京时间)正式发布的本地 AWS 模拟器,没有额外服务费、源码开放,不需要 AWS 账号,覆盖 200 多个服务。本文在 Debian 13 上实测 1.0.322:安装命令、AWS CLI 指向本地 endpoint 建 S3 桶和 DynamoDB 表、常见报错,以及让 Claude Code、Codex、Cursor 对着模拟器写代码跑测试的接法。