첫 에이전트 설정하기

새로 설치한 상태에서 실제로 일하는 AI 에이전트까지. 초보자가 가장 많이 놓치는 두 가지를 맨 위에 두었습니다: AgentsRoom이 AI CLI와 어떤 관계인지, 그리고 로그인하는 방법입니다.

AgentsRoom의 작동 방식 (먼저 읽어 주세요)

AgentsRoom은 조종석입니다. AI CLI(Claude, Codex, GitHub Copilot CLI, Cursor 및 그 외 에이전트 CLI 15개)가 엔진입니다. 각 엔진에는 자체 명령으로 한 번만 로그인하면, 그다음부터 AgentsRoom이 화면에서 엔진을 조종합니다. AgentsRoom은 당신의 토큰, API 키, ChatGPT 비밀번호를 저장하지도 보지도 않습니다: 그 정보는 컴퓨터에 있는 각 CLI의 보안 저장소 안에 그대로 남습니다.

AgentsRoom 안에는 "ChatGPT에 로그인"이나 "Anthropic에 로그인" 버튼이 없으며, 일부러 그렇게 만들었습니다. 로그인은 아래 0단계에서 설치하는 CLI 안에서 이루어집니다.

시작하기 전에

✓Windows 10 이상, macOS 14 이상(Sonoma) 또는 최신 64비트 Linux 배포판
✓
AI 코딩 CLI 하나 이상 설치 (Claude, Codex, GitHub Copilot CLI, Cursor 또는 AgentsRoom이 지원하는 그 외 에이전트 CLI 15개 중 하나)
예: curl -fsSL https://claude.ai/install.sh | bash
✓선택한 프로바이더의 활성 구독 또는 API 키

0단계: AI 엔진 설치 및 로그인

시작할 프로바이더를 하나 고르세요(나중에 더 추가할 수 있습니다). 각 프로바이더마다: CLI를 설치하고, 한 번 실행해 로그인하고, 작동하는지 확인합니다. 그다음 1단계로 넘어가세요.

프로바이더를 클릭하면 설정 단계가 펼쳐집니다.

Claude (Anthropic)처음 사용하는 분께 추천

사용 가능한 플랜

Claude Pro, Claude Max 또는 Anthropic API key.

1. 설치

curl -fsSL https://claude.ai/install.sh | bash

2. 로그인

아무 터미널에서 claude를 한 번 실행하세요. Anthropic 계정으로 로그인할 수 있도록 브라우저 창이 열립니다.

3. 확인

위의 설치 명령을 실행한 다음, 터미널에서 CLI 이름만 입력해 실행하세요(예: "claude"를 입력하고 Enter). 환영 화면이 나타나야 합니다. "hello"를 입력하고 Enter를 누르세요: 답이 돌아오면 AgentsRoom 안에서 쓸 준비가 끝난 것입니다.

Codex (OpenAI / ChatGPT)ChatGPT 계정 사용

사용 가능한 플랜

ChatGPT Plus, Pro, Team 또는 Enterprise, 또는 OpenAI API 키.

1. 설치

curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. 로그인

아무 터미널에서 codex를 한 번 실행하세요. 브라우저 창이 열립니다. chatgpt.com에서 쓰는 것과 같은 ChatGPT 계정으로 로그인하세요.

3. 확인

Antigravity CLI (Google)무료 티어 제공

사용 가능한 플랜

Google 계정(브라우저 로그인). 넉넉한 무료 티어를 사용할 수 있습니다.

1. 설치

curl -fsSL https://antigravity.google/cli/install.sh | bash

2. 로그인

아무 터미널에서 antigravity를 한 번 실행하세요. Google 로그인을 위한 브라우저 창이 열립니다.

3. 확인

OpenCode원하는 공급자 사용

사용 가능한 플랜

구성되는 모든 공급자: Anthropic, OpenAI, OpenRouter 등.

1. 설치

curl -fsSL https://opencode.ai/v2/install | bash

2. 로그인

opencode를 실행한 다음 /connect 명령으로 공급자 키 또는 OpenCode Go 구독을 추가하세요.

3. 확인

Grok Build (xAI)256K 컨텍스트

사용 가능한 플랜

