XTERM Terminal Setup Guide
각 학습자에게는 개인 서버, Node-RED 실습 및 사전 설치된 Google Gemini CLI이 제공됩니다. API 키를 보호하고 터미널에 붙여넣은 다음 빠른 채팅 메시지를 보내고 AI 보조자가 연결되었는지 확인하세요. 이 페이지의 단계를 완료한 후 이 활동 상단에 있는 완료 버튼을 사용하여 다음 미션을 잠금 해제하세요.
- 개인 AI 서버(채팅 및 음성 모드의 WebTerminal 포함) + 영구 저장소
- Gemini + Claude CLI 사전 설치됨(AI Cloud Bot 모드)
- 개인용 Node-RED 자동화 스택
- 메시징 서랍에서 터미널 로그인 확인(
admin자격 증명) - Gemini API 키를 생성합니다. aistudio.google.com 터미널에 붙여 넣기
- 스타터 Node-RED 흐름을 빌드하려면 Gemini을 주문하세요.
WebTerminal(VNC + XTerm) 또는 Node-RED 자격 증명이 다시 필요합니까? 오른쪽 상단에 있는 말풍선 아이콘을 클릭하세요. 메시지 창 전환 — 관리 메시지에는 모든 URL과 비밀번호가 포함됩니다. 도움이 필요하면 언제든지 답장을 보내주세요.
메시지를 열고 관리자로 로그인한 후 Gemini 채팅이 준비되었는지 확인하세요.
AI Studio에서 키를 생성하고 터미널에 붙여넣은 다음 Enter를 누릅니다(키보드 또는 터미널 Enter 버튼).
간단한 인사말(예: test)을 보내고 Gemini 회신을 확인합니다.
4단계에서 준비된 프롬프트를 사용합니다. 복사하여 Gemini 채팅에 붙여넣은 다음 Enter(키보드 또는 터미널 Enter 버튼)를 누릅니다.
아래의 모든 항목이 완료되면 이 활동 상단에 있는 완료 버튼을 사용하여 시스템에서 다음 코스 레벨과 과제를 잠금 해제하세요.
채팅 우선 인터페이스: 일반 영어를 작성하고 Gemini이 서버에서 실행을 처리합니다.
Gemini은 흐름이 준비되면 알려줍니다. 그런 다음 Reload을 클릭하고 캔버스 업데이트를 확인합니다.
1단계 · 먼저 단말기 접속 확인
메시지 서랍에서 시작하세요. API 키를 생성하기 전에 터미널을 사용할 수 있고 성공적으로 로그인할 수 있는지 확인하세요.
- 메시지 서랍(말풍선)을 열고 두 개의 관리 메시지(Node-RED 자격 증명, WebTerminal is ready)를 기다립니다.
- WebTerminal is ready 다음에 메시지에서 터미널 자격 증명(
admin+ 비밀번호)을 복사합니다. - 페이지를 새로 고치고(F5) 터미널에 로그인한 후 다음 세션을 위해 브라우저에 자격 증명을 저장하세요.
- 터미널 프레임이 로드되지 않으면 ↗ Open in new tab을 클릭하고 계속 진행하세요.
- Gemini 채팅이 나타나고 API 키 활성화를 요청하면 2단계로 이동하세요.
2단계 · API 키 생성 및 Gemini 활성화
이제 Google AI Studio에서 키를 생성하고 이를 터미널 채팅에 붙여넣으면 Gemini이 서버에서 작업을 시작할 수 있습니다.
- 열려 있는 Google AI Studio → API 키.
- 메시지가 표시되면 Google 약관/licenses에 동의하세요.
- 기존 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
- Create API key을 클릭한 다음 생성된 키를 복사합니다.
- 터미널로 돌아가 마우스 오른쪽 버튼 클릭 메뉴 또는
Ctrl+Shift+V을 사용하여 키를 붙여넣습니다. - Enter를 누르고 확인을 기다립니다(예:
Gemini API 키가 저장됨).
3단계 · 채팅 확인 및 할당량 한도 처리
Gemini은 채팅 모드에서 실행됩니다. 멘토와 대화하는 것과 같은 방식으로 대화하세요. 명령 구문이 필요하지 않습니다.
당신이 본다면
API 오류: 이 모델의 일일 할당량이 소진되었습니다. 
그런 다음 터미널 설정을여십시오 /settings 미리보기 기능 = ON인지 확인하세요.
다음으로 모델 선택기를 엽니다. /model.
수동 모드를 선택하고 gemini-3-flash-preview을 선택합니다. "향후 세션을 위한 모델 기억"을 활성화합니다.
메시지를 다시 시도하세요. 한도가 다시 나타나면 5분 정도 기다립니다. 그래도 실패하면 일일 한도(RPD)에 도달했을 가능성이 높으며 최대 24시간을 기다려야 할 수도 있습니다.
다른 Google Cloud 프로젝트/API 키로 전환하거나 여기에서 도움을 요청할 수도 있습니다. https://t.me/sell_systems
필요한 경우 더 높은 요금 한도를 잠금 해제하도록 결제를 설정하세요.
여전히 도움이 필요한 경우 여기에서 관리자에게 문의하세요. https://t.me/sell_systems
대체 복구 경로: 새 프로젝트 또는 새 API 키를 사용합니다.
| 문제 | 고치다 |
|---|---|
| "잘못된 API 키" | AI Studio에서 키를 삭제하고 → 새 키를 만들고 → 다시 붙여넣습니다. |
| 터미널이 응답하지 않음 | Reload을 누르고 10초 동안 기다린 후 메시지를 반복하세요. |
| 네트워크 문제 | Wi-Fi/VPN을 복원하고 페이지를 새로 고친 후 다시 시도하세요. |
4단계 · 시작 흐름 시작
이제 아래 준비된 미션 프롬프트를 사용하세요. 복사하여 Gemini 채팅에 붙여넣고 Enter(키보드 또는 터미널 Enter 버튼)를 누르고 실행을 감독하세요. 이것은 귀하의 첫 번째 소규모 자동화입니다.
이것을 터미널에 붙여넣은 다음 Enter를 누르십시오(또는 자신의 말로 말하십시오).
가이드를 수동으로 검사해야 합니까? 새 탭에서 스타터 README를 엽니다. 동일한 단계를 따르세요.
✦ Gemini은 작동하는 동안 진행 상황을 보고합니다. 질문에 답하고 프롬프트를 확인한 후 흐름이 준비되었다는 메시지가 나타나면 Reload를 클릭하여 Node-RED의 변경 사항을 검토하세요. 확실하지 않은 점이 있으면 후속 메시지를 보내거나 관리자에게 문의하세요. 모든 권한은 귀하에게 있습니다.
예상 출력은 다음과 같습니다. 
Gemini은 일반적으로 모든 것이 완료되면 다음과 같이 응답합니다.
GitHub 템플릿이 확장되면 여기에 더 많은 고급 프롬프트가 추가됩니다.
Gemini은 명령 실행 권한을 요청할 수 있습니다(예: ls ). Gemini이 환경을 검사할 수 있도록 이러한 프롬프트를 승인하세요. 귀하는 교환원으로 남아 각 작업을 확인합니다.
메시지 창(오른쪽 상단 말풍선)을 사용하여 관리자 지침을 검토하거나 도움을 요청하세요. WebTerminal 자격 증명, Node-RED URL, 추가 힌트 등 모든 것이 여기에 있습니다. 아니면 여기에 물어보세요 https://t.me/sell_systems
다음 부분을 볼 준비가 되셨나요? 이 활동 상단에 있는 완료 버튼을 사용하세요.
