今天苏米就手把手教大家如何使用字节跳动刚刚开源的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阶段，建议在非生产环境中使用，避免影响正常的开发工作。