字节跳动刚刚推出了一个终端 AI 编程工具，类似于 Claude Code 或 Gemini CLI。我刚测试过，可能会让你失望。

字节跳动 一直在慢慢追赶 Cursor、Claude 和其他 AI 编程助手，试图在编程助手市场中建立自己的立足点。

Trae AI，并没有达到我的期望，尽管后来的更新令人印象深刻，显示出显著的改进。

让我带你了解设置过程，这不像 Gemini CLI 和 Claude Code 那样简单。

我将在 Windows 上设置这个工具，并使用 PowerShell 演示所有步骤，包括安装 UV Python 包管理器。

什么是 Trae CLI？

Trae CLI 是一个使用自然语言指令并执行复杂软件工程工作流的命令行代理。

它支持 OpenAI 和 Anthropic API，提供文件编辑、bash 执行和交互式开发工具。

先决条件

• Windows 10/11 带 PowerShell

• Python 3.12+（推荐）

• 已安装 Git

• VS Code 或任何终端

第1步：克隆 Trae CLI 仓库

在你想要的目录中打开 PowerShell 并克隆 Trae Agent 仓库：

git clone https://github.com/bytedance/trae-agent
cd trae-agent

第2步：安装 uv（Python 包管理器）Trae CLI 使用 uv 进行快速依赖管理。使用 PowerShell 安装：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

这将把 uv 安装到 C:\Users\USER\.local\bin第3步：将 uv 添加到 PATH

将 uv 添加到当前 PowerShell 会话中：

$env:Path = "C:\Users\USER\.local\bin;$env:Path"

验证安装：

uv --version

你应该看到类似的输出：uv 0.7.19 (37ee6dc80 2025-07-02)

第4步：安装项目依赖

使用 uv 安装所有必需的依赖项：

uv sync

• 在 .venv 创建虚拟环境

• 安装所有依赖项，包括 anthropic、openai、click、rich 等

• 安装 trae-agent 包本身

第5步：配置 API 密钥

你需要至少一个 AI API 密钥来使用 Trae CLI。编辑配置文件：

notepad trae_config.json

用你的实际 API 密钥替换占位符值：

{
  "default_provider": "anthropic",
  "max_steps": 20,
  "enable_lakeview": true,
  "model_providers": {
    "openai": {
      "api_key": "your-actual-openai-api-key",
      "model": "gpt-4o",
      "max_tokens": 128000,
      "temperature": 0.5,
      "top_p": 1,
      "max_retries": 10
    },
    "anthropic": {
      "api_key": "your-actual-anthropic-api-key",
      "model": "claude-sonnet-4-20250514",
      "max_tokens": 4096,
      "temperature": 0.5,
      "top_p": 1,
      "top_k": 0,
      "max_retries": 10
    }
  }
}

获取 API 密钥：Anthropic (Claude) — 推荐：

• 访问 https://console.anthropic.com/

• 创建账户并生成 API 密钥

OpenAI：

• 访问 https://platform.openai.com/

• 创建账户并生成 API 密钥

第6步：测试安装

验证 Trae CLI 是否正常工作：

# 检查 CLI 是否可访问
uv run python -m trae_agent.cli --help

你应该看到帮助菜单，显示可用命令：

• interactive - 启动交互式会话

• run - 运行任务

• show-config - 显示当前配置

• tools - 显示可用工具

第7步：验证配置

检查你的 API 密钥是否正确配置：

uv run python -m trae_agent.cli show-config

你应该看到一个格式化的表格，显示：

• 常规设置（默认提供商、最大步数）

• OpenAI 配置（模型、API 密钥状态）

• Anthropic 配置（模型、API 密钥状态）

第8步：测试基本功能

查看可用工具：

uv run python -m trae_agent.cli tools

运行简单任务：

 uv run python -m trae_agent.cli run "Create a hello world Python script"

你可以从他们的官方仓库了解更多命令：https://github.com/bytedance/trae-agent

结语

老实说，在这个阶段，我不想花太多时间测试这个工具；我会在未来检查新的更新。

Trae CLI 确实无法与 Claude Code 和 Gemini CLI 的流畅安装相匹敌。

设置过程涉及多个步骤和依赖管理，与竞争对手相比感觉很繁琐。

由于它在开发的早期阶段，这里不做严厉的判断。

该工具显示出前景，字节跳动正在积极改进。