MiniMax-AI/minimax-code
An open-source coding agent for your terminal, powered by MiniMax.
MiniMax Code – 터미널 기반 코딩 어시스턴트
소개 – MiniMax Code(mcode로 호출)는 터미널에서 직접 대규모 언어 모델(LLM)과 대화하여 코드를 이해, 편집 및 테스트할 수 있는 명령줄 도구입니다. MiniMax 호스팅 모델, "Token Plan" 계정 또는 제공하는 모든 OpenAI/Anthropic 호환 엔드포인트와 함께 작동합니다.
핵심 기능
| 기능 | 수행 작업 |
|---|---|
| 대화형 TUI | 텍스트 기반 UI를 열고 작업(예: "실패한 테스트 수정")을 설명하면 에이전트가 파일을 읽고, 차이점을 제안하고, 명령을 실행하고, 변경 사항을 적용하는 과정을 볼 수 있습니다. |
| 헤드리스/CI 모드 | mcode exec "<prompt>"는 UI 없이 실행되므로 스크립트, CI 파이프라인 또는 배치 평가에 적합합니다. |
| 모델 유연성 | MiniMax 계정을 사용하거나 mcode provider add …를 통해 자체 제공업체를 추가할 수 있습니다. OpenAI 스타일의 완성, 응답 및 Anthropic 스타일의 메시지를 지원합니다. |
| 도구 사용 | 에이전트는 내장 검색, 파일 시스템 탐색, 셸 명령 및 미디어 도구(mcode-tools)를 호출할 수 있습니다. 권한 및 샌드박스를 통해 실행 안전성이 유지됩니다. |
| 세션 관리 | 이전 작업 재개(mcode --continue), 과거 세션 선택(mcode --session) 또는 "플랜 모드" 토글을 통한 플랜 내보내기가 가능합니다. |
| 에디터 통합 | Agent Client Protocol(ACP)을 통해 프로토콜을 지원하는 에디터에 CLI를 연결할 수 있습니다. |
빠른 시작
- 설치 – 원라인 설치 프로그램(macOS/Linux/WSL), Windows용 PowerShell 스크립트 또는
npm i -g @minimax-ai/code를 사용합니다. 설치 프로그램은 필요 시 호환되는 Node.js 런타임을 가져옵니다. - 로그인 –
mcode login(중국 외 계정은--region global사용). 또는MCODE_PROVIDER_API_KEY를 설정하고 사용자 지정 제공업체를 추가합니다. - 실행 –
cd /path/to/your/project && mcode(대화형) 또는mcode "Fix the failing test"(단일 프롬프트). UI 내 단축키를 사용하세요(Enter로 전송,Alt+Enter로 대기열 추가,Shift+Tab으로 플랜 모드 전환 등).
설치 세부 정보
- 기본 설치 위치:
~/.minimax-code(POSIX) 또는%USERPROFILE%\.minimax-code(Windows). CLI 바이너리는mcode(또는mcode.cmd/.ps1)입니다. - 사용자 데이터(로그인 토큰, 제공업체 구성, 세션 기록)는
~/.minimax(또는MINIMAX_DATA_DIR을 통해 지정된 사용자 지정 디렉터리)에 저장됩니다. - 설치 폴더와 선택적으로
~/.minimax데이터 디렉터리를 삭제하여 제거할 수 있습니다. README에 정확한 셸 명령이 제공됩니다.
소스 빌드
git clone https://github.com/MiniMax-AI/minimax-code.git
cd minimax-code
pnpm install --frozen-lockfile # Node 22‑26 및 pnpm 9.12+ 필요
pnpm build
pnpm mcode # 빌드된 CLI 실행
소스 체크아웃에서 생성된 CLI는 npm 패키지 @minimax-ai/code@0.4.12로 게시된 것과 동일합니다.
문서 및 도움말
- 전체 문서:
docs/README.md - 작업 예시:
docs/examples.md - FAQ / 문제 해결:
docs/installation.md#faq - 이슈: GitHub에서 열어주세요(협력자는 PR을, 그 외에는 이슈를 제출하세요).
라이선스 – 프로젝트 자체 코드는 MIT 라이선스입니다(LICENSE 참조). 타사 종속성은 THIRD_PARTY_NOTICES.md에 나열된 원본 라이선스를 유지합니다.
MiniMax Code는 LLM 기반의 코드 이해, 편집 및 테스트를 터미널로 가져오는 진정한 오픈 소스 AI 코딩 어시스턴트입니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트