T3 Code 配置指南：接入 Claude Code、Codex 与 API 网关

如果你想在同一界面使用 Claude Code 和 Codex，减少手动交接任务的操作，可以选择 T3 Code。先安装一个提供方的 CLI，再完成认证，或配置独立的 API 实例。允许代理修改代码前，先验证它是否真正读取了仓库文件。

截至 2026-11-12，最新稳定版是 v0.1.9，发布于 11 月 11 日。Use T3 Code in another app (MCP) 功能在 11 月 9 日发布的 v0.1.8 中加入。建议从稳定版开始，不要选择面向维护者的预览版。

什么情况下值得使用 T3 Code？

如果你经常在代理之间交接任务、分别处理项目中的不同任务，或需要远程查看进度，可以选择 T3 Code。如果只在一个终端里使用一个代理，很少需要这些功能，保留现有 CLI 即可。

T3 Code 是代理的控制界面，不是新模型。底层代理运行框架（harness）负责提供并执行工具。T3 通过桌面、网页和移动端界面统一操作这些运行框架。

官方项目支持 Claude Code、Codex、Cursor、Grok Build、OpenCode、Antigravity、fx 等工具。软件免费，采用 MIT 许可证。底层提供方的费用仍由你支付。T3 不转售 token，也不会给订阅增加新的使用额度。

如果你已经在用 Claude Desktop 或 Codex 应用，先判断统一管理多个代理能否减少重复操作。如果只是想选一个合适的界面，可以参考 Codex CLI、桌面应用与 IDE 扩展对比。

先安装代理，再安装 T3 Code

在 T3 实际运行代理的机器上安装代理并完成认证。仅在笔记本上安装 CLI，不会自动配置另一台服务器。

后面的任务交接示例需要两个提供方都已就绪。只试用一个提供方时，用已安装的代理完成文件读取检查即可，暂时不做交接。

以下终端示例使用 Bash，适用于 Linux 或搭载 Apple Silicon 的 macOS 设备。先选一个包含 README.md、且没有敏感测试数据的仓库。

按照 Anthropic 的原生安装说明安装 Claude Code：

curl -fsSL https://claude.ai/install.sh | bash
claude --version

使用订阅的实例需要运行 claude auth login，并在浏览器中完成登录。如果只通过 API 访问，跳过订阅登录。开始对话前，先完成下文的独立网关配置。

Codex 的官方 CLI 指南提供了以下独立安装程序：

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex login

从 t3.codes 或该网站链接的 GitHub 仓库获取 T3。核对域名拼写：官方域名是 t3.codes，不是 t33.codes。

使用本地网页界面时，运行：

curl -fsSL https://t3.codes/install.sh | sh
t3

t3 命令会启动服务器并打开本地网页应用。如果安装程序提示将安装目录加入 PATH，请按提示操作。

如果已有 Node.js 和 npm，可以通过 npx t3@latest 临时试用。安装 macOS 桌面应用则在终端运行 brew install --cask t3-code。

Windows 用户先按照提供方的 Windows 安装说明准备代理，再在 PowerShell 中安装 T3：

irm https://t3.codes/install.ps1 | iex
t3

打开 Settings → Providers，选择仓库所在的环境，并在该环境中启用提供方。要复用已有的 Codex CLI 登录，添加一个 Codex 实例并选择 Configure manually。

如果找不到提供方，检查该环境所在机器上的安装和登录状态。如果 T3 无法通过 PATH 找到程序，在 Binary path 中指定可执行文件路径。安装指南说明了这些按环境分别配置的选项。

验证文件读取，再把对话交给 Codex

先用只读任务检查选中的提供方、仓库和工具执行情况，再尝试修改代码。

将仓库添加为项目，打开 New thread。在这个交接示例中选择 Claude，并在消息输入区明确将权限模式设为 Supervised。该模式会请求批准命令执行和文件修改；批准前先检查请求内容。

发送以下提示词。它要求读取 README.md，引用第一个标题并找出文档中的测试命令，同时禁止修改文件或运行测试。

Read README.md from this repository.
Quote its first heading and identify the documented test command.
If no test command is documented, say so.
Do not modify files or run tests.

