UStackUStack
Mastra Code favicon

Mastra Code

Mastra Code는 Mastra 프리미티브를 기반으로 구축된 터미널 기반 AI 코딩 에이전트로, 다중 모델 지원, 영구 대화 및 세련된 TUI 내 통합 코딩 도구를 제공합니다.

Mastra Code

Mastra Code란 무엇인가요?

Mastra Code란 무엇인가요?

Mastra Code는 개발자 워크플로우에 원활하게 통합되도록 설계된 고급 터미널 기반 AI 코딩 에이전트입니다. Mastra의 강력한 Harness, Agent 및 Memory 프리미티브를 기반으로 구축되어 대규모 언어 모델의 기능을 명령줄 인터페이스(CLI)로 직접 가져옵니다. 이는 지능적인 페어 프로그래머 역할을 하며, 터미널 환경을 벗어나지 않고도 컨텍스트를 이해하고, 명령을 실행하며, 복잡한 코딩 작업을 관리할 수 있습니다.

이 강력한 에이전트는 70개 이상의 다양한 AI 모델에 연결하여 개발자가 특정 작업에 가장 적합한 모델을 활용하거나 대화 도중에 제공업체 간 출력을 비교할 수 있도록 합니다. 핵심 목적은 코드 읽기, 검색, 편집 및 실행 기능에 즉시 액세스할 수 있도록 하여 생산성을 향상시키는 것이며, 이 모든 것은 직관적인 텍스트 사용자 인터페이스(TUI)를 통해 관리됩니다.

주요 기능

  • 다중 모델 지원: 70개 이상의 AI 모델에 연결하고 지원하여 단일 세션 내에서 제공업체(예: Anthropic 또는 OpenAI) 간 동적 전환을 활성화하여 최적의 성능 또는 비용 관리를 지원합니다.
  • 워크플로우 모드: 개발자의 현재 초점에 맞추기 위해 Build(일반 개발), Plan(아키텍처 분석 및 계획), Fast(낮은 지연 시간의 빠른 조회/편집)라는 뚜렷한 작동 모드를 제공합니다.
  • 통합 도구: 파일 보기, 편집, 코드 검색, 셸 명령 실행 및 웹 검색을 포함하여 필수 개발 작업을 위한 내장 도구를 제공합니다.
  • 영구 컨텍스트 및 구성: 프로젝트 범위의 대화 스레드, MCP 서버, 사용자 지정 후크 및 기술을 지원합니다. 스레드 지속성은 세션 전반에 걸쳐 연속성을 보장합니다.
  • 확장성: 개발자가 사용자 지정 모드, 새 도구, 하위 에이전트 및 대체 스토리지 솔루션을 추가하여 프로그래밍 방식으로 기능을 확장할 수 있도록 높은 사용자 정의가 가능합니다.
  • 세련된 TUI: pi-tui 구성 요소를 사용하여 구축된 현대적이고 반응성이 뛰어난 터미널 인터페이스를 갖추고 있어 작업, 도구 출력 및 토큰 사용에 대한 명확한 가시성을 제공합니다.

Mastra Code 사용 방법

Mastra Code를 시작하는 것은 간단하며, 전제 조건으로 Node.js(버전 22.13.0 이상)가 필요합니다.

1. 설치: npm, yarn, bun을 사용하여 Mastra Code를 전역적으로 설치하거나 npx 또는 bun x를 통해 직접 실행합니다.

npm install -g mastracode
# 또는
bun x mastracode

2. 초기화: 프로젝트 디렉터리로 이동하여 에이전트를 실행합니다.

cd your-project
mastracode

3. 인증: API 키를 환경 변수(예: export ANTHROPIC_API_KEY=...)로 설정하거나 /login 슬래시 명령을 사용하여 OAuth 제공업체를 통해 인증합니다.