xAI 계정(브라우저 로그인) 또는 헤드리스 사용을 위한 Grok API key.

1. 설치

curl -fsSL https://x.ai/cli/install.sh | bash

2. 로그인

아무 터미널에서나 grok을 한 번 실행하세요. xAI 로그인을 위한 브라우저 창이 열립니다. 헤드리스로 사용하려면 대신 GROK_CODE_XAI_API_KEY 환경 변수를 설정하세요.

3. 확인

Cursor터미널 속 내 에디터

사용 가능한 플랜

Cursor 계정. 이미 쓰고 있는 플랜이 CLI까지 그대로 커버하며, 무료 티어에서는 쓸 수 있는 모델이 더 적습니다.

1. 설치

curl https://cursor.com/install -fsS | bash

2. 로그인

cursor-agent login을 실행해 브라우저에서 로그인하세요. 설정은 ~/.cursor에 있습니다.

3. 확인

oh-my-pi60개 이상 백엔드

사용 가능한 플랜

이미 결제 중인 것을 그대로 사용합니다. Anthropic, OpenAI, Google, xAI, Z.ai, DeepSeek 등에 로그인하거나 일반 API 키를 받습니다.

1. 설치

curl -fsSL https://omp.sh/install | sh

2. 로그인

omp를 한 번 실행한 뒤 /login으로 제공업체를 연결하세요. 설정은 ~/.omp에 있습니다.

3. 확인

Kimi (Moonshot AI)최대 1M 컨텍스트

사용 가능한 플랜

Kimi 계정(브라우저 로그인) 또는 Moonshot AI Open Platform API 키.

1. 설치

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

2. 로그인

터미널에서 kimi를 한 번 실행한 뒤 /login을 입력해 Kimi 계정으로 로그인하세요. 설정은 ~/.kimi-code에 있습니다.

3. 확인

Freebuff키 불필요

사용 가능한 플랜

없습니다. 서비스는 무료이며 턴 사이에 표시되는 텍스트 광고로 운영됩니다.

1. 설치

npm install -g freebuff

2. 로그인

프로젝트에서 freebuff를 실행하세요. Codebuff 계정을 연결하고 싶다면 freebuff login 명령이 있습니다.

3. 확인

Pi (Earendil)미니멀하고 확장 가능

사용 가능한 플랜

이미 결제 중인 것을 그대로 사용합니다. Pi는 Anthropic, OpenAI, Google, GitHub Copilot 등 많은 제공업체에 로그인하거나 일반 API 키를 받습니다.

1. 설치

curl -fsSL https://pi.dev/install.sh | sh

2. 로그인

pi를 한 번 실행한 뒤 /login으로 제공업체를 연결하세요. 설정은 ~/.pi/agent에 있습니다.

3. 확인

Devin플랜 하나로 여러 모델

사용 가능한 플랜

Devin 또는 Windsurf 플랜(무료 티어 포함). 같은 구독으로 Claude, GPT, Gemini와 Cognition의 SWE 모델까지 사용할 수 있습니다.

1. 설치

curl -fsSL https://cli.devin.ai/install.sh | bash

2. 로그인

devin auth login을 실행해 브라우저에서 로그인하세요. 설정은 ~/.config/devin에 있습니다.

3. 확인

Command Code공개 모델과 독점 모델 중 선택

사용 가능한 플랜

Command Code 계정 또는 COMMAND_CODE_API_KEY API 키가 필요합니다. 모델 접근 권한과 사용 한도는 프로바이더 계정에 따라 달라집니다.

1. 설치

npm install -g command-code@latest

2. 로그인

command-code login을 실행해 로그인하거나 환경 변수에 COMMAND_CODE_API_KEY를 설정하세요. 그런 다음 프로젝트에서 command-code를 실행하세요.

3. 확인

Mistral Vibe유럽산 모델

사용 가능한 플랜

Mistral 계정(Pro 또는 Team) 또는 Mistral API key.

1. 설치

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 mistral-vibe

2. 로그인

vibe --setup을 한 번 실행해 Mistral API key를 저장한 다음 vibe를 실행해 시작하세요. 설정은 ~/.vibe/config.toml에 저장됩니다.

3. 확인

