T3 Code：9K Stars的极简AI编程GUI——支持Codex和Claude的Web界面
posts posts 2026-04-18T15:40:00+08:00T3 Code是pingdotgg出品的极简AI编程Web GUI，让用户通过图形界面使用Codex和Claude进行编程。支持npx直接运行和桌面安装，提供可视化编码体验。技术笔记AI编程, Codex, Claude, GUI, Web界面, 编程工具T3 Code：9K Stars 的极简 AI 编程 GUI——支持 Codex 和 Claude 的 Web 界面
§2 背景：CLI 编程助手的 GUI 需求
AI 编程助手（Claude Code、Codex）以 CLI 形式提供，对非技术用户有门槛——需要记命令、输出纯文本、文件管理靠额外命令、代码变更无法直观看到。专业用户用 CLI 没问题，但 GUI 能覆盖更广的用户群。
T3 Code 由 pingdotgg 团队打造，定位是零配置的 AI 编程 Web GUI：
npx t3 # 一行命令，启动AI编程GUI设计上三点：极简（无复杂配置，开箱即用）、Web 优先（浏览器访问，无需桌面应用）、Provider-agnostic（支持多种 AI 提供商，自由切换）。
2.3 与其他方案的对比
| 方案 | 类型 | 复杂度 | 适合用户 |
|---|---|---|---|
| Claude Code CLI | 终端 CLI | 高 | 专业开发者 |
| Cursor | VS Code 插件 | 中 | 日常 IDE 用户 |
| Copilot | IDE 插件 | 低 | 追求无缝体验 |
| T3 Code | Web GUI | 低 | 喜欢 Web 界面者 |
§3 功能概览
3.1 支持的 AI 提供商
| 提供商 | 安装要求 | 认证方式 | 特点 |
|---|---|---|---|
| Codex | Codex CLI | codex login | OpenAI 出品，支持多语言 |
| Claude | Claude Code | claude auth login | Anthropic 出品，强推理 |
3.2 安装方式
方式一：npx 直接运行（推荐）
npx t3这种方式无需安装，直接使用最新版本。适合快速试用和临时使用场景。
方式二：桌面应用
| 操作系统 | 安装命令 | 包管理器 |
|---|---|---|
| Windows | winget install T3Tools.T3Code | winget |
| macOS | brew install --cask t3-code | Homebrew |
| Arch Linux | yay -S t3code-bin | AUR |
| Linux (通用) | 从 GitHub Releases 下载 | - |
从源码构建（如需自定义）：
git clone https://github.com/pingdotgg/t3code.git
cd t3code
bun install
bun run electron:start # 开发模式3.3 可观测性支持
T3 Code 提供详细的观测能力，帮助用户理解 AI 的工作过程：
- 对话历史：完整保留每次交互记录
- Token 消耗：可视化显示 API 使用量
- 响应时间：显示每次响应的延迟
- 错误日志：详细记录异常信息
参考文档：docs/observability.md
§4 使用指南
4.1 首次配置
步骤 1：安装 AI 提供商 CLI
以 Claude 为例（参考官方文档安装）：
# Claude Code CLI安装方式请参考
# https://docs.anthropic.com/claude-code
claude auth login步骤 2：启动 T3 Code
npx t3步骤 3：在浏览器中打开
T3 Code 会在默认浏览器中打开，通常访问：
http://localhost:30004.2 基本操作
创建新对话：
- 点击左侧边栏的"+"
- 选择 AI 提供商
- 开始输入问题或任务
代码审查：
- 粘贴代码到对话框
- 描述你想要的操作（如"解释这段代码"）
- AI 会分析并给出建议
文件操作：
- 直接在 GUI 中查看项目结构
- 点击文件即可让 AI 分析或修改
- 支持多文件同时操作
4.3 常用场景
场景 1：代码解释
输入：解释这个函数的逻辑
AI → 分析代码 → 输出详细解释场景 2：Bug 修复
输入：这个函数报错了，帮我看看
AI → 分析错误 → 定位问题 → 给出修复方案场景 3：代码生成
输入：帮我写一个快速排序函数
AI → 生成代码 → 可直接复制使用§5 开发与贡献
5.1 本地开发环境
前置准备：
# 使用mise管理开发工具（可选）
mise install
# 安装依赖
bun install .启动开发服务器：
bun run electron:start这会启动 Electron 应用，支持热重载开发。
5.2 项目结构
t3code/
├── src/ # 源代码目录
├── docs/ # 文档目录
├── electron/ # Electron相关
├── web/ # Web前端
└── package.json注：具体项目结构请参考 GitHub 仓库的实际目录。
5.3 项目状态
[!WARNING] T3 Code 项目处于非常早期阶段，预期会有 bug。API 和功能可能会有较大变化。
目前不接受外部贡献，但可以：
- 关注 GitHub Releases 获取稳定版本
- 提交 Bug report（但不保证修复速度）
- 参与 Discord 社区讨论
§6 故障排除
6.1 常见问题
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 启动后浏览器空白 | 端口被占用 | 使用npx t3 --port 3001指定其他端口 |
| 认证失败 | Provider 未登录 | 先运行claude auth login |
| npx 超时 | 网络问题 | 使用代理或设置 npm 镜像 |
| 桌面版闪退 | 缺少依赖 | 重新安装或从源码构建 |
6.2 网络问题解决
公司网络下 npm 安装失败：
# 设置npm代理
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
# 或使用国内镜像
npm config set registry https://registry.npmmirror.com离线使用：
# 下载T3到本地
npm pack t3
# 手动安装
npm install ./t3-*.tgz6.3 调试技巧
# 查看详细日志
DEBUG=* npx t3
# 检查版本
npx t3 --version
# 查看帮助
npx t3 --help§7 常见问题
Q1: T3 Code 免费吗？
T3 Code 开源免费。AI 提供商（Codex/Claude）的使用费用需自行承担。
Q2: 支持 Windows 吗？
支持。通过winget或直接从 GitHub Releases 下载.exe安装包。
Q3: 与 Cursor/Copilot 有何不同？
| 特性 | T3 Code | Cursor | Copilot |
|---|---|---|---|
| 界面 | 独立 Web GUI | VS Code 插件 | IDE 插件 |
| 独立性 | 独立应用 | 依赖 VS Code | 依赖 IDE |
| 多文件操作 | 支持 | 支持 | 有限 |
| 上下文窗口 | 中等 | 大 | 中等 |
| 订阅费用 | 仅 API 费 | 付费版 | 部分免费 |
T3 Code 的差异：
- 不依赖特定 IDE，可用任何编辑器
- 界面简洁，适合轻量使用
- 多提供商切换方便
Q4: 数据隐私如何？
T3 Code 通过本地 CLI 直接与 AI 提供商通信，数据不经过第三方服务器。具体隐私政策请参考各 AI 提供商的条款。
Q5: 如何反馈问题或建议？
- GitHub Issues：https://github.com/pingdotgg/t3code/issues
- Discord 社区：https://discord.gg/jn4EGJjrvv
§8 相关资源
🦞 撰写于 2026 年 4 月 18 日