O-MACS · 오-맥스 사용법

O-MACS · 오-맥스 사용법

PC에 설치를 마친 뒤의 조작법입니다. 연결 → 화면 → 지시 → 지켜보기 → 늘리기 → 설정 → 업데이트 순서로 읽으면 됩니다.

1. 연결하기 — 연결 코드와 PIN 번호

  1. 설치가 끝나면 PC 브라우저에 모바일 기기 연결 페이지(QR)가 열립니다. 모바일 기기 카메라로 QR을 찍으면 허브가 열립니다. 모바일 앱에서는 O-MACS 연결 코드(내려받기 화면과 설치 완료 보고서에 있는 영문 2자 + 숫자 6자)를 넣습니다. 잊었으면 PC의 Claude Code에 "O-MACS 연결 코드 알려줘"라고 하십시오. 모바일 앱을 받는 법은 8절에 있습니다.
  2. 위쪽에 PC 탭이 생깁니다. 처음 열 때 PIN 번호(설치 완료 보고서에 있는 숫자, 기본 4자리)를 한 번 넣습니다. 그다음부터는 묻지 않습니다.
  3. PC 탭이 열리면 채널 목록과 AI 탭이 보입니다. 이제 준비 끝입니다.
모바일 앱 첫 화면 — O-MACS 연결 코드를 넣는 칸
모바일 앱 첫 화면 — O-MACS 연결 코드를 넣는 칸
PC 탭을 처음 열 때 PIN 번호를 묻는 창
PC 탭을 처음 열 때 PIN 번호를 묻는 창

PIN 번호를 5번 틀리면 1분, 20번 틀리면 1시간 동안 잠깁니다. PIN 번호를 잊었다면 PC의 Claude Code에 "PIN 번호 알려줘"라고 하십시오. PC가 꺼져 있거나 O-MACS 콘솔이 멈춰 있으면 연결되지 않습니다.

2. 화면 구성

지시하려면 PC → 채널 → AI 순서로 고른 뒤 입력창에 지시를 넣습니다. 화면은 위에서 아래로 이렇게 되어 있습니다. 이 문서에서 탭은 눌러서 고르거나 화면을 여는 것(PC 탭 · AI 탭 · 도구 탭 · 사용 설명서 탭), 버튼은 눌러서 일을 실행하는 것(⚙ · [받기] · [업데이트] · ■ 정지)입니다.

맨 위 줄
왼쪽 ⓘ를 누르면 정보 · 업데이트 실행 · 업데이트 소식 · 공지사항 구역이 열립니다. 정보 구역의 「O-MACS 사용법」 카드는 이 문서를, 「AI-CLI의 장점」 카드는 장점 정리 페이지를 엽니다. 새 공지나 새 버전이 있으면 빨간 숫자가 붙습니다(8절). 가운데는 화면 이름(One-stop Multi AI-CLI Console System)이고, 누르면 종합 상황판이 열립니다(모바일 앱과 허브는 맨 위 제목을 누릅니다). 오른쪽 ⚙는 설정(7절)입니다.
PC 탭
PC1~PC4 탭을 눌러 들어갈 PC를 고릅니다. 별명을 정했으면 「PC1 · 사무실」처럼 붙습니다. 켜져 있는 PC는 초록 점입니다. PC가 꺼지면 초록 점은 보통 수십 초 안에 꺼지고, 자리가 회색(설치 전)으로 바뀌는 것은 최대 약 7분입니다. 처음 설치한 PC에는 HQ 표시가 붙습니다.
채널 목록
PC 탭 아래 왼쪽에 지금 채널 이름이 보이고, 옆의 ▾를 누르면 채널(프로젝트) 목록이 펼쳐집니다. 맨 위에는 홈 채널(O-MACS1 등)이 고정되어 있고 「홈」「PC창」 배지가 붙습니다. 채널 줄 오른쪽에는 ⚙(채널별 설정, 7절)와, 붙여 둔 도구가 있으면 파란 도구 탭(6절)이 있습니다. 홈 채널 화면에서는 채널 이름 오른쪽의 사용 설명서 탭으로 설명서를 바로 엽니다.
AI 탭
Claude Code · Codex · Antigravity · Grok Build · Muse Code 다섯 개이고, Muse Code 탭(파랑)은 Muse Code가 설치된 PC에서 나타납니다. 고른 탭의 AI에게 지시가 바로 갑니다. AI에 문제가 생기면 그 탭이 「점검 중 — 다른 AI에게 맡겨 주세요」(빨강)로 바뀝니다.
상태 줄
AI 탭 아래 한 줄입니다. 왼쪽은 AI 상태(초록 대기 · 주황 작업 중 · 빨강 점검 중), 가운데는 잔여 한도 5H · 7D(Claude Code · Codex 구독의 5시간 · 7일 남은 %입니다. Grok Build는 주간 7D만 보이고 5H 자리에 「제한 없음」이 나오며, Antigravity와 Muse Code는 빈칸이 정상), 오른쪽은 ■ 정지 버튼(5절)입니다.
대화창
내가 보낸 지시는 오른쪽 파란 칸, AI의 답은 왼쪽에 그 AI 색의 세로 줄과 함께 나옵니다. 다른 PC · 다른 채널이 보낸 지시는 연한 노란 바탕에 「↪ PC 번호 · PC 이름 · 채널 이름」이 붙습니다. AI 답 첫 줄에는 「Claude Code (Sonnet 5.5/xhigh)」처럼 모델과 추론 강도가 나옵니다. AI-CLI가 일하는 동안 대화창 아래에 나타나는 「AI 실시간 작업 화면」은 5절에 있습니다.
입력창
둥근 카드 하나입니다. 왼쪽 아래 [+]는 사진 · 파일 올리기, 오른쪽 [마이크]는 음성 입력, [↑]는 보내기입니다. 모바일 기기에서는 Enter 키가 줄바꿈이고 보내기는 [↑]로 합니다. PC 브라우저에서는 Enter 키가 보내기, Shift+Enter가 줄바꿈입니다.

