Agentic AI TRAE IDE 사용법: AI-first 코딩을 빠르게 시작하는 방법

trae ide homepage 캡쳐 이미지
(출처: trae ide homepage)

많은 초보자분들이 코딩 속도가 안 날 때 “내가 실력이 부족한가?”라고 자책하곤 합니다. 하지만 대규모 시스템을 다루는 입장에서 냉정히 보면, 속도를 갉아먹는 진짜 범인은 ‘실력’이 아니라 ‘컨텍스트(Context) 전환’인 경우가 대부분입니다.

코드를 짜다가 문서를 찾고, 다시 챗GPT에 질문을 복사해 넣고, 터미널로 돌아오는 그 찰나의 순간들이 모여 집중력을 깨트리기 때문이죠. TRAE는 이 컨텍스트 전환을 줄이려고 만든 AI-first IDE(코드 에디터+에이전트+워크플로우)입니다.

핵심 한 줄 요약: TRAE = VS Code 감성의 IDE 안에서, AI가 “이해→실행→전달(Deliver)”까지 돕는 협업형 개발 환경

이 도구는 뭐예요?

TRAE IED는 “에디터에 AI를 붙인 것”을 넘어서, 통합환경 안에서 AI가 개발 도구를 함께 쓰도록 설계된 개발 환경이에요. 공식 문서에서도 “AI 통합 + 개발 도구 사용”을 강조하면서 듀얼 개발 모드를 내세웁니다.

아마도 이런 분들에게, 이런 상황에서 딱 맞지 않을까 합니다.

  • 초보자: “뭘 먼저 해야 하지?”를 AI에게 계획부터 받기
  • 실무자: 코드 작성뿐 아니라 리팩토링/디버깅/작업 분해를 빠르게 하기
  • 컨텍스트 큰 프로젝트: 파일/구조/의존성을 IDE 내부에서 묶어서 다루기

왜 지금 TRAE IDE 인가?

요즘 AI 코딩 도구는 크게 두 갈래로 진화 중입니다.

  1. 에디터 + AI 채팅(보조)
  2. 에이전트가 계획/수정/반복까지(대행)

TRAE는 2번 컨셉을 강하게 밀고, “Ship Faster(더 빨리 제품을 내라)” 같은 메시지로 AI 협업 중심 IDE 포지션을 잡고 있는거 같습니다. 게다가 무료 플랜과 유료 플랜이 함께 안내되면서(요금/요청량 등) “일단 써보게 하는” 진입장벽도 낮춘 편입니다. 사실 이런 류는 Gemini CLI, AWS KIRO, OpenCode 등이 기존에 있었죠.

TRAE의 뇌 구조: 두 가지 운전 모드

TRAE의 구조는 ‘자율 주행 자동차’를 떠올리면 이해가 쉽습니다.

  1. IDE 모드 (수동 운전): 평소처럼 내가 주도적으로 코딩합니다. 이때 AI는 옆 조수석에서 코드 제안이나 질문 답변을 돕습니다.(사실 이건 의도적으로 수동으로 개발하지 않는 이상 의미가 없죠.)
  2. Agent/Builder 모드 (반자율 운전): AI에게 목표를 주면, AI가 계획 수립 → 코드 수정 → 검증의 루프를 스스로 돌리며 결과물을 만들어냅니다.

구조적으로는 [프로젝트 저장소] → [TRAE IDE (확장/Git/터미널)] → [AI 협업 엔진] 순으로 연결되어 있어, AI가 내 프로젝트의 파일과 폴더 구조(컨텍스트)를 완벽히 이해한 상태로 동작합니다. 물론, 기존 VS Code의 확장 프로그램(.vsix)들도 그대로 설치해 사용할 수 있어 확장성도 뛰어납니다.

[Repo/Project]
   ↓ (컨텍스트)
[TRAE IDE] ── Extensions / Git / Terminal
   ↓
[AI 협업]
- 질문/설명
- 코드 수정 제안
- 작업(Tasks)로 쪼개기
- 에이전트 실행(가능한 범위 내)

참고로, TRAE는 확장(Extensions)도 지원하고, 문서에서 확장 스토어/VS Code 마켓/로컬 .vsix 설치 같은 흐름을 안내합니다.

TRAE 사용법 참고 이미지

