T3 Code是一款免费开源的AI编程Agent管理平台,支持Codex、Claude Code、OpenCode等多种Coding Agent。本文详细介绍T3 Code 的安装部署、WebUI访问及服务器配置方法,帮助你搭建自己的AI编程开发环境。
T3 Code不是Coding Agent Harness,它的核心职责是统一控制和编排Coding Agent,并支持跨平台使用,目标是打造一款高性能、支持远程办公且真正开源的产品。
本文将T3 Code部署在Debian 13服务器上,通过Web UI访问,接入Codex。
创建一个普通用户,后续使用该用户运行t3code,已有普通用户的可跳过该步骤:
sudo adduser imlala
sudo usermod -aG sudo imlala
重新使用新的用户登录ssh,安装mise:
sudo apt install -y extrepo
sudo extrepo enable mise
sudo apt update
sudo apt install -y mise
激活mise:
echo 'eval "$(mise activate bash)"' >> ~/.bashrc
source ~/.bashrc
使用mise安装Node.js:
mise use -g --pin node@24
安装Codex CLI:
npm install -g @openai/codex
1.如果已经安装了Codex CLI可以跳过。
2.如果不打算使用Codex CLI可以跳过。
3.不手动安装,稍后也可以让T3 Code去帮你安装Codex CLI。
4.我建议在这里手动安装,不要将Codex CLI这个Coding Agent和T3 Code深度绑定。
如果是首次安装Codex CLI,需要先登录你的ChatGPT账号,以便后续使用你账号内的订阅:
codex login --device-auth
查看登录状态,确保输出是:Logged in using ChatGPT
codex login status
安装T3 Code:
npm install -g t3@latest
配置后台常驻运行,创建systemd用户服务需要用到的目录:
mkdir -p ~/.config/systemd/user
执行下面的命令T3 Code将自动安装并配置systemd用户服务:
t3 service install
查看状态,确保正常:
t3 service status
systemd用户服务在你退出登录后(SSH终端、桌面等)会自动停止,执行下面的命令启用用户服务在退出登录后继续运行的能力,将用户名改为你自己的:
sudo loginctl enable-linger imlala
接下来配置反向代理,安装NGINX、Certbot:
sudo apt install -y nginx python3-certbot-nginx
新建NGINX站点配置文件:
sudo nano /etc/nginx/sites-available/t3code
写入如下内容:
map $http_upgrade $t3_connection_upgrade {
default upgrade;
'' close;
}
server {
listen 80;
listen [::]:80;
server_name t3code.example.com;
client_max_body_size 0;
location / {
proxy_pass http://127.0.0.1:3773;
proxy_http_version 1.1;
proxy_set_header Host $http_host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# WebSocket
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $t3_connection_upgrade;
# 实时消息与长连接
proxy_buffering off;
proxy_cache off;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
}
}
启用站点:
sudo ln -s /etc/nginx/sites-available/t3code /etc/nginx/sites-enabled/t3code
检查配置、签发证书:
sudo nginx -t
sudo certbot --nginx
获取T3 Code登录令牌,令牌默认有效期5分钟,5分钟没使用则需要重新生成:
t3 pair
在Web UI使用刚才的令牌登录,登录有效期默认30天,如果你清理浏览器的Cookie缓存则立即失效:
T3 Code令牌和登录会话管理:
# 查看活动登录会话
t3 auth session list
# 撤销指定会话,将ID替换为上面列出的sessionId
t3 auth session revoke id
# 查看仍有效的登录令牌
t3 auth pairing list
# 撤销指定登录令牌
t3 auth pairing revoke id
登录进去后,在向导这里需要注意:
如果之前已经安装并登录了Codex CLI,这里直接点Continue,不需要点击Use existing CLI进行配置,正常情况下T3 Code会自动识别Codex CLI环境。如果没有手动安装Codex CLI,则这里的Continue with ChatGPT不仅仅指登录你的ChatGPT账号使用账号内的订阅,而是由T3 Code帮你安装并管理一个Codex CLI环境。
向导完成后,只需要确保这里识别到Codex CLI就行了:
现在就可以使用了:
我用了一段时间,咱不吹不黑,反正我个人觉得T3 Code是挺好用的。而且这里只介绍了最基本的能力,实际上T3 Code还可以管理多台机器上的Coding Agent,就小鸡挂探针这个架构你懂吧,一台机器装T3 Code,其它的机器装各种各样的Coding Agent,然后统一使用T3 Code去管理。目前类似T3 Code这样的开源项目还有几个也做的还可以,但是我还没实际体验过,所以就不怎么好评价了,有机会我会部署一下然后进行对比。
荒岛