모바일 앱과 브라우저의 차이

O-MACS는 세 곳에서 엽니다: 모바일 앱(안드로이드), 모바일 브라우저(아이폰 등 앱이 없는 기기 포함), PC 브라우저. 화면과 조작은 같고, 다른 것은 아래뿐입니다.

들어가는 법
모바일 앱은 처음 한 번 O-MACS 연결 코드를 넣습니다. 브라우저는 QR이나 허브 주소로 엽니다. 어느 쪽이든 PC 탭을 처음 열 때 PIN 번호를 한 번 넣습니다(1절).
작업 끝 알림
모바일 앱에서만 받습니다. 브라우저 설정에는 이 항목이 없습니다(5절).
Enter 키
모바일 앱 · 모바일 브라우저는 줄바꿈, PC 브라우저는 보내기입니다.
음성 입력
모바일 앱은 기기의 음성 인식을 사용합니다. 브라우저는 그 브라우저가 음성 입력을 지원할 때만 기본 방식이 되고, 지원하지 않으면 ⚙ 설정 › 음성 인식 방식에서 정확 · 매우정확(OpenAI API 키 필요)을 고릅니다.
ⓘ의 문서 카드
「O-MACS 사용법」 · 「AI-CLI의 장점」 카드를 누르면 브라우저는 새 창으로, 모바일 앱은 기기의 브라우저로 엽니다.
모바일 앱 받기
안드로이드 모바일 브라우저로 들어오면 맨 위에 ⓘ → 「모바일 앱」에서 받을 수 있다는 안내가 한 줄 뜹니다(✕로 닫으면 다시 뜨지 않습니다). 아이폰 · 태블릿 · PC에는 모바일 앱이 없습니다(8절).

대화를 아래로 넘기면 채널 줄과 PC 탭 줄이 접혀 화면이 넓어지고, 위로 넘기면 다시 펴집니다. AI 탭 줄과 상태 줄은 접히지 않습니다.

3. 일 시키는 법 — 좋은 지시 예시 10개

말로 시키면 됩니다. 잘 되는 지시에는 세 가지가 들어 있습니다: 무엇을, 어디에(어느 파일·폴더), 결과를 어떻게 줄지.

입력창에 지시를 적은 모습 — [↑]로 보냅니다
입력창에 지시를 적은 모습 — [↑]로 보냅니다
  1. 이 폴더의 엑셀 파일을 전부 합쳐서 월별 합계 시트가 있는 합계.xlsx 로 만들어줘.
  2. 회의록.txt 를 읽고 할 일만 뽑아 오늘할일.md 에 담당자·기한과 함께 정리해줘.
  3. 사진 폴더의 사진을 전부 가로 1200 크기로 줄여서 "작게" 폴더에 넣어줘. 원본은 건드리지 마.
  4. 로그 파일을 보고 프로그램이 왜 멈췄는지 원인과 고칠 방법만 알려줘. 고치지는 말고.
  5. 이 프로젝트의 README 를 처음 보는 사람이 이해할 수 있게 다시 써줘. 3줄 요약을 맨 위에.
  6. 이 폴더의 문서들을 읽고 핵심만 한 장으로 요약해줘.
  7. 계약서 PDF 들에서 계약 기간과 금액만 뽑아 표로 정리해줘. 못 읽은 파일은 따로 알려줘.
  8. 어제 만든 함수에 테스트를 붙이고 돌려서 결과를 알려줘. (Codex 탭에서)
  9. 이 주제로 최근 소식을 정리해서 링크와 함께 5줄로 알려줘. (Grok Build 탭에서)
  10. 오늘 한 일을 정리해서 보고서 초안을 만들어줘. 맨 위에 3줄 요약, 아래에 자세히.

