官方原文 · 截至 2026-11-09

T3 Code 是什么?用自己的 API Key 怎么接(2026 年 11 月)

截至 2026-11-09,T3 Code 按它自己 README 的说法是一个“agent harness control surface”:用桌面、网页和手机 App 去控制你电脑上已装好的 Claude Code、Codex 等编码 agent。它是 MIT 协议的开源项目,GitHub 上最新版本是 v0.1.7(2026-11-04)。想用自己的 API Key 跑:在 Settings > Providers 里另加一个 Claude 实例,在它的 Environment variables 里设 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN;接 QCode 就是 https://api.qcode.cc/api 加你的 cr_ 开头的 Key。

更新于 2026-11-10

把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。

#T3 Code 是什么#用自己的 API Key#ANTHROPIC_BASE_URL#开源(MIT)

官方来源里的四条事实

MIT

MIT 协议开源

pingdotgg/t3code 仓库采用 MIT License(Copyright (c) 2026 T3 Tools Inc.)。README 还提醒:项目还处在很早期,可能有 bug。

v0.1.7

最新版本:2026-11-04

GitHub 把 v0.1.7(2026-11-04 发布)标为最新版本。nightly 构建以预发布形式发布,例如 2026-11-09 的 v0.1.8-nightly.20261109.4399。

Claude Code · Codex

自带你装好的 agent

安装指南的 provider 表列出 Codex、Claude、Cursor、Grok Build、Kiro、OpenCode、Antigravity、Pi、Muse Code 和 fx。T3 Code 是操作界面,干活的是你装的 agent。

Environment variables

自己的端点配在 Claude 实例里

在 Claude 实例的 Environment variables 里设 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN(标为 Sensitive)和显式留空的 ANTHROPIC_API_KEY。官方示例用的是 OpenRouter;下面的步骤用同样三个变量接 QCode。

T3 Code 是什么?

截至 2026-11-09,T3 Code 的 README 把它描述为“agent harness control surface”:用手机 App(iOS 和 Android)、网页 App 和基于 Electron 的桌面 App 去控制你电脑上的 agent。官网的定位是面向编码 agent 的开源控制平面。FAQ 解释了分工:T3 Code 使用这些 harness,自己不是 harness,没有 harness 就不能工作。也就是说,调模型、跑工具的是 Claude Code、Codex 等 agent,T3 Code 是你开 thread、选 agent、从别的设备连回你那台机器的地方。开 thread 之前,先装好并登录至少一个 agent。FAQ 对 T3 Code 本身的费用答的是“Nothing”:订阅或 Key 自带,照旧付给你的 provider。

2026-11-04:v0.1.7 是最新版本

GitHub 把 2026-11-04 发布的 v0.1.7 列为 T3 Code 的最新版本。nightly 预发布单独发布,2026-11-09 发布了 v0.1.8-nightly.20261109.4399。安装指南写明:设置 T3CODE_CHANNEL=nightly 安装 nightly 通道,设置 T3CODE_VERSION 钉住某个确切版本。

时间线

2026-02-08

pingdotgg/t3code 仓库在 GitHub 创建。

2026-11-04

v0.1.7 作为最新版本发布。

2026-11-09

核对 main 分支上的 README、安装指南、FAQ 以及 Claude 与 Codex 指南;nightly v0.1.8-nightly.20261109.4399 发布。

T3 Code 写明了什么,还有什么没说清

T3 Code 文档写明的

① 开 thread 之前要有已安装并已登录的 provider;可以先启动 T3 Code,之后再配置 provider。② 实例环境变量里的密钥值可以标为 sensitive,保存后 T3 Code 不再显示原值。③ 对 OpenRouter 和其他 router,Claude 指南的做法都是另建一个有独立配置目录的 Claude 实例,把端点和凭据变量放进该实例的 Environment variables。④ 变量赋值不要放进 Launch arguments。⑤ ANTHROPIC_DEFAULT_*_MODEL 变量映射的是 sonnet 这类 Claude Code 别名,不会替代在 T3 Code 里明确选定的模型 ID。⑥ 自定义模型的 effort、thinking、context 控件可能比内置模型少。⑦ 远程连接时,T3 Code 用的是被连接服务器上的 Claude 配置。⑧ 代码和提示词从你的机器发往你的 provider,不发到 T3 的服务器;基础的产品使用事件可以用 T3CODE_TELEMETRY_ENABLED=false 关闭。

官方来源还没说清的

截至 2026-11-09:① 各页列出的 agent 不一致:README 写的是 Claude Code、Codex、Cursor、Grok Build、OpenCode、Google Antigravity 和 fx;FAQ 写了 Pi 和 Muse Code,没写 fx;安装指南的 provider 表最全,还多列了 Kiro。② T3 Code 的 FAQ 说,T3 Code 通过 Anthropic 的 Agent SDK 驱动 Claude,这样会比直接用 Claude Code 更快耗掉 Claude 的 5 小时限额,不影响每周限额;FAQ 说已报告给 Anthropic,没有给出修复日期。③ GitHub 上最新的几个发布都是 v0.1.8 的 nightly 预发布,最新稳定版仍是 v0.1.7,文档没有给出下一个稳定版的日期。

两种登录方式

沿用你的 Claude Code 登录

官方 FAQ 问“能否用 Claude Code 订阅来使用 T3 Code”,答案是可以。装好 Claude Code,运行 claude auth login,再到 Settings > Providers 启用该 provider。

用自己的 API Key

在 Settings 里再加一个 provider 实例,给它自己的 Key 和端点。每个实例都可以有自己的环境变量,例如 API Key 或自定义 base URL,原来的登录不受影响。Claude 的具体步骤见下一节。

