How to set up MetaMask Agent Wallet and make your first trade

MetaMask Agent Wallet 설정은 세 단계로 완료됩니다. mm CLI를 설치하고, AI 에이전트에 스킬을 추가한 다음, 프롬프트 하나를 붙여넣으면 됩니다. 에이전트가 로그인 방법 선택과 보안 설정 구성을 안내해 드립니다. 지갑에 자금을 입금하면 일반 언어로 요청하는 것만으로 토큰을 스왑할 수 있습니다. Perps와 예측 시장은 별도의 자금 조달 단계가 있으며, 각 가이드에서 다루고 있습니다. 이 가이드는 공식 퀵스타트를 따라 설치부터 첫 거래까지 안내합니다.

이 문서는 설정 가이드이며, 개념 설명서가 아닙니다. 에이전틱 지갑이 무엇인지 알고 싶다면 에이전틱 지갑이란을 참고하세요. 트랜잭션 라이프사이클과 보안 파이프라인의 작동 방식은 에이전틱 지갑의 작동 원리와 에이전틱 지갑 보안을 참고하세요.

시작하기 전에

다음이 필요합니다:

• Node.js 22.18 이상. node --version으로 확인하세요.

• Claude Code, Codex, Cursor, OpenClaw, Hermes Agent 등 스킬을 지원하는 AI 에이전트. (스킬이 없으신가요? 3단계에서 터미널 전용 경로를 안내합니다.)

• 다른 지갑이나 거래소에서 전송할 수 있는 자금.

1단계: CLI 설치

mm CLI는 에이전트가 로그인하고, 잔액을 확인하고, 트랜잭션을 전송하는 데 사용됩니다.

npm install -g @metamask/agent-wallet@latest

Yarn, pnpm, Bun도 사용 가능합니다(동일한 패키지로 yarn global add, pnpm add -g, 또는 bun add --global). 설치 후 mm doctor를 실행하여 CLI 버전과 스킬 호환성을 확인하세요. 2단계 전까지는 누락된 스킬에 대한 힌트가 표시되는 것이 정상입니다.

2단계: 에이전트에 스킬 추가

스킬은 에이전트에게 어떤 mm 명령을 실행할지, 그리고 자금 이동 전에 언제 확인을 요청할지 알려줍니다.

npx skills add MetaMask/agent-skills

3단계: 프롬프트 하나로 설정 시작

에이전트를 열고 다음을 붙여넣으세요:

Set up MetaMask Agent Wallet: help me pick a sign-in method, wallet mode, and trading mode, then show my address.

에이전트가 원하는 로그인 방법을 묻고 설정 명령을 실행합니다. 다음 두 단계에서 에이전트가 묻는 선택 사항을 다룹니다.

터미널을 선호하거나 스킬 없이 에이전트를 실행하시나요? mm doctor, mm login, mm init을 순서대로 실행한 다음 mm doctor를 다시 실행하세요. CLI 설정 가이드에서 각 명령을 다루고 있습니다.

4단계: 하나의 방법으로 로그인하고 계속 사용하기

Google, 이메일, MetaMask Mobile QR은 각각 다른 서버 지갑 주소를 불러옵니다. 이메일과 Google 로그인에 동일한 주소를 사용하더라도 마찬가지입니다(Mobile QR을 선택하면 이메일 주소가 사용되지 않습니다). 하나의 방법을 선택하여 매번 동일하게 사용하고, 로그인할 때마다 mm wallet address를 실행하여 자금을 입금한 주소를 확인하세요.

Google 또는 이메일의 경우, 에이전트가 브라우저에서 Agent Wallet 대시보드를 엽니다. 로그인하고 Authorize를 클릭한 다음, 안내가 표시되면 브라우저에서 CLI 토큰을 복사하여 터미널에 붙여넣으세요. 이메일 로그인 시 받은 편지함의 인증 코드가 추가로 필요합니다. Authorize를 클릭하기 전에 브라우저에 입력하세요. 이 코드는 CLI 토큰이 아니므로 터미널에 붙여넣지 마세요.