더 잘 되게 하는 습관

  • 큰 일은 잘라서: "먼저 목록만 보여줘" → 확인 → "그중 3번만 해줘".
  • 하지 말 것을 같이: "원본은 건드리지 마", "설치는 하지 마".
  • 답이 길면 그 답의 「전체 보기 ▾」로 펼치고, 「요약 보기 ▴」로 다시 접습니다.
  • 사진 한 장이 말보다 빠를 때는 [+]로 올리고 "이 화면의 오류를 고쳐줘".
  • AI가 질문 카드로 물으면 보기를 눌러 답할 수 있습니다.

4. AI-CLI 5종의 역할과 협업

AI-CLI는 같은 PC의 같은 프로젝트 폴더에서 일합니다. 한 AI-CLI가 만든 파일을 다른 AI 탭에서 바로 이어서 시킬 수 있습니다.

AI 탭 — Claude Code · Codex · Antigravity · Grok Build · Muse Code
AI 탭 — Muse Code 탭은 Muse Code가 설치된 PC에서 나타납니다
Claude Code
PC의 파일을 직접 읽고 저장하고 프로그램을 돌립니다. 설치·설정·진단("O-MACS 진단해줘")도 이 탭(또는 PC의 Claude Code 창)에 시킵니다.
Codex
코드를 다시 보고 고치는 일에 시킵니다. 예: "Claude Code가 만든 함수를 검토하고 테스트를 붙여줘".
Antigravity
Google 계정으로 로그인한 상태에서 사용합니다. 초안·자료 정리 같은 빠른 일에 시킵니다.
Grok Build
최근 소식이나 다른 관점이 필요할 때 시킵니다.
Muse Code
Meta의 Muse Spark 기반 코딩 CLI입니다. Muse Code 탭은 Muse Code가 설치된 PC에서 나타납니다. 설치한 뒤 O-MACS를 다시 시작하면 탭이 나타나고, 로그인은 직접 하십니다.

여럿에게 나눠 시키기 — Claude Code 탭에 "Codex에게 검토 맡겨", "셋 다 돌려서 비교해"처럼 말하면 Claude Code가 나눠 맡기고 결과를 모아 줍니다. 탭은 서로 독립이라 Claude Code 탭에 긴 작업을 걸어 두고 Codex 탭으로 넘어가 다른 일을 시켜도 됩니다. 같은 파일을 두 AI에게 동시에 고치게 하는 것만 피하십시오.

Codex·Antigravity·Grok Build·Muse Code는 PC에서 로그인해 두면 사용할 수 있고, 아니면 그 탭이 「점검 중 — 다른 AI에게 맡겨 주세요」(빨강)로 바뀝니다.

5. 작업 지켜보기 · 멈추기

6. PC · 프로젝트 · 도구 늘리기

PC 더 붙이기

그 PC에서도 설치 안내를 한 번 합니다. 연결 코드는 같은 것 하나이고, 설치할 때 Claude Code가 그 PC의 자리(PC1~PC4, 다섯 대째부터는 PC5 · PC6 …)를 정하면 모바일 기기에 PC 탭이 하나 더 생깁니다. 탭을 눌러 오갑니다. O-MACS 허브는 연결 코드 하나에 PC 5대까지 고정 주소를 드립니다(직접 만든 허브는 Cloudflare 무료 플랜 기준 PC 3대까지가 안전하고, 그 이상은 Cloudflare 유료 플랜이 필요할 수 있습니다).

프로젝트(채널) 더 붙이기

채널 목록의 + 프로젝트 추가를 누릅니다. 「기존 폴더 연결」은 PC에 있는 폴더를 붙이고, 「새 폴더 만들기」는 이름을 정하면 빈 폴더를 만듭니다. 붙인 폴더가 새 채널이 되고, AI는 그 폴더 안에서 일합니다. 이름 바꾸기 · 연결 해제는 채널별 설정(7절)에서 합니다.

도구 탭 붙이기

