설치 가이드

메이커링크를 시작하기 위한 설치 과정을 안내합니다.

개요

메이커링크는 웹 터미널과 데스크톱 에이전트 두 부분으로 구성됩니다.

구성 요소	설명	필수 여부
웹 터미널	브라우저에서 접속하는 원격 터미널	자동 (웹 접속)
데스크톱 에이전트	원격 접속할 PC에 설치하는 앱	필수 설치

1단계: 회원가입 및 로그인

1. 메이커링크 웹사이트에 접속합니다.
2. 회원가입 버튼을 클릭하여 계정을 생성합니다.
3. 이메일과 비밀번호로 로그인합니다.

2단계: API Key 발급

1. 로그인 후 설정으로 이동합니다.
2. API Key 설정 섹션에서 API Key 발급 버튼을 클릭합니다.
3. 생성된 API Key를 복사합니다.

주의

API Key는 발급 시 한 번만 전체가 표시됩니다. 안전한 곳에 저장해두세요.

3단계: 데스크톱 에이전트 설치

macOS

1. 에이전트 다운로드 페이지에서 macOS 탭을 선택하고 .dmg 파일을 다운로드합니다.
2. 다운로드한 .dmg 파일을 열고 Maker Link 앱을 Applications 폴더로 드래그합니다.
3. 앱을 실행하면 상단 메뉴바(시스템 트레이)에 메이커링크 아이콘이 나타납니다.

macOS 보안 경고

처음 실행 시 "확인되지 않은 개발자" 경고가 나타나면, 시스템 설정 → 개인 정보 보호 및 보안에서 "확인 없이 열기"를 선택하세요. 메이커링크 에이전트는 Apple 공증이 완료된 앱입니다.

Windows

1. 에이전트 다운로드 페이지에서 Windows 탭을 선택하고 .exe 설치 파일을 다운로드합니다.
2. 다운로드한 .exe 파일을 실행하고 설치 마법사의 안내에 따라 설치합니다.
3. 설치가 완료되면 에이전트가 자동으로 시작되고, 시스템 트레이(작업 표시줄 오른쪽)에 메이커링크 아이콘이 나타납니다.

Windows SmartScreen 경고

설치 시 "Windows가 PC를 보호했습니다" 라는 파란색 경고창이 나타날 수 있습니다. 이는 앱에 Microsoft 코드 서명 인증서가 아직 적용되지 않아 발생하는 정상적인 경고입니다.

해결 방법:

1. 경고창에서 "추가 정보" 텍스트를 클릭합니다.
2. "실행" 버튼이 나타나면 클릭하여 설치를 진행합니다.

이 과정은 최초 설치 시 한 번만 필요하며, 이후 자동 업데이트에는 영향을 주지 않습니다.

지원 셸

• macOS: zsh (기본), bash
• Windows: PowerShell (기본), CMD

4단계: 에이전트 설정

1. 시스템 트레이의 메이커링크 아이콘을 클릭합니다.
2. 설정 메뉴를 선택합니다.
3. 2단계에서 복사한 API Key를 붙여넣고 저장합니다.
4. 연결 상태가 연결됨으로 표시되면 완료입니다.

5단계: 터미널 접속

1. 웹 브라우저에서 터미널 페이지로 이동합니다.
2. 에이전트가 연결되면 ✅ 에이전트가 성공적으로 연결되었습니다! 메시지가 표시됩니다.
3. 터미널에서 명령어를 입력하면 에이전트가 설치된 PC에서 실행됩니다.

팁

프롬프트 빌더에서 자주 사용하는 명령어를 저장해두면 한 번의 클릭으로 터미널에 전송할 수 있습니다.

문제 해결

에이전트가 연결되지 않아요

• API Key가 올바르게 입력되었는지 확인하세요.
• 방화벽에서 메이커링크 에이전트를 허용했는지 확인하세요.
  • macOS: 시스템 설정 → 네트워크 → 방화벽에서 Maker Link를 허용
  • Windows: Windows 방화벽 → 앱 허용에서 Maker Link를 체크
• 에이전트 앱을 재시작해보세요.

터미널에 아무것도 표시되지 않아요

• 웹 페이지를 새로고침해보세요.
• 에이전트의 연결 상태를 확인하세요.
• 브라우저의 개발자 도구(F12)에서 콘솔 오류를 확인하세요.

Windows에서 PowerShell 한글이 깨져요

에이전트가 자동으로 UTF-8 인코딩을 설정하지만, 시스템 설정이 다를 경우:

• 시스템 설정 → 시간 및 언어 → 관리 → 시스템 로캘 변경에서 "UTF-8 사용"을 체크하세요.
• 또는 PowerShell 프로필에 [Console]::OutputEncoding = [Text.Encoding]::UTF8을 추가하세요.