설치 전 체크리스트

설치 환경

공식 다운로드 페이지를 통해 주요 OS를 모두 지원합니다.

  • macOS: macOS 11.0 이상 (Apple Silicon 지원).
  • Windows: Windows 10/11 (x64).
  • Linux: 지원하지만 배포 형태가 시점에 따라 다를 수 있습니다.

권장 사양 (중요)

  • RAM 8GB 이상: AI 에이전트가 돌아갈 때 메모리를 꽤 많이 사용합니다. 커뮤니티에서도 “생각보다 무겁다”는 후기가 있으니 사양을 넉넉히 잡는 게 좋습니다.
  • 필수 도구: Git은 기본으로 설치되어 있어야 하며, 원격 개발을 한다면 SSH 환경도 미리 갖춰두는게 좋습니다.

실전 TRAE 사용법 (Step-by-step)

실전 TRAE 사용법 (Step-by-step) 이미지

백문이 불여일견, 가장 대중적인 ‘React(프론트) + Django(백엔드) 투두 리스트’를 만들며 TRAE의 진가를 확인해 봅시다.

Step 1) 프로젝트 시작

trae ide 이미지

TRAE를 켜고 빈 폴더(여기서는 todolist 이름)를 엽니다. 내장 터미널을 열어 개발 준비를 마칩니다. (우측 상단 trae option image 각 옵션을 눌러 보시며 어떤게 터미널이고 어떤게 AI 대화창인지 알 수 있습니다.)

Step 2) AI에게 “설계도” 요청하기 (핵심)

지시하기 캡쳐 이미지

무작정 코딩하지 말고, AI 대화창에 다음처럼 구체적으로 지시를 해보세요.(이전에 다른 시스템개발로 사용량이 많다보니 지금은 제한이 걸려있는 상태입니다.

“React 프론트와 Django REST 백엔드로 To-Do 앱을 만들 거야. 폴더 구조와 JWT 인증 흐름, API 명세서를 먼저 짜줘. 그리고 1)회원가입 2)로그인 3)CRUD 순서로 작업 체크리스트를 만들어줘.”

이렇게 하면 코드를 짜기 전 명확한 할 일 목록이 생깁니다. 초보자일수록 이 설계 단계가 개발 시간을 획기적으로 줄여줍니다.(사실 ChatGPT 등 전문AI에서 설계를 하고 그걸 기반으로 요청을 해도 좋습니다.)

위와 같은 요청에 다음과 같이 답변을 줍니다. 대략 살펴만 보시고 크게 모르셔도 됩니다. 개발과정 가운데 원하는 것과 다르면 그때그때 얘기를 해주면 됩니다. 그래도 궁금하시면 세부적으로 물어도 됩니다.

프로젝트 구조

- 최상위
  - frontend/ — React 앱 소스
  - backend/ — Django REST + DRF + SimpleJWT
  - .env, .gitignore — 환경변수, VCS 설정
