TronCode › Tron CLI 文档 › 介绍

介绍

开始使用 Tron — 开源 AI 编程代理

Tron 是一个开源的 AI 编程代理。它提供基于终端的交互界面，让你可以直接在终端中与 AI 协作完成编程任务，无需切换编辑器。

Tron
你好！我已分析了你的项目结构。当前是一个 TypeScript + React 项目，检测到 src/api/auth.ts 等 42 个源文件。有什么需要帮助的吗？
你
帮我重构 @src/api/auth.ts，添加 JWT 令牌刷新逻辑
◎ 正在读取 src/api/auth.ts...
✓ 已读取文件 (128 行)
my-app
Context
12,483 tokens
8% used
$0.02 spent
LSP
TypeScript ●
≡ Build · claude-opus-4-6 · streaming...
Build claude-opus-4-6 my-app
tab agents  ctrl+p commands ~/project/my-app Tron 0.2.1

前置条件

要在终端中使用 Tron，你需要准备以下内容：

1. 一个现代终端模拟器（以下任选其一）：

终端 平台 推荐理由
WezTerm 跨平台 GPU 加速，配置灵活
Alacritty 跨平台 轻量快速
Ghostty Linux / macOS 现代感强，原生渲染
Kitty Linux / macOS 功能丰富，支持图片

2. LLM 供应商 API 密钥。Tron 支持多种供应商，包括 Anthropic Claude、OpenAI、以及 TronCode 托管服务。

安装

Linux / macOS

使用一键安装脚本：

终端
curl -fsSL https://upgrade.lianwo123.com/troncode/cli/install | bash

Windows

使用 PowerShell 执行以下命令：

PowerShell
irm https://upgrade.lianwo123.com/troncode/cli/install.ps1 | iex

配置

Tron 支持通过配置 API 密钥来使用任意 LLM 供应商。

💡
推荐新手使用 TronCode
TronCode 是由 Tron 团队测试验证的精选模型服务，配置最简单，开箱即用。
1
在 TUI 中运行 /connect 命令

选择 TronCode，然后前往 troncode.cn。

你
/connect
选择供应商
anthropic
openai
▶ TronCode
google
my-app
Build claude-opus-4-6
Tron 0.2.1
2
获取 API 密钥

登录账号，添加计费信息，然后复制你的 API 密钥。

3
粘贴 API 密钥
┌ API key
│ sk-yan-xxxxxxxxxxxxxxxxxxxx
└ 按 Enter 确认
my-app
Build claude-opus-4-6
Tron 0.2.1

你也可以选择其他供应商，了解更多供应商配置。

初始化

配置好供应商后，进入你的项目目录并启动 Tron。

终端
cd /path/to/project
tron

进入 TUI 后，运行 /init 命令初始化项目：

你
/init
✓ 正在分析项目结构...
✓ 检测到 TypeScript / React 项目
✓ 已写入 AGENTS.md
my-app
Context
4,201 tokens
3% used
Build claude-opus-4-6 my-app
~/project/my-app Tron 0.2.1

/init 会让 Tron 分析你的项目，并在根目录生成 AGENTS.md 文件，帮助 Tron 理解项目结构和编码规范。

💡
提示
建议将 AGENTS.md 提交到 Git，让团队成员共享项目上下文。

使用

现在你可以开始使用 Tron 处理项目了。以下是一些常见场景示例。

提问代码库

你可以让 Tron 解释项目中的任意代码。

你
@packages/functions/src/api/index.ts 中的认证是如何处理的？
✓ 已读取 packages/functions/src/api/index.ts
Tron
该文件使用 JWT Bearer 令牌认证。在第 42 行的 authMiddleware 函数中验证令牌有效性...
my-app
Context
8,903 tokens
6% used
$0.01 spent
≡ Build · claude-opus-4-6
Build claude-opus-4-6 my-app
tab agents  ctrl+p commands Tron 0.2.1
💡
快捷键提示
在提示框中按 @ 键可以模糊搜索项目文件，快速引用上下文。

添加功能（Plan → Build 工作流）

对于复杂功能，建议先让 Tron 制定计划，确认后再执行。

1
切换到 Plan 模式

按 Tab 键切换到 Plan 模式（右下角会显示模式指示器）。

描述你想要实现的功能...
my-app
Plan claude-opus-4-6 my-app
tab agents Tron 0.2.1
2
描述需求
你
当用户删除笔记时，在数据库中标记为已删除。
然后创建一个页面展示最近删除的笔记，
支持恢复或永久删除。
my-app
Plan claude-opus-4-6
Tron 0.2.1
💡
可以将图片拖放到终端中添加为视觉参考，Tron 支持读取图片内容。
3
切换回 Build 模式执行

对计划满意后，再次按 Tab 切换回 Build 模式，让 Tron 执行更改。

直接进行更改

对于更直接的任务，可以在 Build 模式下直接描述目标：

你
为 /settings 路由添加认证。
参考 @packages/functions/src/notes.ts 中 /notes 路由的实现，
在 @packages/functions/src/settings.ts 中实现相同逻辑。
◎ 正在读取文件...
my-app
Context
6,102 tokens
4% used
≡ Build · claude-opus-4-6 · streaming...
Build claude-opus-4-6 my-app
Tron 0.2.1

撤销与重做

如果对 Tron 的更改不满意，可以随时撤销：

你
/undo
✓ 已撤销最近的更改，文件已还原
你
/redo
✓ 已重做更改
my-app
Build claude-opus-4-6 my-app
Tron 0.2.1
💡
提示
可以多次执行 /undo 来逐步撤销多个历史更改。

进一步定制

恭喜！你已掌握 Tron 的核心用法。接下来可以探索更多定制选项，让 Tron 成为真正属于你的工具：