Muse Code (Meta)터미널에서 사용하는 Muse Spark

사용 가능한 플랜

Muse Code 접근 권한이 있는 Meta 계정 또는 META_API_KEY API 키가 필요합니다. 접근 권한과 사용 한도는 Meta가 정합니다.

1. 설치

curl -fsSL https://dev.meta.ai/install.sh | sh

2. 로그인

muse login을 실행해 로그인하거나 환경 변수에 META_API_KEY를 설정하세요. 그런 다음 프로젝트에서 muse를 실행하세요.

3. 확인

Aider파워 유저

사용 가능한 플랜

API 키를 통한 모든 프로바이더 (Anthropic, OpenAI, DeepSeek 등).

1. 설치

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 aider-chat

2. 로그인

로그인 명령이 없습니다. 셸 프로필에 API 키를 환경 변수로 설정하세요. 예: export ANTHROPIC_API_KEY=sk-...

3. 확인

Amp (Sourcegraph)모델이 아니라 모드

사용 가능한 플랜

Amp 계정(브라우저 로그인) 또는 AMP_API_KEY 토큰.

1. 설치

curl -fsSL https://ampcode.com/install.sh | bash

2. 로그인

아무 터미널에서나 amp login을 한 번 실행해 로그인하세요. 설정은 ~/.config/amp에 있습니다.

3. 확인

MiniMax Code (MiniMax)M 시리즈 모델

사용 가능한 플랜

MiniMax 계정(브라우저 로그인) 또는 MiniMax API 키.

1. 설치

curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

2. 로그인

터미널에서 mcode login --region global을 실행하세요(중국 본토 계정은 mcode login). 설정은 ~/.minimax에 있습니다.

3. 확인

ZCode (커뮤니티 클라이언트)GLM 모델, Z.ai 제품 아님

사용 가능한 플랜

Z.ai 또는 BigModel 요금제, 또는 API 키. 이 커뮤니티 클라이언트는 Z.ai가 배포하거나 보증하지 않습니다.

1. 설치

npm install -g zcode-app-cli@latest

2. 로그인

터미널에서 zcode를 한 번 실행한 다음 /login을 입력해 Z.ai 또는 BigModel 계정으로 로그인하세요. Node.js 22.19 이상이 필요합니다. 설정은 ~/.zcode에 있습니다.

3. 확인

이 단계에서 막혔나요? 이 페이지 맨 아래의 문제 해결 섹션을 확인하세요.

AgentsRoom 다운로드 및 설치

사용 중인 운영 체제에 맞는 설치 프로그램을 다운로드하세요. macOS는 .dmg, Windows는 .exe, Linux는 AppImage입니다. 파일을 열고 설치 단계를 따른 다음 AgentsRoom을 실행하세요.

Tip: AgentsRoom은 업데이트를 자동으로 확인합니다. 새 버전이 나오면 알림을 받습니다.

첫 번째 프로젝트 만들기

사이드바에서 + 버튼을 클릭합니다. 컴퓨터에 있는 폴더를 아무거나 선택하세요. AI 에이전트가 일할 곳입니다. 프로젝트 이름을 정하고 영역에 배정하세요.

Tip: 각 프로젝트는 실제 폴더 하나에 대응합니다. 에이전트는 그 디렉터리에서 선택한 프로바이더의 CLI를 실행합니다. 당신이 터미널에서 하는 것과 똑같습니다.

첫 에이전트 추가하기

프로젝트 안에서 Add Agent를 클릭합니다. 역할(Fullstack으로 시작하면 좋습니다), 프로바이더(0단계에서 설정한 엔진), 모델(Claude라면 Sonnet 추천)을 차례로 고르세요. 원하면 첫 프롬프트를 쓰고 Launch를 클릭합니다. 터미널이 열리고 CLI가 대신 실행됩니다.

Tip: 터미널이 비어 보이거나 로그인 화면이 나오면, 0단계의 CLI에 아직 로그인하지 않은 것입니다. 일반 터미널을 열어 claude나 codex(또는 사용하는 프로바이더의 명령)를 한 번 실행하고, 로그인을 마친 뒤 돌아오세요.

작업 보기

