今天苏米就手把手教大家如何使用字节跳动刚刚开源的Trae CLI,这个被称为Claude Code和Gemini CLI国产平替的命令行AI编程工具,里面也有涉及到复杂的环境配置和工作流创建,可以带大家快速的了解和认识这个新兴平台的实际应用能力。
什么是Trae CLI?
在AI编程助手市场激烈竞争的当下,字节跳动显然不想错过这个风口。继推出Trae IDE(对标Cursor的AI原生集成开发环境)之后,字节又开源了Trae Agent——一个基于大语言模型的命令行AI编程工具。
Trae Agent是一个基于LLM通用软件工程任务的智能体,它提供了一个CLI界面,可以理解自然语言指令,并使用各种工具和LLM提供商执行复杂的软件工程工作流。简单来说,这就是字节版的Claude Code。
核心功能包括:
-
支持OpenAI和Anthropic API的多模型调用
-
文件编辑和代码生成
-
Bash命令执行
-
交互式开发环境
-
工作流自动化
Claude Code vs Trae CLI
目前Claude Code作为Anthropic推出的代理编程工具,能够让开发者直接从终端委托大量工程任务给Claude,毕竟是自家的模型,理解整个代码库并通过自然语言命令加速编程,与目前非常主流的IDE Cursor都略胜几分。

而Trae CLI目前还处于alpha阶段,从安装体验来看,确实无法与Claude Code的流畅度相提并论。Claude Code安装只需要一行命令:npm install -g @anthropic-ai/claude-code
而Trae CLI的安装过程则要复杂得多,需要多个步骤和依赖管理。
手把手安装Trae CLI
系统要求
-
Windows 10/11 + PowerShell
-
Python 3.12+
-
Git
-
VS Code或其他终端
第一步:克隆仓库
git clone https://github.com/bytedance/trae-agent
cd trae-agent

第二步:安装UV包管理器
Trae CLI使用UV进行快速依赖管理,在PowerShell中执行:
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

第三步:配置环境变量
将UV添加到当前PowerShell会话:
$env:Path = "C:\Users\XMSUMI\.local\bin;$env:Path"
验证安装:
uv --version
第四步:安装项目依赖
uv sync
这个过程会:
-
创建.venv虚拟环境
-
安装anthropic、openai、click、rich等依赖
-
安装trae-agent包本身
第五步:配置API密钥
编辑配置文件:
notepad trae_config.json
配置示例:
{
"default_provider": "anthropic",
"max_steps": 20,
"enable_lakeview": true,
"model_providers": {
"openai": {
"api_key": "your-openai-api-key",
"model": "gpt-4o",
"max_tokens": 128000,
"temperature": 0.5
},
"anthropic": {
"api_key": "your-anthropic-api-key",
"model": "claude-sonnet-4-20250514",
"max_tokens": 4096,
"temperature": 0.5
}
}
}

第六步:验证安装
# 检查CLI是否正常工作
uv run python -m trae_agent.cli --help
# 验证配置
uv run python -m trae_agent.cli show-config
# 查看可用工具
uv run python -m trae_agent.cli tools
第七步:测试基本功能
# 运行简单任务
uv run python -m trae_agent.cli run "Create a hello world Python script"
# 启动交互式会话
uv run python -m trae_agent.cli interactive

实际使用体验:
经过一段时间的深度测试,我对Trae CLI的评价是:有潜力,但还需要时间。
优点:
-
开源免费,降低了使用门槛
-
支持多种LLM提供商,灵活性较高
-
字节背景,后续更新应该会比较积极
缺点:
-
安装过程复杂,新手不友好
-
功能还不够完善,稳定性有待提高
-
与Claude Code相比,智能程度和流畅度还有差距
-
文档相对简陋,学习成本较高
应该选择哪个?
如果你已经在使用Claude Code,并且对其体验满意,我暂时不建议切换到Trae CLI。Claude Code作为Anthropic的研究项目,提供了更成熟的编程体验,能够在终端中实现思维速度的编程,理解整个代码库。
但如果你:
-
想要免费的AI编程助手
-
希望支持国产开源项目
-
对新技术有探索精神
-
不介意复杂的安装过程
那么Trae CLI值得一试。
总结
Trae CLI的推出确实丰富了AI编程工具的选择,但说它是Claude Code的"平替"还为时过早。目前更像是一个有潜力的早期项目,需要时间来完善和优化。
字节跳动在AI领域的布局确实很积极,从豆包到扣子,从Trae IDE到Trae CLI,可以看出他们想要在AI工具链上全面布局的野心。但工具的成熟度还需要时间和用户反馈来不断改进。
对于开发者来说,多一个选择总是好事。我会继续关注Trae CLI的发展,也建议大家可以尝试一下,毕竟开源免费,试错成本不高。
最后提醒: 由于Trae CLI还在alpha阶段,建议在非生产环境中使用,避免影响正常的开发工作。