- backend/
  - manage.py
  - requirements.txt
  - config/
    - settings.py — DRF, SimpleJWT, CORS, DATABASE 설정
    - urls.py — 루트 URL 라우팅
    - asgi.py / wsgi.py
  - apps/
    - users/
      - models.py — User 확장(필요 시)
      - serializers.py — RegisterSerializer, UserSerializer
      - views.py — register, me
      - urls.py — /api/auth/*
      - permissions.py — 인증 관련 커스텀 권한(옵션)
    - todos/
      - models.py — Todo(id, title, description, is_completed, owner, created_at, updated_at)
      - serializers.py — TodoSerializer
      - views.py — TodoViewSet (list/create/retrieve/update/partial_update/destroy)
      - urls.py — /api/todos/*
      - filters.py — 상태/검색/정렬(옵션)
  - core/
    - pagination.py — 기본 pagination(옵션)
    - utils.py — 공통 유틸(옵션)
  - tests/
    - users/
    - todos/
- frontend/
  - package.json
  - public/
  - src/
    - app/ — 라우팅, 앱 엔트리
    - components/ — 공용 UI
    - features/
      - auth/ — 로그인/회원가입 폼, 훅, 상태
      - todos/ — 목록/작성/수정/삭제 UI
    - services/
      - api.ts — axios 인스턴스, 인터셉터(JWT, 401 처리)
      - auth.ts — 로그인/회원가입/토큰 관리
      - todos.ts — 할 일 CRUD 호출
    - store/ — 상태관리(Redux/Zustand/Recoil 중 선택)
    - hooks/ — 공용 훅(옵션)
    - styles/ — 전역 스타일(옵션)
JWT 인증 흐름

- 토큰 전략
  - Access Token: 클라이언트 메모리(상태) 보관, Authorization: Bearer
    헤더로 전송
  - Refresh Token: HttpOnly, Secure, SameSite=Strict 쿠키로 보관(서버가 Set-Cookie로 발행). 경로는 /api/auth/refresh로 제한
- 회원가입
  - 클라이언트가 /api/auth/register에 POST
  - 성공 시 201, 즉시 로그인은 선택(보통 별도 로그인 단계)
- 로그인
  - /api/auth/login에 POST(email, password)
  - 서버가 Access Token(JSON 응답)과 Refresh Token(HttpOnly 쿠키) 발행
  - 클라이언트는 Access Token을 메모리에 저장, 이후 요청에 Bearer 헤더 설정
- 액세스 토큰 만료
  - 401 발생 시, 클라이언트 인터셉터가 /api/auth/refresh에 POST(쿠키 자동 전송)
  - 서버가 새 Access Token 반환(JSON), 클라이언트 갱신 후 재시도
- 로그아웃
  - /api/auth/logout POST로 Refresh Token 블랙리스트 처리(옵션)
  - 서버가 Refresh 쿠키 삭제(Set-Cookie: refresh=; Max-Age=0)
  - 클라이언트는 Access Token 메모리에서 제거
- 보안 고려
  - CSRF: Refresh를 쿠키로 사용할 경우, refresh 엔드포인트에 CSRF 보호 또는 SameSite=Strict + Origin 체크
  - CORS: Access-Control-Allow-Credentials=true 설정이 필요한 경우만 허용
  - 토큰 수명: Access 짧게(예: 5–15분), Refresh 길게(예: 7–30일)
API 명세

- 공통
  - Base URL: /api
  - 인증: Authorization: Bearer <access_token> (회원가입/로그인 제외)
  - 에러 응답: { detail: string } 또는 { errors: { field: [messages] } }
- Auth
  - POST /api/auth/register
    - Body: { email, password, name? }
    - 201: { id, email, name }
    - 400: 유효성 실패
  - POST /api/auth/login
    - Body: { email, password }
    - 200: { access: "
      ", user: { id, email, name } }, Set-Cookie: refresh=
      ; HttpOnly; Secure; SameSite=Strict; Path=/api/auth/refresh
    - 401: 인증 실패
  - POST /api/auth/refresh
    - Cookies: refresh=
    - 200: { access: "
      " }
    - 401/403: 쿠키 없음/블랙리스트/만료
  - POST /api/auth/logout
    - Cookies: refresh=
    - 204: 쿠키 삭제(Set-Cookie), 블랙리스트 처리
  - GET /api/auth/me
    - Headers: Authorization
    - 200: { id, email, name, created_at }
- Todos
  - 모델: { id, title, description, is_completed, owner, created_at, updated_at }
  - GET /api/todos
    - Query: page, page_size, search, is_completed, ordering(-created_at 등)
    - 200: { results: [Todo], count, next, previous }
  - POST /api/todos
    - Body: { title, description?, is_completed? }
    - 201: Todo
  - GET /api/todos/{id}
    - 200: Todo
    - 404: 없음
  - PUT /api/todos/{id}
    - Body: 전체 필드
    - 200: Todo
  - PATCH /api/todos/{id}
    - Body: 변경 필드만
    - 200: Todo
  - DELETE /api/todos/{id}
    - 204
  - 권한: owner만 변경/삭제 가능, 목록은 자기 소유만
작업 체크리스트

- 회원가입
  - 백엔드: RegisterSerializer/뷰/URL 추가, 유효성 검사 구현
  - 백엔드: UserSerializer와 /api/auth/me 엔드포인트 구현
  - 프론트: 회원가입 폼(UI/유효성), API 연동, 에러 핸들링
  - 프론트: 성공 후 안내/로그인 이동 처리
- 로그인
  - 백엔드: SimpleJWT 설정, /api/auth/login·/refresh·/logout 구현(쿠키 발행/삭제)
  - 백엔드: CORS/CSRF 설정 정리(쿠키 기반 refresh 보호)
  - 프론트: axios 인스턴스/인터셉터 구성(Authorization, 401→refresh→재시도)
  - 프론트: 로그인 폼, 세션 상태 관리(Access 메모리 저장, 사용자 정보 로드)
- CRUD
  - 백엔드: Todo 모델/마이그레이션/Serializer/ViewSet/라우팅 생성
  - 백엔드: 필터(검색/완료 여부)/정렬/페이지네이션 추가
  - 백엔드: 권한(소유자만 수정/삭제) 및 테스트 작성
  - 프론트: 목록 페이지(페이지네이션/검색/필터), 상세/생성/수정/삭제 UI
  - 프론트: 서비스 레이어(todos.ts)와 상태 관리, 낙관적 업데이트(옵션)
  - 프론트: 에러/로딩/빈 상태, 접근 제어(로그인 필요 라우트) 적용

Step 3) 백엔드 스캐폴딩

요청에 따라 TRAE가 자동으로 백엔드와 프론트를 스캐폴딩하고 JWT/CRUD를 구현·검증 등 개발을 시작합니다. 먼저 백엔드 환경과 프로젝트를 초기화합니다.

0/8 done

백엔드 Django/DRF/SimpleJWT 초기화 및 설정

Auth 엔드포인트 구현: register/login/refresh/logout/me

Todos 모델/Serializer/ViewSet/라우팅 구현

프론트 React(Vite) 초기화 및 라우팅 설정

axios 인스턴스/인터셉터 및 auth 서비스 구성

회원가입/로그인 UI 및 연동

서버 실행 및 기본 동작 검증
백엔드 스캐폴딩 이미지

Step 4) 프론트엔드 연결, Step 5) 코드 리뷰 및 반영 등 이어서 작업을 진행시킵니다.

TRAE가 수정한 코드는 무조건 수락하지 말고, Diff(변경점) 확인 → 테스트 실행 → 커밋 메시지 정리 순으로 검토하세요. 이렇게 해야 속도는 빠르되, 코드의 안정성을 놓치지 않을 수 있습니다.

중간 중간 코드의 진행상태를 확인하라고 아래와 같은 메시지를 주는데 크게 신경쓰지 않고 ‘Keep All’을 클릭하시면 됩니다. (이전 단계 개발과 비교해서 녹색 숫자는 추가한 코드줄, 빨간색은 제거한 코드줄을 의미합니다.)

코드 리뷰 이미지1
코드 리뷰 이미지2

바로 써먹는 팁 3가지

1. 프롬프트 공식: 목표 + 제약 + 검증 (3박자 공식)

많은 분이 AI에게 “로그인 기능 만들어줘”라고만 입력하고는, 결과물이 마음에 들지 않아 여러 번 수정을 반복하곤 합니다. 한 번에 원하는 결과를 얻기 위해 명확한 지시서를 작성해야 합니다. 이 3박자 공식을 사용하면 AI가 딴길로 새는 것을 원천 봉쇄할 수 있습니다.(사실 초보자가 이걸 직접 작성한다는건 어렵고 AI에게 작성해달라고 하면 됩니다.)

  • 나쁜 예: “JWT 로그인 만들어줘.” (AI는 어떤 DB를 쓸지, 프론트는 뭔지, 보안 수준은 어떨지 모릅니다.)
  • 좋은 예 (3박자 공식 적용)
구성 요소설명실전 입력 예시
1. 목표 (Goal)무엇을 만들 것인가?“Python Django와 React를 연동하여 JWT 기반의 로그인 API와 화면을 구현해줘.”
2. 제약 (Constraint)어떻게 만들 것인가? (기술 스택, 규칙)“단, Access Token은 메모리에, Refresh Token은 HttpOnly Cookie에 저장해야 해. 그리고 CSS는 Tailwind를 쓰고, 비밀번호는 Argon2로 해싱해줘.”
3. 검증 (Verify)완료 조건을 무엇으로 할 것인가?“코드를 다 짜면, 1) 유효한 토큰일 때 로그인 성공, 2) 만료된 토큰일 때 401 에러가 뜨는지 확인하는 Jest 테스트 코드도 같이 작성해줘.”

제약 조건을 상세히 걸수록 AI의 환각(Hallucination)이 줄어들고, 내가 평소에 쓰는 코딩 스타일과 비슷한 결과물을 내놓습니다. ‘검증’ 단계가 있어야 AI가 스스로 코드를 다시 한번 점검하는 효과도 있습니다.

2. 확장 프로그램 이식: 내 손에 익은 무기 그대로 가져오기

TRAE는 VS Code를 기반으로 만들어졌지만, 라이선스나 정책 문제로 마이크로소프트의 VS Code 마켓플레이스와 100% 똑같지 않을 수 있습니다. 내가 꼭 쓰는 확장 프로그램이 검색되지 않을 때 당황하지 말고 .vsix 파일을 활용하면 됩니다.

  • 구체적인 실행 방법
    1. 추출하기: 기존에 쓰던 VS Code나 웹사이트(Open VSX Registry 등)에서 원하는 확장의 .vsix 파일(설치 파일)을 다운로드합니다.
    2. 이식하기: TRAE의 확장 프로그램 탭에서 ... (더보기) 메뉴를 누르고 ‘Install from VSIX…’를 선택하여 다운받은 파일을 불러옵니다.
    3. 확인하기: 기존 단축키나 설정(Snippets)이 그대로 작동하는지 확인합니다.

새로운 IDE를 쓸 때 가장 큰 장벽이 ‘단축키와 도구가 달라서’입니다. 이 방법을 쓰면 껍데기는 TRAE지만, 알맹이는 내가 수년 동안 최적화해 둔 VS Code 환경 그대로 사용할 수 있어 적응 기간이 필요 없습니다.(물론 이런걸 하지 않았으면 하등의 문제가 없습니다.)

3. SSH 활용: 내 노트북은 화면만, 머리는 슈퍼컴퓨터로

TRAE IDE는 코드를 분석하고 인덱싱하는 데 생각보다 많은 RAM(메모리)을 사용합니5. 노트북 팬이 굉음을 내며 돌아가거나 타이핑이 밀린다면, 로컬 PC에서 억지로 돌리지 말고 SSH 원격 개발 기능을 사용하면 좋습니다.

  • 어떤 상황에서 쓰나요?
    • 내 노트북은 맥북 에어(RAM 8GB)인데, 돌려야 할 프로젝트는 Docker 컨테이너가 5개씩 뜨는 무거운 서버일 때.
    • AI 모델이나 대용량 데이터셋을 다뤄서 로컬 저장 공간이 부족할 때.
  • 실제 작동 원리
    1. TRAE의 ‘Remote – SSH’ 기능을 켭니다.
    2. 회사 서버나 클라우드(AWS EC2 등)의 고사양 인스턴스에 접속합니다.
    3. 결과: 무거운 빌드, 실행, AI 분석은 서버의 CPU와 RAM이 처리하고, 내 노트북은 단지 그 화면만 보여줍니다. 마치 넷플릭스 영상을 보듯 가볍게 코딩할 수 있습니다.

TRAE가 ‘무겁다’는 평이 있는데, 이는 로컬 자원을 많이 쓰기 때문입니다. SSH로 연결하면 10년 된 노트북에서도 최신 AI 기능을 쾌적하게 쓸 수 있습니다.(16G RAM의 맥북 프로로 전혀 버벅거림이 없습니다.)

온라인 반응/후기 요약

실사용 반응은 대체로 “가성비(혹은 무료/저렴) + 편의성”과 “성능/프라이버시 걱정”으로 갈립니다. 제가 사용해본 경험으로는 제한이 걸리기 전까지 개발속도도 빠르고 직관적으로 사용할 수 있는 UI도 그렇고 무료 버전이라 대만족입니다.

👍 긍정 포인트

  • 무료/저가로 AI IDE 경험: 무료 플랜과 요청량 가이드가 있어 체험 장벽이 낮다는 평가
  • UI/워크플로우 만족: “VS Code보다 직관적” 같은 커뮤니티 반응
  • Pro/유료가 더 쾌적: 대기열/부드러움/커스터마이징이 좋아졌다는 후기
  • 모바일/다른 스택도 무난(개별 후기): Flutter/Dart도 디버깅이 잘 됐다는 Product Hunt 리뷰

👎 아쉬운 포인트

  • 메모리 사용량/버벅임 체감: “RAM을 많이 먹고 끊긴다”는 불만
  • 버그/안정성 이슈: 깃허브 이슈에 UI/프로필/탐색기 문제 제보가 존재
  • 원격/특수환경 제약: SSH/ProxyCommand 같은 환경에서 불편했다는 사례

리스크 & 주의사항 (TOS/보안/비용)

보안 이미지

⚠️ 이 섹션은 “TRAE를 쓰지 마라”가 아니라, 안전하게 쓰는 체크리스트입니다.

1) TOS/API 사용 리스크

  • AI 모델/요금/요청량은 플랜에 따라 달라질 수 있습니다. 공식 Pricing에 있는 요청량/플랜 조건을 먼저 확인하세요. (trae.ai)
  • 회사/기관 프로젝트라면 “코드가 외부로 전송되는지”가 가장 중요합니다.

2) 보안 & 프라이버시(텔레메트리) 이슈

ByteDance/Trae 관련해서 텔레메트리(수집) 논란이 뉴스로 다뤄진 적이 있습니다. “토글을 꺼도 일부 경로는 영향이 없을 수 있다”는 식의 문구 업데이트가 언급됩니다. (Windows Central)
→ 즉, 민감 코드/내부망/국가 연구과제 같은 환경이면 관련 정책 검토 후 도입하는게 좋을 것 같습니다.

3) 확장(Extensions) 공급망 리스크

TRAE 같은 VS Code 포크 IDE는 Open VSX 등 대체 마켓을 쓰는 경우가 있는데, “추천 확장”이 실제 레지스트리에 없을 때 공격자가 이름을 선점해 악성 확장을 올릴 위험이 최근 보안 기사로 나왔습니다(Trae도 언급됨). (The Hacker News)

4) 비용/사용량 폭증 리스크

  • “에이전트 모드”로 시도 횟수가 늘면, 요청량/크레딧 소진이 빨라질 수 있어요. (플랜별 제한 확인이 필요합니다.) (trae.ai)

5) How to verify safely 체크리스트(추천)

  • (네트워크) 어디로 트래픽이 나가는지 모니터링(방화벽/프록시/모니터링 툴)
  • (프로젝트) 민감 리포지토리는 별도 머신/별도 계정으로 분리
  • (확장) 확장 설치 전 퍼블리셔/다운로드/리뷰 확인, 불명확하면 설치 보류
  • (운영) 텔레메트리 설정은 재시작이 필요한지 확인하고 적용 상태 점검(커뮤니티에서도 이 부분이 논점이 된 적 있음) (Hacker News)

자주하는 질문(FAQ)

  1. TRAE는 VS Code랑 뭐가 달라요?
    VS Code와 유사한 사용감을 유지하면서, AI 협업(에이전트/빌더 흐름)을 IDE 중심으로 묶은 방향성이 강합니다.
  2. 무료인가요, 유료인가요?
    공식 사이트에 Free 플랜과 유료 플랜 안내가 같이 있습니다.
  3. 맥/윈도우에서 설치 가능한가요?
    공식 다운로드 페이지에 macOS/Windows 설치가 명시돼 있습니다.
  4. 리눅스도 되나요?
    다운로드 페이지에 Linux가 보이지만 제공 형태는 시점에 따라 다를 수 있어요(또, 리눅스 지원 요청 이슈도 존재).
  5. 확장(Extensions)은 VS Code랑 호환돼요?
    문서에서 확장 스토어/VS Code 마켓/로컬 .vsix 설치를 안내합니다.
  6. 회사 프로젝트에 써도 되나요?
    가능은 하지만, 텔레메트리/데이터 전송 논란이 있었으니 보안 정책과 함께 검토를 권장합니다.
  7. 성능이 무겁다는 말이 있던데요?
    커뮤니티에 RAM 사용량이 크다는 체감 후기가 있습니다. 프로젝트 크기/확장/AI 기능 사용량에 따라 달라질 수 있어요.
  8. Cursor 같은 AI IDE와 비교하면?
    “무료로 Cursor 느낌을 체험” 같은 비교 글들이 나오지만, 최종 선택은 속도/정확도/프라이버시/가격 우선순위에 따라 갈립니다.

유사한 게시물