检查工具调用记录，不要只看最终回答。确认代理读取了正确的文件，并返回文件中真实的标题。如果没有读取文件，只给出看似合理的描述，就不能算通过检查。

等这一轮回答结束，打开模型选择器，选择你的 Codex 实例和一个可用模型。快捷键在 macOS 上是 Cmd+Shift+M，在 Windows 和 Linux 上是 Ctrl+Shift+M。

然后发送以下提示词，让 Codex 根据仓库文件核对上一条回答，并检查测试命令是否需要额外准备：

Review the previous answer against the repository files.
Check whether the proposed test command needs extra setup.
Do not modify files or run tests.

预期结果是 Codex 在同一个 T3 对话中接着处理，并留下它自己检查文件的工具记录。这只是验证流程，不代表任一模型必然能发现缺陷。

T3 的交接文档区分了“转交对话上下文”和“迁移完整原生会话”。交接不会复制上一提供方的推理内容、工具调用状态或附件。重要约束需要重新说明，必需的材料也要重新附上。

需要在多次交接后继续生效的规则，应写入项目指令。编程代理记忆指南介绍了如何保存这类长期上下文。

通过独立的 Claude 实例接入 API 网关

接入兼容 Anthropic 的网关时，使用对应 Claude 实例的环境变量。不要把凭据填进 Launch arguments，也不要替换日常使用的订阅实例。

创建独立配置目录

保持 Claude 的默认配置不变。在 Bash 中为 OpenRouter 实例创建目录：

mkdir -p "$HOME/.claude_openrouter"

如果该目录已缓存 Anthropic 登录信息，用这个目录启动 Claude 会话：

CLAUDE_CONFIG_DIR="$HOME/.claude_openrouter" claude

在该会话中执行 /logout，退出后再添加网关 token。新目录没有缓存登录时，跳过这一步。T3 文档提醒，已保存的登录凭据可能与网关 token 冲突。

在 Settings → Providers 中添加一个名为 Claude OpenRouter 的 Claude 实例。将 Binary path 设为 claude，将 CLAUDE_CONFIG_DIR path 设为 ~/.claude_openrouter。

按照 T3 官方的 OpenRouter 配置说明，在该实例的 Environment variables 中填入：

变量	值
`ANTHROPIC_BASE_URL`	`https://openrouter.ai/api`
`ANTHROPIC_AUTH_TOKEN`	你自己的 OpenRouter API 密钥，标记为 Sensitive
`ANTHROPIC_API_KEY`	明确设为空值

保留 ANTHROPIC_API_KEY 这一项，将值留空。不要把引号填进值里。真实 token 只填入标记为敏感信息的凭据字段，不要写入聊天提示词或仓库文件。

为这个实例新建对话。已有的 Claude 对话只能在使用同一配置目录的 Claude 实例之间切换。

选择准确的模型 ID，并核对实际扣费请求

在 T3 中选择网关提供的完整模型 ID，不要假定 Claude 的别名会自动选中它。

截至 2026-11-12，OpenRouter 上可用的示例是 anthropic/claude-sonnet-5.5。如果列表中没有该模型，在 Claude 实例设置中通过 Add custom model 添加。然后在对话的模型选择器中选中它。

ANTHROPIC_DEFAULT_*_MODEL 变量用于映射 sonnet 等 Claude Code 别名，不能覆盖在 T3 中明确选中的模型。与内置模型相比，自定义模型可能提供更少的推理强度、思考模式或上下文设置。

使用网关实例开启新对话，重复 README.md 测试。在 OpenRouter 的活动面板中找到对应请求和模型，再核对用量与费用。即使回答正确，没有匹配的网关记录，也不能确认请求确实通过预期渠道计费。

OpenRouter 自己的 Claude Code 集成指南也说明了相同的端点和认证变量。这些请求消耗 OpenRouter 余额，不是 T3 额外提供的 token 额度。

截至 2026-11-12，OpenRouter 对 Claude Code 的兼容性保证仅适用于 Anthropic 自营提供方。本次试用应遵循该指南的建议，优先选择 Anthropic 1P。

