Mastra Code

Mastra Code란?

Mastra Code는 Mastra의 Harness, Agent, Memory 기본 요소로 구축된 터미널 기반 AI 코딩 에이전트입니다. 터미널에서 실행되며 70+ AI 모델에 연결해 프로젝트 내에서 코드 읽기, 검색, 편집, 실행 같은 상호작용 코딩 워크플로를 지원합니다.

에이전트의 핵심 목적은 터미널 TUI(터미널 사용자 인터페이스), 구조화된 모드, 프로젝트 단위 세션 관리를 통해 코딩 작업을 돕는 것입니다. 빠른 조회, 계획된 구현, 전체 빌드-테스트 루프 등 에이전트의 사고와 행동 방식을 체계적으로 구성하도록 설계되었습니다.

주요 기능

• 터미널 UI(TUI) 경험: 별도 웹 앱 대신 터미널에서 세련된 TUI(pi-tui 컴포넌트)를 제공해 상호작용 에이전트 사용을 지원합니다.
• 다중 모델 지원(70+ 모델): 70+ AI 모델에 연결하며 대화 중 모델 전환으로 다중 모델 워크플로를 지원합니다.
• 모드 기반 워크플로 제어: 에이전트 응답 방식을 맞춰 Build, Plan, Fast 모드 간 전환(예: 구현 vs. 빠른 답변).
• 프로젝트 단위 세션 및 지속적 컨텍스트: 스레드 지속성과 메시지 기록으로 프로젝트별 대화 정리.
• 에이전트 내 코딩 도구: 파일 보기, 편집, 검색, 셸 명령, 웹 검색 내장 도구로 엔드투엔드 코딩 작업 지원.
• 설정 가능한 에이전트 동작: MCP 서버, 훅, 사용자 지정 명령, 스킬, 데이터베이스 설정 등 프로젝트 단위 구성 지원.
• 프로그래밍적 커스터마이징: 사용자 지정 모드, 도구, 서브에이전트, 스토리지로 Mastra Code 확장.

Mastra Code 사용법

1. 제공 명령어(npm, pnpm, yarn) 중 하나로 전역 설치, 예: npm install -g mastracode.
2. 프로젝트 디렉토리로 이동: cd your-project 후 mastracode로 Mastra Code 시작.
3. 선호 제공자 API 키 설정(Anthropic 예시: export ANTHROPIC_API_KEY=...) 또는 /login으로 인증(Anthropic 또는 OpenAI 구독 언급).
4. 터미널에 메시지 전송; 에이전트가 스트리밍 텍스트로 응답하며 프로젝트 코드 읽기·편집·실행 가능.
5. 슬래시 명령과 키보드 단축키로 세션 관리, 모델·모드 전환, TUI 제어(예: /threads, /models, /mode, /cost, /login, /exit).

사용 사례

• 일상 코딩 어시스턴트: 코드베이스 질문, 편집 요청, 테스트 실행, Git 작업을 동일 터미널 워크플로에서 처리.
• 코드 탐색 및 아키텍처 계획: Plan 모드로 아키텍처 분석 및 구현 계획 생성 후 코딩.
• 빠른 조회 및 소규모 변경: Fast 모드로 최소 지연의 간단 답변과 사소한 편집.
• 다중 제공자 비교: 대화 중 모델 전환으로 동일 코딩 질문에 대한 AI 모델 응답 비교.
• 개발 중 세션 및 설정 관리: 슬래시 명령으로 새 대화 스레드 시작, 프로젝트별 스레드 목록, 스레드 복제, 토큰 사용량 확인, 설정/테마 조정.

자주 묻는 질문

Mastra Code의 시스템 요구 사항은? Mastra Code는 Node.js 22.13.0 이상이 필요합니다.

AI 제공자와 인증하는 방법은? 제공자 환경 변수 API 키 설정(Anthropic 예시 제공) 또는 /login 실행으로 Anthropic 또는 OpenAI 구독 인증.

에이전트 사용 중 AI 모델과 모드 전환이 가능하나요? 네. 슬래시 명령으로 다른 AI 모델 선택 및 Build, Plan, Fast 모드 전환 가능.

Mastra Code가 대화를 어떻게 정리하나요? 프로젝트 단위 스레드와 지속적 대화 기록으로 프로젝트 내 스레드 목록, 복제, 관리 지원.

도구나 에이전트 동작 커스터마이징을 지원하나요? 네. MCP 서버, 훅, 사용자 지정 명령, 스킬, 데이터베이스 설정 구성 및 사용자 지정 모드, 도구, 서브에이전트, 스토리지로 에이전트 확장 가능.

대안

• 로컬 IDE 통합 AI 코딩 도구: 에디터/IDE 내부에서 실행되는 대안은 문맥 기반 코드 지원을 제공하지만, 터미널 우선 에이전트 워크플로와 명시적 모드보다는 인라인 제안에 초점을 맞춥니다.
• 커스텀 도구를 사용한 범용 터미널 LLM 채팅: 터미널 채팅 에이전트를 스크립트로 파일 편집과 명령 실행을 확장할 수 있지만, Mastra Code의 내장 도구, 모드 처리, 세션/스레드 구조를 재현하려면 더 많은 설정이 필요합니다.
• 워크플로 기반 코딩 어시스턴트 (계획/빌드 스타일): 구현 전 계획을 강조하는 도구는 “Plan mode” 아이디어를 맞출 수 있습니다; 차이점은 도구 실행(편집/검색/셸)과 지속적 프로젝트 스레드 처리에서 발생합니다.
• 코딩 작업용 에이전트 프레임워크: 범용 에이전트 프레임워크로 메모리와 도구를 가진 코딩 에이전트를 만들 수 있지만, Mastra Code는 이러한 기본 요소를 즉시 실행 가능한 터미널 TUI로 패키징합니다.