보고서 작성 에이전트처럼 화면이 있는 프로그램(도구)을 채널에 붙여 두면, 채널 줄 오른쪽에 파란 도구 탭으로 나타나 모바일에서 바로 엽니다. 붙이는 법: 도구를 C:\OMACS 프로젝트\ 안의 새 폴더에 풀어 설치한 뒤, 그 도구 설명서의 「O-MACS에 추가하기」 글을 PC의 Claude Code 채팅창에 붙여 넣습니다(채널 연결 · 도구 탭 추가 · O-MACS 다시 켜기를 한 번에 합니다). 도구 탭을 누르면 도구가 PC에서 켜져 콘솔 안에서 열리고, 화면 위쪽 ✕로 직전 AI 탭에 돌아옵니다. 꺼졌으면 같은 도구 탭을 다시 누르면 다시 켜집니다(3.3.41부터).

다른 PC에 지시 보내기

내 PC끼리는 서로 지시를 넘길 수 있습니다. 가장 쉬운 방법은 홈(O-MACS) 채널의 Claude Code에게 「PC2에 이 일을 시켜줘」라고 말하는 것입니다. 직접 보내려면 어느 PC의 Claude Code에서든 아래처럼 합니다.

node C:\OMACS\console\daemon_ask.js --pc <PC이름> "<프로젝트명>" "<한 줄 지시>"

여러 줄짜리 긴 지시는 파일에 적어 --file 로 보냅니다. 명령줄에 길게 적으면 따옴표가 든 문장에서 잘려 뒷부분이 전달되지 않습니다.

node C:\OMACS\console\daemon_ask.js --pc <PC이름> "<프로젝트명>" --file <지시문.txt>

PC 이름은 node C:\OMACS\console\daemon_ask.js --list 로 볼 수 있는 이름이나 컴퓨터 이름을 넣습니다. 특정 AI에게 바로 시키려면 뒤에 --worker codex(또는 agy · grok)를 붙입니다. 자세한 것은 O-MACS 사용설명서 부록 A에 있습니다.

7. 설정

맨 위 줄 오른쪽 ⚙로 「O-MACS 통합 설정」을 엽니다. 통합 설정은 두 묶음으로 나뉘어 있고, 채널마다 정하는 것은 채널 줄 오른쪽의 ⚙(채널별 설정)에서 합니다.

🌐 모든 PC에 함께
화면 테마 · 작업 끝나면 알림 받기(모바일 앱에서만, 5절) · 음성 인식 방식(기본 · 정확 · 매우정확, 정확 이상은 OpenAI API 키 필요) · PIN 번호 변경. 여기서 바꾸면 내 PC 전부에 같이 저장됩니다.
💻 이 PC에만
이 PC 별명 설정(5자까지) · AI 작업 제한 시간 설정(5절) · 권한 모드 설정. PC 탭마다 따로 저장되고, 그 PC의 모든 채널에 같이 적용됩니다.
📂 채널별 설정(채널 줄의 ⚙)
「채널 이름 채널별 설정」 시트가 열립니다. AI 별 모델 선택 · AI 별 추론 강도(Effort) 설정을 채널마다 따로 정합니다 — 어려운 일을 하는 채널은 추론 강도를 높이고, 가벼운 일을 하는 채널은 낮춥니다. 「대화형 세션 추가」를 누르면 그 채널 폴더에서 Claude Code 대화형 세션이 하나 더 열리고, Claude 앱의 Remote Control에서 이어서 사용합니다. 채널마다 하나씩 켤 수 있고, 켜진 채널은 ⚙ 가운데에 초록 점이 보입니다. 채널 이름 바꾸기 · 채널 연결 해제도 여기서 합니다.
🧭 채널 모드
⚙ → 채널 관리 → 채널 모드 선택하기에서 채널마다 「운영 및 소규모 개발」(기본, 백그라운드에서 돕니다)과 「대규모 개발」(대화형 세션에서 진행) 중에서 고릅니다. 대규모 개발 모드의 채널에서는 새 개발 지시가 백그라운드로 가지 않고 「대화형 세션에서 진행하세요」 안내가 나옵니다. 한 지시가 제한 시간을 넘기거나 같은 재시도가 반복되거나 대기 지시가 4건 이상 쌓여도 같은 안내가 나옵니다.

화면 테마

밝은 화면
밝은 화면
어두운 화면
어두운 화면

어두운 화면 · 밝은 화면 · 기기 설정 중 고릅니다. "기기 설정"은 사용하고 있는 기기의 밝기 설정을 그대로 따릅니다.

권한 모드