4. 상호 작용: 인증되면 TUI에 요청이나 명령을 입력하기만 하면 됩니다. 에이전트는 응답을 스트리밍하며 프로젝트 컨텍스트 내에서 코드를 적극적으로 읽고, 편집하고, 실행할 수 있습니다. 워크플로우를 전환하려면 /mode와 같은 슬래시 명령을 사용하거나 대화를 관리하려면 /threads를 사용합니다.

사용 사례

  1. 일상적인 리팩토링 및 디버깅: 에이전트에게 복잡한 함수를 설명하도록 요청하거나, 리팩토링 개선 사항을 제안하도록 하거나, 특정 모듈에 대한 단위 테스트를 생성하거나, 터미널에서 직접 간단한 Git 작업을 관리할 수 있습니다.
  2. 아키텍처 계획: Plan Mode를 활용하여 에이전트에게 고수준 요구 사항을 제공합니다. 에이전트는 기존 코드 구조를 분석하고, 상세한 구현 계획을 제안하며, 코드를 작성하기 전에 필요한 파일 변경 사항을 개략적으로 설명할 수 있습니다.
  3. 빠른 컨텍스트 전환: 레거시 시스템이나 익숙하지 않은 코드베이스에서 작업할 때, Mastra Code를 사용하여 빠른 조회(/mode Fast)를 수행하여 문서를 즉시 검색하거나 여러 파일을 열지 않고 특정 변수가 초기화된 위치를 찾을 수 있습니다.
  4. 모델 비교 테스트: 성능 집약적인 작업을 수행하는 개발자는 대화 도중에 모델을 전환하여(예: GPT-4o 지연 시간 대 Claude 3 Opus 추론 비교) 현재 작업에 가장 적합하고 비용 효율적인 AI를 선택할 수 있습니다.
  5. 사용자 지정 도구 통합: 팀은 내부 배포 스크립트나 독점 데이터베이스 상호 작용에 맞게 사용자 지정 슬래시 명령이나 하위 에이전트를 정의하여 전문화된 워크플로우를 에이전트 기능에 직접 통합할 수 있습니다.

FAQ

Q: Mastra Code를 실행하기 위한 최소 시스템 요구 사항은 무엇인가요? A: Mastra Code는 효과적으로 실행되려면 Node.js 버전 22.13.0 이상이 필요합니다. 설치 전에 환경이 이 요구 사항을 충족하는지 확인하십시오.

Q: Mastra Code는 대화 기록 및 컨텍스트를 어떻게 처리하나요? A: 스레드 지속성, 메시지 기록 및 토큰 사용량 추적을 위해 LibSQL Storage를 활용합니다. 대화는 종종 프로젝트 디렉터리를 기준으로 범위가 지정되어 에이전트가 세션 전반에 걸쳐 관련 컨텍스트를 기억하도록 보장합니다.

Q: 에이전트에 대한 사용자 지정 명령을 정의할 수 있나요? A: 예, Mastra Code는 확장성이 뛰어납니다. 마크다운 파일을 생성하여 사용자 지정 슬래시 명령을 정의할 수 있으므로 특정 조직 요구 사항이나 내부 도구에 맞게 에이전트 기능을 조정할 수 있습니다.

Q: 에이전트가 긴 작업을 실행하는 경우 어떻게 되나요? A: 표준 키보드 단축키인 Ctrl+C를 사용하여 현재 작업을 중단할 수 있습니다. 이를 통해 실행 중인 셸 명령이나 진행 중인 생성 프로세스를 즉시 중지할 수 있습니다.

Q: 어떤 AI 제공업체를 사용하고 있는지 어떻게 관리하나요? A: /models 슬래시 명령을 사용하거나 관련 API 키 환경 변수를 설정하여 대화 도중에 모델을 전환할 수 있습니다. 이 에이전트는 Anthropic 및 OpenAI와 같은 주요 제공업체에 대한 인증을 지원합니다.

Mastra Code | UStack