BetterToken 的 Claude Code 文档指定 Anthropic 基础地址为 https://bettertoken.ai，不带 /v1。在标记为敏感信息的 ANTHROPIC_AUTH_TOKEN 字段中填入你自己的 BetterToken 密钥。将 ANTHROPIC_API_KEY 留空，并使用 ~/.claude_bettertoken 等独立目录。

截至 2026-11-12，其模型目录列有 claude-sonnet-5-5。选择这个准确的 ID，在执行较大任务前重复文件读取和扣费检查。这属于单独计费的 API 使用，请查看当前价格。

如果使用本地路由器，再创建一个独立的 Claude 实例，并确认运行 T3 的机器能访问路由器。Claude Code Router 配置指南介绍了这层额外的路由配置。这些 Anthropic 变量配置的是 Claude 提供方，不是 Codex 的配置方法。

通过 MCP 从其他助手访问 T3 Code

当外部助手需要访问 T3 的项目和对话时，再配置 MCP。在 T3 内正常切换 Claude 和 Codex，不需要这一步。先确保外部助手自身的模型认证已经正常工作。

外部代理指南说明了 T3 的 MCP 服务器支持哪些操作：读取项目、列出可用提供方、创建对话，以及向对话发送消息。

按 Cmd/Ctrl+K 打开命令面板，选择 Use T3 Code in another app (MCP)。Settings → Sharing & access 中也有同一入口。选择客户端，再按界面中的说明操作。

在 Settings → Environments 中打开已保存环境的菜单，选择 Copy MCP URL。保持 T3 服务器运行。在 Bash 中执行以下代码；当 read 等待输入时，粘贴复制的地址并按 Enter：

read -r T3_MCP_URL
claude mcp add --transport http t3 "$T3_MCP_URL"
claude mcp login t3

如果使用 Codex 客户端，改用以下代码：

read -r T3_MCP_URL
codex mcp add t3 --url "$T3_MCP_URL"
codex mcp login t3

首次连接时，在设置或登录授权过程中选择 Read only。该模式允许查看可用资源，但不能修改。

让外部助手列出 T3 的项目和可用提供方，并与 T3 界面中的内容核对。这样验证的是一次实际工具操作，而不仅是保存了连接地址。

如果登录失败，先确认客户端能够访问复制的环境地址，不要急着更换模型 API 凭据。

只有确实准备让外部助手启动或操控任务时，才授予执行权限。批准前检查授权范围。模型 API token 和 MCP 登录使用不同的凭据；修改其中一项，不能修复另一项的连接问题。

分别检查额度、隐私和故障环节

排查问题时，分清订阅额度、API 费用和客户端配置，不要把它们当作同一件事。

截至 2026-11-12，T3 FAQ仍报告：通过 Anthropic Agent SDK 使用 Claude 时，五小时额度比直接使用 Claude Code 消耗得更快。维护者将其归因于 Anthropic 一侧的缺陷。他们表示，这种加速消耗不影响每周额度，但不代表每周额度限制被取消。

如果账户有五小时额度，先用一个小型、具有代表性的任务对比消耗，再决定是否把整天的工作都搬到 T3。如果这个时间窗口是主要瓶颈，保留直接使用 Claude Code 的方式。

FAQ 还说明，T3 不支持本地模型。本地运行的路由器即使能把请求转发给托管模型，也不等于在本地执行模型推理。

对于模型推理请求，FAQ 表示代码和提示词从你的机器发往提供方，而不是 T3 的服务器。如果接入 API 网关，网关也会成为这条请求路径的一部分。这不等于没有遥测：T3 会发送提供方、模型和 token 总量等使用元数据。

遥测文档说明，产品使用事件不包含提示词或文件内容。在处理敏感仓库前，还要阅读单独的诊断信息章节。

找不到提供方时，检查所选机器上的安装、登录或 Binary path。网关认证失败时，检查敏感凭据字段中的 token、空值的 ANTHROPIC_API_KEY，以及是否缓存了登录信息。模型不可用时，核对网关的准确模型 ID 和对话中选中的实例。

每次修改配置后，都新建一个测试对话，重复文件读取检查。只有工具调用记录与预期提供方的使用记录相符，才保留这次修改。