MetaMask Mobile QR의 경우, 에이전트가 터미널에 QR 코드를 표시합니다. MetaMask Mobile을 열고 코드를 스캔한 다음 앱에서 연결을 승인하세요.

5단계: 지갑 모드와 거래 모드 선택

에이전트가 자금 보관 방식을 묻습니다:

직접 지갑을 가져오는 경우, 명령줄에 구문을 직접 입력하는 대신 MM_MNEMONIC 환경 변수를 설정하세요:

export MM_MNEMONIC = ""

서버 지갑을 사용하는 경우, 에이전트가 거래 모드도 묻습니다:

Guard Mode는 대부분의 사용자에게 권장되는 선택입니다. 나중에 mm wallet trading-mode set guard 또는 mm wallet trading-mode set beast로 모드를 변경할 수 있습니다. 가드레일별 전체 비교는 거래 모드를 참고하세요.

6단계: 지갑에 자금 입금

설정이 완료되면 에이전트가 지갑 주소를 표시합니다. 예상한 주소와 일치하는지 확인한 다음 다른 지갑이나 거래소에서 자금을 전송하세요. 언제든지 에이전트에게 요청할 수 있습니다:

Show my wallet address and balance.

전송 전에 알아두어야 할 두 가지:

• 잔액은 체인별로 구분됩니다. 거래할 체인에 자금을 입금하세요. mm chains list를 실행하면 지원 네트워크와 각 네트워크에서 지원하는 기능(스왑, 예측, perps)을 확인할 수 있습니다.

• 체인의 커버리지를 확인하세요. 지원 체인 목록의 Transaction Shield 열에 "No"로 표시된 체인에서는 위협 스캔을 사용할 수 없습니다. Ethereum, Base, Arbitrum, Optimism, Polygon은 커버리지가 적용되는 체인에 포함됩니다.

첫 번째 트랜잭션 전에 mm doctor를 실행하여 authenticated와 initialized 모두 true로 표시되는지 확인하세요. 하나라도 false이면 출력의 힌트를 따른 다음 다시 실행하세요.

7단계: 첫 거래하기

에이전트에게 소액 스왑을 요청하세요:

Swap 0.01 ETH to USDC on Base.

에이전트가 견적을 가져오고 경로와 출력을 보여준 다음, 확인 후 실행합니다. 부담 없이 먼저 연습해 보고 싶다면 "What's my USDC balance?" 또는 "What's the current price of ETH?"를 요청해 보세요. 읽기 전용 요청은 확인 프롬프트 없이 실행됩니다.

Guard Mode는 초기에 두 곳에서 입력을 요청합니다. 첫 번째 트랜잭션 시 24시간 롤링 출금 한도를 설정하도록 안내하며, 허용 목록이나 한도를 벗어나는 항목은 2단계 인증 승인을 위해 일시 중지됩니다. 플래그가 지정된 트랜잭션은 응답할 때까지 에이전트가 진행할 수 없습니다. Google 또는 이메일로 로그인한 경우 승인은 이메일 링크로, QR을 사용한 경우 MetaMask Mobile 푸시 알림으로 전송됩니다(푸시 알림이 표시되지 않으면 알림 메뉴를 확인하세요).

설정이 중단된 경우

mm doctor부터 시작하세요. 로그인 및 초기화 여부를 보고하며, 힌트를 통해 수정 방법을 안내합니다. 일반적인 오류 코드:

문제 해결 페이지에서 더 많은 사례를 다루고 있습니다.

다음 단계

첫 거래가 완료되면 자산 유형을 선택하세요. Hyperliquid에서의 레버리지 포지션은 MetaMask Agent Wallet로 Perps 거래하는 방법을 참고하세요. 동일 체인 스왑과 크로스체인 브리지는 토큰 스왑 및 브리지 방법을 참고하세요. Polymarket은 예측 시장 거래 방법을 참고하세요. 문서에서는 수익 볼트와 x402 결제도 다루고 있습니다.