자동 승인 모드(기본)는 AI가 묻지 않고 PC의 파일을 바꾸거나 명령을 실행하는 모드라, 제한이 풀립니다. 안전 모드는 ⚙ 설정의 권한 모드에서 직접 고르며, 파일을 통째로 지우거나 디스크를 지우는 것 같은 위험한 명령을 막습니다(막는 방식은 AI마다 다릅니다). 안전 모드에서 자동 승인 모드로 바꿀 때만 PIN 번호를 한 번 더 묻습니다. 무엇을 시키는지 알고 있을 때만 자동 승인으로 두고, 조심스러운 일은 안전 모드로 바꾸십시오. 중요한 파일(설정 파일·비밀 키 파일 등)은 편집 화면에서 저장할 때 한 번 더 확인합니다.

PIN 번호 변경

숫자 4~8자리로 정합니다(길수록 안전하며 6자리 이상을 권합니다). 내 PC 전부의 PIN 번호가 함께 바뀌고, 다른 기기는 새 PIN 번호로 다시 들어와야 합니다.

기본으로는 PIN 번호가 유일한 잠금입니다. 연결 코드와 PIN 번호는 남에게 알려 주지 마십시오. 자세한 내용은 알아 두실 점.

8. 업데이트와 모바일 앱

새 버전이 나오면 ⓘ에 빨간 숫자가 붙습니다. 업데이트와 모바일 앱 받기는 모두 ⓘ의 「업데이트 실행」 구역에서 합니다(3.3.41 이하 버전에서는 화면에 「업데이트 요청」 또는 「업데이트」 구역으로 나옵니다).

O-MACS 업데이트
「PC 브라우저 업데이트」 카드에 「새 버전 x.y.z」와 [업데이트] 버튼이 있습니다. 누르면 PC 브라우저 · 모바일 어디서든 그 PC가 스스로 내려받아 업데이트하고, 실패하면 이전 버전으로 되돌립니다(3.3.34부터. 그 전 버전은 이번 한 번만 구매 주문 확인 이메일의 「패키지 내려받기」로 새 패키지를 받아 설치합니다).
모바일 앱 처음 받기 (안드로이드)
안드로이드 기기의 브라우저로 O-MACS에 들어와 ⓘ › 「업데이트 실행」 › 「모바일 앱」의 [받기]를 누릅니다. 다 받아지면 「파일 열기」를 누르고, 설치 화면이 이어서 뜨면 차례로 누릅니다(「설치」 → 「무시하고 설치」 → Play 프로텍트 「앱 검사」가 나오면 검사 뒤 「설치」 → 「열기」). 앱이 열리면 연결 코드와 PIN 번호를 넣습니다. 모바일 앱은 작업이 끝났을 때 알림이 오고, 주소창이 없어 화면이 넓습니다.
모바일 앱 업데이트
「모바일 앱 업데이트」 카드의 [업데이트]를 누르면 새 버전을 받고 설치 화면이 바로 열립니다. 연결 코드와 PIN 번호는 그대로 남아 있어 다시 넣지 않습니다.

처음 한 번은 「권한 필요」 창이 뜰 수 있습니다. 「설정」 › 「출처를 알 수 없는 앱 설치」에서 허용을 켠 뒤 뒤로 돌아오면 이어서 설치됩니다. 삼성 갤럭시에서 설치가 차단되었다는 안내가 뜨면 설정 › 보안 및 개인정보 보호 › 「보안 위험 자동 차단」을 끄고 다시 설치하십시오. 경고가 뜨는 것은 Play 스토어 밖에서 받는 앱이기 때문이며, 앱에 문제가 있어서가 아닙니다.

9. 문제가 생기면

  1. PC의 Claude Code에 "O-MACS 진단해줘"라고 하십시오. 콘솔이 켜져 있는지, 연결 기록과 오류 기록, 워치독 등록을 확인해 원인을 알려 줍니다.
  2. 자주 묻는 22가지는 자주 묻는 질문에 있습니다 — PIN 번호를 잊었을 때, 연결 코드, 연결이 끊길 때, 한도 초과, Claude Code 창을 닫았을 때 등.
  3. 그래도 안 되면 구매 주문 확인 이메일에 적힌 문의처로 주문번호와 함께 연락하십시오.

"PC 콘솔이 응답하지 않습니다"가 뜨면 PC가 켜져 있는지 먼저 보십시오. PC를 켜고 Windows에 로그인하면 워치독(콘솔이 꺼지면 다시 켜 주는 감시 프로그램)이 5분 안에 콘솔을 다시 띄우고, 바로 띄우려면 C:\OMACS\console\restart_console.cmd 를 실행합니다. 인터넷이 다시 붙으면 모바일 앱과 브라우저가 자동으로 다시 연결합니다.

↑