Melso Docs

AI 코딩 도구 설치

지원되는 AI 코딩 도구를 설치하고 로그인해 Melso가 로컬에서 태스크를 실행하게 합니다.

로컬 런타임은 Melso 데몬과 데몬이 호출할 수 있는 AI 코딩 도구 하나, 두 부분으로 구성됩니다. 사용할 도구만 설치하면 되며 모든 도구를 설치할 필요는 없습니다.

1. 도구 선택

이미 설치되어 로그인된 도구에는 추가 설정이 필요 없습니다. 도구마다 모델, MCP, 세션 복원, 스킬 지원이 다릅니다. 자세한 차이는 AI 코딩 도구 비교를 참고하세요.

Melso는 현재 다음 명령을 감지합니다.

도구감지하는 명령공식 설치 안내
Antigravity CLIagyAntigravity 설치 및 로그인
Claude CodeclaudeClaude Code 빠른 시작
CodeBuddy CodecodebuddyCodeBuddy 빠른 시작
Codex CLIcodexCodex CLI
GitHub Copilot CLIcopilotCopilot CLI 설치
Cursor Agentcursor-agentCursor CLI 설치
DeepSeek HarnessdshDeepSeek Harness
DevEco CodedevecoDevEco Code
Grok BuildgrokGrok Build 빠른 시작
Hermes AgenthermesHermes 빠른 시작
Kimi CLIkimiKimi CLI
Kiro CLIkiro-cliKiro CLI 설치
OpenClawopenclawOpenClaw 설치
OpenCodeopencodeOpenCode 빠른 시작
Pi coding agentpiPi coding agent
Oh-My-PiompOh-My-Pi 설치
Qoder CLIqodercliQoder CLI 빠른 시작
Qoder CN CLIqoderclicnQoder CN CLI 빠른 시작
Qwen CodeqwenQwen Code
QwenPawqwenpawQwenPaw
ReasonixreasonixReasonix
TRAE CLItraecliTRAE 공식 사이트

"지원됨"은 Melso가 해당 CLI를 호출할 수 있다는 뜻이며 Melso가 도구의 계정, 구독, 모델 사용량을 제공한다는 뜻은 아닙니다.

2. 로컬에서 로그인 완료

설치 후 터미널에서 도구를 한 번 직접 실행하고 도구 자체의 절차에 따라 로그인하거나 모델 서비스를 설정합니다. 터미널에서 요청을 완료하지 못하면 데몬이 호출할 때도 실패합니다.

Reasonix를 사용할 때는 데몬을 시작하기 전에 reasonix setup을 실행해 기본 공급자와 모델을 설정하세요.

QwenPaw를 사용할 때는 QwenPaw 자체 설정에서 공급자와 모델을 선택하세요. Melso는 실행 시 QwenPaw의 모델을 덮어쓸 수 없습니다.

DeepSeek Harness를 사용하려면 Node.js 20+를 설치하고 npm install -g @deepseek-ai/dsh를 실행한 뒤 Melso 런타임 프로필을 추가하세요(dsh plugin --profile multica add <bundle>). 데몬은 dsh --profile multica --probe가 성공한 경우에만 DeepSeek Harness를 등록합니다. 데몬을 시작하기 전에 DEEPSEEK_API_KEY를 설정(또는 dsh 자체 설정에 저장)하세요.

로그인 자격 증명은 도구가 로컬에 저장합니다. Melso는 Claude, Codex, Cursor 또는 다른 CLI의 로그인 token을 받지 않습니다.

Claude Code는 2.0.0 이상, Codex는 0.100.0 이상, Copilot은 1.0.0 이상, Grok은 0.2.89 이상, Qwen Code는 0.20.0 이상이 필요합니다. 최소 버전보다 낮으면 데몬이 해당 런타임을 등록하지 않습니다.

3. 데몬이 명령을 찾을 수 있는지 확인

macOS, Linux 또는 WSL에서 실행합니다.

command -v <command>
<command> --version

Windows PowerShell에서 실행합니다.

Get-Command <command>
<command> --version

<command>를 표에 있는 claude, codex, cursor-agent 같은 명령으로 바꾸세요. 첫 명령이 실행 파일 경로를 반환합니다.

터미널에서는 도구를 찾지만 Desktop이나 백그라운드 데몬에서는 찾지 못한다면 보통 서로 다른 PATH를 사용하기 때문입니다. 앱을 다시 시작하거나 해당 MULTICA_<PROVIDER>_PATH 환경 변수로 절대 경로를 지정할 수 있습니다. 전체 설정은 환경 변수를 참고하세요.

4. 다시 감지하고 온라인 상태 확인

CLI로 데몬을 시작합니다.

melso daemon start

데몬이 이미 실행 중이고 새 도구를 설치했다면 다시 시작합니다.

melso daemon restart

Melso Desktop을 사용한다면 앱을 종료한 뒤 다시 열면 됩니다.

그런 다음 Melso의 런타임 페이지를 엽니다. 대상 컴퓨터 아래에 해당 도구가 나타나고 온라인으로 표시됩니다. 이제 에이전트를 만들거나 수정할 때 이 런타임을 선택할 수 있습니다.

데몬이 시작될 때 기본 지원 CLI를 하나 이상 감지해야 합니다. 사용자 지정 런타임 설정은 데몬이 시작된 뒤 동기화되므로 빈 컴퓨터에서 유일한 시작 조건으로 사용할 수 없습니다.

도구가 감지되지 않을 때

다음 순서로 확인하세요.

  1. 터미널에서 도구 자체를 실행해 설치와 로그인이 모두 완료되었는지 확인합니다.
  2. command -v 또는 Get-Command로 실제 명령 이름과 경로를 확인합니다.
  3. melso daemon logs -f를 실행해 버전, 경로, 인증 오류를 확인합니다.
  4. 데몬을 다시 시작해 현재 환경을 다시 읽게 합니다.
  5. 런타임 페이지로 돌아가 컴퓨터와 도구가 모두 온라인인지 확인합니다.

도구가 온라인으로 표시되지만 실행이 계속 실패한다면 이슈의 실행 기록에서 CLI가 반환한 구체적인 오류를 확인하거나 문제 해결을 계속 읽어 보세요.

다음 단계