터미널에 실시간 출력이 표시됩니다. 읽어들이는 파일 하나하나, 수정 하나하나까지. 상태도 함께 바뀝니다. 작업 중, 그리고 완료. 작업이 끝나면 데스크톱 알림을 받습니다.

Tip: 여러 에이전트를 한 번에 실행할 수 있습니다. 각 에이전트는 자기 터미널을 갖고 독립적으로 일합니다.

설정 맞춤화

AgentsRoom에서 CLAUDE.md를 직접 편집해 에이전트에게 더 나은 컨텍스트를 주세요. 모델을 바꾸고, 권한을 조정하고, 훅을 구성하세요. 다른 역할이나 프로바이더로 에이전트를 더 추가하세요.

Tip: 아키텍처에는 Opus. 개발에는 Sonnet. 테스트 같은 빠른 작업에는 Haiku.

팁과 트릭

1.아키텍처 결정에는 Opus, 일상적인 코딩에는 Sonnet, 빠른 작업에는 Haiku를 쓰세요

2.더 잘 정리하려면 프로젝트를 영역별로 묶으세요 (Work, Personal, Side-projects)

3.AgentsRoom에서 CLAUDE.md를 편집해 에이전트에게 더 나은 프로젝트 컨텍스트를 주세요

4.데스크톱 알림을 켜 두면 에이전트가 일하는 동안 다른 일을 할 수 있습니다

5.프로젝트당 에이전트 하나로 시작하고, 익숙해지면 늘리세요

문제 해결

에이전트 터미널이 비어 있거나 멈춘 것 같아요

대부분의 경우 CLI에 로그인되어 있지 않은 것이 원인입니다. 터미널(macOS는 Terminal, Windows는 PowerShell 또는 Windows Terminal, Linux는 사용 중인 터미널 에뮬레이터)을 열고 CLI 명령을 단독으로 실행한 후(claude, codex, antigravity, opencode), 브라우저에서 로그인을 완료한 다음 AgentsRoom으로 돌아가 에이전트를 다시 실행하세요. AgentsRoom에는 자체 로그인 화면이 없으며, 인증은 CLI에서 처리됩니다.

command not found: claude (또는 codex, antigravity 등)

CLI가 설치되지 않았거나, 셸의 PATH가 CLI를 찾지 못하는 것입니다. 위의 0단계 설치 명령을 다시 실행하세요. nvm을 쓴다면 평소에 쓰는 것과 같은 Node 버전으로 CLI를 설치하세요. 그렇지 않으면 AgentsRoom이 실행될 때 바이너리가 PATH에 없습니다.

AgentsRoom 안에서 ChatGPT나 Claude에 로그인하는 버튼이 보이지 않아요

일부러 그렇게 만들었습니다. AgentsRoom은 CLI 위에 얹힌 UI이고, 자격 증명을 직접 다루지 않습니다. 로그인은 CLI 안에서 한 번만 하면 되고(터미널에서 claude나 codex 실행), 그다음 AgentsRoom이 그 세션을 사용합니다. 그래서 AgentsRoom은 토큰을 가로채는 도구보다 안전합니다.

에이전트가 "thinking"에서 멈춰 있어요

선택한 프로바이더의 구독이나 API 키가 활성 상태인지 확인하세요. 터미널에서 CLI를 직접 실행해 보면 실제 오류 메시지를 볼 수 있습니다: Claude나 OpenAI가 가끔 아무 표시 없이 속도를 제한하거나 세션을 만료시킵니다.

사이드바에 프로젝트가 보이지 않아요

프로젝트를 만들 때 유효한 폴더를 선택했는지 확인하세요. 폴더가 디스크에 실제로 있어야 합니다. 프로젝트를 추가했는데 아직 보이지 않는다면 AgentsRoom을 다시 시작하세요.

CLI를 설치했는데 AgentsRoom이 여전히 "command not found"라고 해요

AgentsRoom은 대화형 터미널이 아니라 로그인 셸에서 PATH를 물려받습니다. AgentsRoom을 완전히 종료하고, 새 터미널을 열어, 새 셸 세션에서 CLI를 부를 수 있는지 확인한 다음(which claude), AgentsRoom을 다시 실행하세요.