怎么用自己的 API Key 跑 T3 Code

① 先装 Claude Code,再装 T3 Code:桌面端(Windows 用 winget install T3Tools.T3Code,macOS 用 brew install --cask t3-code),或命令行 curl -fsSL https://t3.codes/install.sh | sh(Windows PowerShell:irm https://t3.codes/install.ps1 | iex),装完运行 t3。Intel Mac 没有 t3 可执行文件,请用桌面端。② 在 Settings > Providers 添加一个 Claude 实例,Binary path 保持 claude,并给它一个独立的 CLAUDE_CONFIG_DIR path;官方示例是 ~/.claude_openrouter,用 ~/.claude_qcode 就是同样的思路。③ 在该实例的 Environment variables 里把 ANTHROPIC_BASE_URL 设为 https://api.qcode.cc/api,ANTHROPIC_AUTH_TOKEN 设为你的 QCode Key(标为 Sensitive),ANTHROPIC_API_KEY 设为显式留空。④ 如果这个配置目录里有缓存的登录,先在使用它的 Claude Code 会话里运行 /logout。⑤ 内置列表之外的模型,用 Add custom model 添加完整 ID,例如 claude-sonnet-5,再在聊天的模型选择器里选中。

用 QCode 的 API Key 跑 T3 Code

截至 2026-11-09,QCode 以 Anthropic 协议提供 Claude 型号,按 token 计费,各模型单价见 /models,其中列有 claude-sonnet-5 和 claude-opus-5;QCode 文档写明 GLM、Kimi、DeepSeek、Qwen 四个家族也能走同一个 Anthropic 端点,型号 ID 同样见 /models。三步开始:① 注册并充值(支付宝、微信支付、银行卡、加密货币等);② 购买个人套餐或按量包,复制以 cr_ 开头的 API Key;③ 按上文把 Key 和 Base URL 填进 T3 Code 里的 Claude 实例,QCode 文档 https://docs.qcode.cc/docs/ide/t3code 有同样的分步说明。不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止;已有个人套餐的用户额度不够时买加油包。

常见问题

T3 Code 要花多少钱?

官方 FAQ 的回答是“Nothing.”。T3 Code 开源(MIT),订阅或 Key 自带,照旧付给你的 provider。用 QCode 的 Key 时按 token 计费,各模型单价见 /models。

不订阅 Claude 能用 T3 Code 吗?

能。官方 FAQ 的做法是在 Settings 里再加一个 provider 实例,给它自己的 Key 和端点。接 QCode 就是新建一个 Claude 实例:ANTHROPIC_BASE_URL 填 QCode 的 Base URL,ANTHROPIC_AUTH_TOKEN 填你的 cr_ 开头的 Key,ANTHROPIC_API_KEY 显式留空,步骤见上文。原来的登录不受影响。

T3 Code 会取代 Claude Code 或 Codex 吗?

不会。官方 FAQ 的说法是:T3 Code 使用这些 harness,自己不是 harness,没有 harness 就不能工作。先装好并登录至少一个 agent,比如 Claude Code,再用 T3 Code 来运行和控制它。

T3 Code 里 ANTHROPIC_BASE_URL 在哪里设置?

打开 Settings > Providers,选中那个 Claude 实例,在 Environment variables 下添加变量;变量赋值不要放进 Launch arguments。接 QCode 时值是 https://api.qcode.cc/api,末尾不带斜杠。同一个 Key 在 us.qcode.cc 和 asia.qcode.cc 上也能用,例如 https://asia.qcode.cc/api。

T3 Code 里看不到我的 provider 或自定义模型怎么办?

官方 FAQ 说,几乎总是因为 CLI 没装,或不在运行服务器那台机器的 PATH 里;先在那台机器上登录,或在 provider 设置里把 Binary path 指向它。自定义模型用 Add custom model 添加完整 ID。如果 Key 没错却仍然认证失败,先在使用该配置目录的 Claude Code 会话里运行 /logout,因为缓存的登录凭据可能与 token 冲突。

T3 Code 里能用自己的 API Key 跑 GPT 或 Codex 吗?

能,走 Codex 实例:添加一个运行你本机 Codex、且 Codex 已按 QCode 配好的实例;GPT 型号不走 Claude 实例,因为 QCode 在 OpenAI 端点上提供 GPT。T3 Code 的 Codex 指南讲的是 ChatGPT 登录和沿用已有的 Codex 登录。在 T3 Code 源码里(main 分支,2026-11-09 读取),这类实例会把它的 CODEX_HOME path 传给 Codex,随源码的 Codex app-server schema 把用户配置层描述为 $CODEX_HOME/config.toml。所以先按 QCode 的 Codex 页配好 ~/.codex/config.toml 和 auth.json(base_url = "https://api.qcode.cc/openai"、wire_api = "responses"),再在 T3 Code 里用 Configure manually 添加 Codex 实例。T3 Code 里用 ChatGPT 建立的连接是另一条路:它自设 model_provider,并移除 OPENAI_BASE_URL。以 T3 Code 当前版本为准。

资料来源

GitHub 上 pingdotgg/t3code 仓库(main 分支)的 T3 Code README、安装指南、FAQ、Claude 与 Codex 指南、LICENSE 和源码文件,GitHub Releases API 以及官网 t3.codes,均于 2026-11-09 读取。QCode:qcode.cc/models、qcode.cc/pricing,以及 docs.qcode.cc 的接入端点、安装和 Codex 页面,2026-11-09 抓取。

用自己的 Key 跑 T3 Code

一把 QCode API Key 同时用于 Claude Code、Codex 等工具,按 token 计费,各模型单价见 /models。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,每天 $5 额度;每 $1 额度只要 ¥0.42,中包约 ¥0.79