Trae SOLO 실전 가이드: AI 자율 코딩 에이전트로 요구사항 분석부터 Vercel 배포까지
텔레메트리를 껐는데도 7분간 500회 네트워크 호출이 발생했다. Trae SOLO 이야기를 시작하기 전에 이것부터 말해야 합니다.
ByteDance가 만든 AI 코딩 IDE Trae의 핵심 자율 에이전트 모드인 SOLO는, 단순 자동완성이 아니라 요구사항을 받아서 코드를 짜고 버그를 잡고 배포까지 스스로 처리하는 방향으로 설계되었습니다. 저도 처음 소식을 접했을 때 반신반의했습니다. 에이전트 마케팅은 늘 과장이 섞여 있으니까요. 그런데 벤치마크와 실제 사용 사례를 파고들다 보니, 분명히 주목할 만한 부분이 있었습니다. 동시에 기업 환경에서는 절대 그냥 써서는 안 되는 데이터 수집 이슈도 함께 확인했습니다.
이 글을 읽고 나면 Trae SOLO가 내 개발 워크플로에 맞는지, 어떤 상황에서 활용할 수 있고 어떤 상황에서는 피해야 하는지 스스로 판단할 수 있게 됩니다. 풀스택 개발 경험이 있는 분이라면 특히 예시 섹션에서 바로 써먹을 수 있는 내용들을 찾을 수 있을 겁니다.
핵심 개념
SOLO 모드란 무엇인가
SOLO는 Trae IDE에 내장된 자율 실행 에이전트 모드입니다. 사용자가 자연어로 요청을 입력하면 SOLO Coder 에이전트가 태스크를 잘게 분해하고, 각 서브태스크를 독립 컨텍스트를 가진 하위 에이전트들에게 병렬로 위임합니다. 브라우저, 터미널, 에디터, 문서 도구를 하나의 오케스트레이션 레이어로 묶어서 처리하는 구조입니다.
Responsive Coding Agent: 코드를 생성하는 것을 넘어, 실행 결과를 관찰하고 오류에 반응해 스스로 수정 루프를 돌리는 에이전트 패턴. 쉽게 말하면 SOLO는 틀리면 스스로 고칩니다. 몇 번까지 반복하는지는 설정에 달려 있고요.
2025년 7월 SOLO Beta(당시 이름은 SOLO Builder)로 처음 공개된 이후, 기능을 다듬은 안정 버전인 SOLO Coder로 발전했습니다. Builder는 초기 빌드 자동화에 초점을 맞춘 베타 명칭이고, Coder는 전반적인 코딩 에이전트로 확장된 정식 버전이라고 이해하면 됩니다. Trae 2.0 업그레이드를 통해 전면 통합되었고, 국제판 기준 침투율 44%를 기록했습니다(Trae 2025 연간 보고서). 등록 사용자 600만 명, 월간 활성 사용자 160만 명 규모입니다.
SOLO를 지탱하는 핵심 기술들
SOLO가 단순한 GPT 래퍼와 다른 이유는 내부 기술 스택에 있습니다.
| 기술 | 역할 |
|---|---|
| CodeGraph | 파일 간 의존성을 그래프 구조로 추적. 리팩토링 시 연쇄 영향 파악에 활용 |
| Context Compression | 장기 실행 프로젝트에서 컨텍스트 길이를 자동 압축해 성능 유지 |
| MCP (Model Context Protocol) | SOLO Coder와 서브에이전트 간 통신 프로토콜. 커스텀 서버 연결 가능 |
| 멀티 에이전트 병렬화 | 독립적인 서브태스크를 동시에 처리해 실행 시간 단축 |
오케스트레이터-서브에이전트 분리 구조가 왜 중요한지 잠깐 짚어두면, 서브에이전트마다 독립 컨텍스트를 갖기 때문에 한 태스크의 잡음이 다른 태스크 결과에 오염되지 않고, 서로 무관한 작업은 실제로 병렬 실행됩니다. 단순히 "여러 스레드로 쪼갠다"는 개념과는 결이 다릅니다.
CodeGraph에 대해 좀 더 구체적으로 얘기하면, A 컴포넌트의 props 타입을 바꿨을 때 이를 사용하는 B, C, D 파일까지 자동 추적해서 함께 수정해주는 방식입니다. 저도 처음엔 "그냥 grep 잘 하는 거 아닌가?" 싶었는데, 간접 의존성까지 잡아내는 부분에서 확실히 차이를 느꼈습니다.
Context Compression은 긴 세션에서 슬라이딩 윈도우 방식으로 오래된 컨텍스트를 요약·압축해서 모델이 처리할 수 있는 범위 안에 핵심 정보를 유지하는 방식으로 알려져 있습니다.
MCP (Model Context Protocol): AI 에이전트가 외부 도구·데이터 소스와 표준화된 방식으로 통신하기 위한 프로토콜. Anthropic이 제안하고 업계에서 빠르게 채택 중인 사실상의 표준입니다.
MCP 커스텀 서버 설정은 아래처럼 trae.json 파일에 구성합니다.
{
"mcp_servers": {
"my-custom-server": {
"command": "node",
"args": ["./mcp-server/index.js"],
"env": {
"API_KEY": "${MY_API_KEY}"
}
}
},
"custom_rules": [
"항상 TypeScript strict mode를 사용할 것",
"컴포넌트는 함수형으로만 작성할 것"
]
}API 키는 반드시 ${MY_API_KEY} 형태의 환경 변수로 참조하는 것이 좋습니다. 실제 키를 직접 입력하면 버전 관리에 포함될 위험이 있으니까요.
trae-agent: 오픈소스로 공개된 기반
ByteDance는 SOLO의 기반이 되는 에이전트 프레임워크를 오픈소스로 공개했습니다. trae-agent는 OpenAI, Anthropic, Gemini, Azure, Doubao 등 멀티 LLM을 지원하는 범용 소프트웨어 엔지니어링 에이전트입니다.
# trae-agent 설치 및 실행
git clone https://github.com/bytedance/trae-agent
cd trae-agent
pip install -e .
# 설정 파일에 LLM 키 등록 후 실행
trae-agent run --task "FastAPI로 CRUD API 만들어줘" --model claude-3-5-sonnet-20241022모델 ID는 공식 문서에서 최신 버전을 확인하고 사용하는 것이 좋습니다. 버전 식별자 없이 짧은 이름만 쓰면 API에 따라 오류가 날 수 있으니 주의하세요.
오픈소스라는 점이 중요한 이유는 단순히 무료여서가 아닙니다. 내부 동작 방식을 직접 확인하거나, 클라우드 IDE를 거치지 않고 사내 인프라에서 독립적으로 실행할 수 있다는 탈출구가 생기기 때문입니다.
실전 적용
풀스택 MVP 빠르게 뽑기 — 0에서 Vercel 배포까지 프롬프트 한 번
가장 대표적인 시나리오입니다. 실무에서 자주 맞닥뜨리는 상황인데, MVP를 빠르게 만들어야 할 때 SOLO의 진가가 드러납니다. 실제로 45개 컴포넌트짜리 프로젝트를 돌려봤을 때 태스크 분해부터 배포까지 사람이 개입할 구간이 생각보다 적었습니다.
[SOLO 입력 — Trae 채팅창에 직접 입력]
고객 피드백을 수집하는 폼 페이지를 만들어줘.
- Next.js App Router 기반
- 이름, 이메일, 피드백 내용 입력
- 제출 시 Supabase에 저장
- 완성되면 Vercel에 배포까지 해줘SOLO가 처리하는 순서를 내부적으로 따라가면 이렇습니다.
| 단계 | SOLO 에이전트 행동 |
|---|---|
| 1. 태스크 분해 | PRD 초안 생성 → 파일 구조 설계 |
| 2. 코드 생성 | page.tsx, actions.ts, supabase.ts 병렬 생성 |
| 3. 검증 | 로컬 빌드 실행, 오류 감지 시 자동 수정 루프 |
| 4. 배포 | Vercel CLI 연동, 배포 링크 반환 |
전체 과정에 사람이 개입하지 않습니다. 물론 결과물을 그대로 프로덕션에 올리는 건 별개 문제입니다만, 프로토타이핑 속도는 확실히 다릅니다.
대규모 React 앱 의존성 업데이트 — CodeGraph가 빛나는 순간
솔직히 이 벤치마크 수치가 가장 인상적이었습니다. 45개 컴포넌트를 가진 React 앱에서 의존성 업데이트 태스크를 수행했을 때, SOLO가 94%의 정확도로 처리했습니다(Trae vs Cursor 비교, Zoer AI). Cursor가 같은 태스크에서 89%였으니, CodeGraph 기반의 의존성 추적이 실제로 효과를 내고 있다는 의미입니다.
[SOLO 입력]
이 프로젝트의 모든 React 컴포넌트를 React 19 기준으로 마이그레이션해줘.
deprecated된 API는 최신 패턴으로 교체하고,
변경된 파일 목록과 이유를 정리해줘.마지막 줄 "변경된 파일 목록과 이유를 정리해줘"는 사소해 보이지만 실제로 중요한 패턴입니다. 에이전트가 결과물을 설명하도록 강제하면 검증이 훨씬 쉬워지고, SOLO가 어떤 판단을 내렸는지 추적할 수 있게 됩니다. 이 문장 하나가 PR 리뷰 시간을 꽤 줄여줬습니다.
CodeGraph가 파일 간 import 관계를 그래프로 파악하고 있기 때문에, 하나의 컴포넌트 변경이 다른 곳에 미치는 영향을 놓치지 않습니다. 기존 도구들이 자주 빠뜨리던 간접 의존성 처리가 개선된 부분입니다.
음성 입력으로 PRD 작성 후 바로 개발
Trae SOLO는 음성 입력을 지원합니다. 팀원에게 말하듯이 기능을 설명하면, AI가 PRD를 먼저 작성하고, 그 PRD를 기반으로 코딩 단계에 바로 진입합니다.
[음성 입력 예시]
"사용자가 마이페이지에서 알림 설정을 on/off 할 수 있어야 해.
이메일이랑 푸시 알림 각각 따로 설정 가능하고,
변경 즉시 저장되는 방식으로."PRD 자동 생성 → 구현 자동화의 흐름이 연결되면, 기획-개발 간 컨텍스트 전달 손실을 줄이는 데 유용합니다. 혼자 작업하는 개발자나 작은 팀에서 특히 실용적인 기능입니다.
장단점 분석
한눈에 보는 비교
| 항목 | Trae SOLO | Cursor | 비고 |
|---|---|---|---|
| 자율 성공률 | 75.2% | 약 70% | 실제 태스크 기준 |
| 초회 정확도 | 78% | 87% | Cursor 우위 |
| 보안 취약점 탐지 | 81% | 86% | Cursor 우위 |
| 의존성 업데이트 정확도 | 94% | 89% | SOLO 우위 |
| 응답 속도 | 평균 1.2초 | 약 1.8초 | SOLO 우위 |
| 메모리 사용량 | 1.5GB | 약 2.5GB | SOLO 경량 |
| 무료 플랜 | 공격적 제공 | 제한적 | SOLO 유리 |
| 데이터 수집 투명성 | ⚠️ 논란 있음 | 상대적으로 명확 | 기업 환경 주의 |
단점 및 주의사항
| 항목 | 내용 | 대응 방안 |
|---|---|---|
| 초회 정확도 | 78% (Cursor 87% 대비 낮음) | 프로덕션 적용 전 코드 리뷰 필수 |
| 보안 취약점 탐지 | 81% (Cursor 86% 대비 열위) | Semgrep, Snyk 등 전용 SAST 도구 병행 |
| 데이터 수집 | 텔레메트리 비활성화 후에도 7분간 약 500회 네트워크 호출, 26MB 데이터 전송 관측 (The Register, Cybernews) | 기업 환경, 민감 프로젝트 사용 전 보안팀 검토 권장 |
| 개인정보 보유 기간 | 서비스 종료 후 5년간 데이터 보유 | 수집 항목 및 정책 문서 직접 확인 |
| 투명성 논란 | Discord에서 텔레메트리 우려를 제기한 개발자 계정 뮤트 사례 | 커뮤니티 피드백 모니터링 |
텔레메트리(Telemetry): 소프트웨어가 사용 패턴, 오류 정보 등을 수집하는 기능. 일반적으로는 제품 개선 목적인데, Trae의 경우 수집 항목(하드웨어 스펙, 파일 경로, 마우스/키보드 패턴, 창 포커스 상태 등)과 비활성화 후에도 지속되는 전송이 문제로 지적됩니다.
데이터 수집 이슈를 어떻게 판단할지 기준이 필요하다면, 간단하게 이렇게 생각해볼 수 있습니다. "이 IDE가 내 코드를 보고 있어도 괜찮은 프로젝트인가?" — 개인 토이 프로젝트라면 판단은 각자의 몫이지만, 고객 정보가 담긴 코드, 사내 핵심 로직, 미공개 기술이 포함된 프로젝트라면 직접 측정된 수치(비활성화 후에도 500회 호출)를 근거로 신중하게 접근하는 것이 좋습니다. 기업에서 도입을 검토하고 있다면 법무·보안팀과 먼저 상의해보시는 것을 권장합니다.
실수 방지 체크리스트
- SOLO 출력을 리뷰 없이 바로 merge하는 것 — 초회 정확도 78%는 곧 5번 중 1번은 문제가 있다는 의미입니다. 에이전트 결과물도 PR 리뷰 프로세스를 거치는 것이 좋습니다.
- 보안 취약점 탐지를 SOLO에만 의존하는 것 — 81% 탐지율은 나쁘지 않지만, 보안 민감 코드는 Semgrep이나 Snyk 같은 전용 도구를 함께 쓰는 것이 안전합니다.
- MCP 커스텀 서버 설정 없이 쓰는 것 — 프로젝트별 컨벤션이나 내부 API 문서를 MCP로 연결해두면 SOLO의 출력 품질이 눈에 띄게 올라갑니다. 기본 설정으로만 쓰는 건 반쪽짜리 사용이라고 봐도 됩니다.
마치며
Trae SOLO는 자율 에이전트 코딩의 현재 수준을 가장 직접적으로 체험해볼 수 있는 도구입니다. 다만 데이터 수집 이슈를 먼저 직시하고 사용 환경을 신중히 선택하는 것이 필요합니다. 보안 이슈를 알고도 쓰는 것과 모르고 쓰는 것은 다릅니다. 이 글을 읽었다면 이제 선택은 여러분의 몫입니다.
관심이 생겼다면 아래 순서로 시작해보시면 좋습니다.
- 개인 토이 프로젝트로 먼저 체험해보기 — trae.ai에서 Trae를 다운로드하고, 단 설치 직후 설정에서 텔레메트리 비활성화부터 확인해보시는 것을 권장합니다. 민감 정보가 없는 사이드 프로젝트에 SOLO 모드를 활성화해서 "간단한 TODO 앱 만들어줘"처럼 작은 태스크부터 시작해 에이전트의 분해-실행 흐름을 직접 관찰해볼 수 있습니다.
- trae-agent 오픈소스로 내부 동작 파악하기 —
git clone https://github.com/bytedance/trae-agent후 로컬에서 직접 실행해볼 수 있습니다. 클라우드 IDE 대신 로컬 환경에서TRAE_TELEMETRY_DISABLED=1환경 변수를 설정하거나, 자체 API 키를 연결하면 데이터 전송 경로를 더 잘 제어할 수 있습니다. - MCP 커스텀 룰 설정하기 —
trae.json의custom_rules섹션에 프로젝트 컨벤션(코드 스타일, 금지 패턴, 내부 라이브러리 사용 규칙 등)을 추가해두면 SOLO 출력이 팀 기준에 훨씬 가까워집니다. 이 단계를 거치면 결과물 리뷰 시간이 체감상 절반 가까이 줄어드는 것을 느낄 수 있을 겁니다.
다음 글: Cursor vs Windsurf vs Trae — 2025년 기준 자율 에이전트 코딩 도구 3파전, 어떤 팀에 무엇이 맞는가
참고 자료
- TRAE SOLO 공식 페이지 | trae.ai
- SOLO 안정 버전 출시 발표 | AIBase
- Trae 2.0 SOLO 모드 심층 리뷰 | Oreate AI Blog
- trae-agent GitHub | ByteDance 공식
- Trae vs Cursor vs Windsurf 비교 | Zoer AI
- ByteDance Trae 텔레메트리 문제 | The Register
- Trae 데이터 수집 분석 | Cybernews
- Trae 2025 연간 보고서 | AIBase
- Trae vs Windsurf 비교 | UI Bakery
- 멀티 에이전트 시스템 구현 | Medium