내 ChatGPT 구독으로 운영하는 픽셀 멀티에이전트 사무실
한국어 · English · 설치파일 다운로드 · 설치 · 삭제 · 기능
PXagents는 OpenAI의 ChatGPT 구독을 이용해 Codex를 멀티에이전트로 구성한 데스크톱 앱입니다. 하나의 요청을 총괄·개발·글쓰기·편집 담당으로 나누고, 각 담당자가 자기 모델과 지침으로 작업하도록 연결합니다. 본인 ChatGPT 계정으로 로그인하면 구독 기반 Codex를 사용하며, 별도의 API 키 입력 없이 시작할 수 있습니다.
사장님은 일 시키기로 요청하고, 동료들은 픽셀 사무실에서 일합니다. 비서에게 진행 상황을 물어보고, 편지함에서 결과를 확인하세요. 위 이미지는 실제 코드 수정 결과를 주장하는 화면이 아닌 데모 모드 화면입니다.
| 구분 | 필요한 항목 |
|---|---|
| 모든 OS | Codex 사용 권한이 있는 본인 ChatGPT 구독 계정, 인터넷 연결, 로그인용 웹브라우저 |
| 앱에 포함 | Electron/Node.js 런타임, 공식 Codex CLI와 플랫폼별 실행 리소스 — 따로 설치할 필요 없음 |
| 다른 컴퓨터에 작업 요청 | 앱 실행 PC와 대상 PC의 Tailscale 연결, 앱 실행 PC의 SSH 클라이언트, 대상 PC의 SSH 서버 |
| 작업에 필요한 도구 | Python·Git·컴파일러 등은 실제로 요청한 작업에 따라 해당 작업 PC에 설치 |
로컬 작업만 하면 Tailscale과 SSH는 필요하지 않습니다. 구독의 모델 제공 범위와 사용량 제한은 OpenAI 정책을 따릅니다. OpenAI 공식 Codex 요금 안내
설정 → 시스템 → 정보 → 시스템 종류에서 CPU 종류를 확인한 뒤 파일을 선택하세요.
| 내 컴퓨터 | 설치파일 |
|---|---|
Intel / AMD의 일반 64비트 PC, x64 기반 프로세서 |
PXagents-windows-x64.exe |
Snapdragon 등 Windows on ARM PC, ARM 기반 프로세서 |
PXagents-windows-arm64.exe |
- CPU에 맞는
.exe를 다운로드하고 실행합니다. - 첫 화면의 입력값 **
i**를 유지하고 다음을 누릅니다. - 설치 위치를 선택해 설치하고, 시작 메뉴 또는 바탕화면에서 PXagents를 실행합니다.
32비트 Windows용 설치파일은 제공하지 않습니다. Node.js·npm·Codex CLI를 별도로 설치할 필요는 없습니다.
원격 작업을 사용할 때: Tailscale을 설치하고 로그인합니다. OpenSSH Client가 없으면 관리자 PowerShell에서 설치하세요. Microsoft 설치 안내
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0터미널에 아래 명령을 실행합니다. Intel Mac은 x64, M1·M2·M3·M4 등 Apple Silicon Mac은 ARM64로 자동 감지합니다.
curl -fsSL https://raw.githubusercontent.com/choimagon/PXagent/main/install.sh -o /tmp/pxagents-install.sh
sh /tmp/pxagents-install.sh i설치 후 실행:
open "$HOME/Applications/PXagents.app"설치 위치는 ~/Applications/PXagents.app입니다. curl, sh, ditto, shasum 등 macOS 기본 도구를 사용하므로 Homebrew나 별도 Node.js 라이브러리가 필요하지 않습니다. 원격 작업에는 Tailscale을 별도로 설치하고, macOS에 포함된 SSH 클라이언트를 사용합니다.
직접 다운로드하려면 Apple Silicon ZIP / Intel ZIP을 선택하세요. DMG도 릴리스 페이지에 제공합니다.
그래픽 데스크톱 세션이 필요합니다. 설치 스크립트는 x86_64/amd64를 x64로, aarch64/arm64를 ARM64로 자동 감지합니다. GTK·NSS·GBM·ALSA 런타임과 인증서·다운로드·압축 도구가 필요합니다. SSH 비밀번호를 저장하려면 Secret Service를 제공하는 GNOME Keyring 또는 KWallet이 실행 중이어야 합니다.
Ubuntu 24.04 계열:
sudo apt-get update
sudo apt-get install -y curl ca-certificates tar coreutils libgtk-3-0 libnss3 libgbm1 libasound2t64 libsecret-1-0 gnome-keyringUbuntu 22.04 계열:
sudo apt-get update
sudo apt-get install -y curl ca-certificates tar coreutils libgtk-3-0 libnss3 libgbm1 libasound2 libsecret-1-0 gnome-keyring다른 배포판에서는 이에 대응하는 런타임 패키지를 설치하세요. 원격 작업을 사용할 경우 openssh-client와 Tailscale도 필요합니다. 설치 명령:
curl -fsSL https://raw.githubusercontent.com/choimagon/PXagent/main/install.sh -o /tmp/pxagents-install.sh
sh /tmp/pxagents-install.sh i
"$HOME/.local/bin/pxagents"앱은 ~/.local/opt/pxagents에 설치되고 앱 메뉴에 등록됩니다. 설치 스크립트의 TAR 배포는 Chromium의 사용자 네임스페이스 샌드박스를 사용합니다. Ubuntu 24.04 등에서 이 기능이 제한돼 앱이 실행되지 않으면 **릴리스의 CPU에 맞는 .deb**를 내려받아 설치하세요.
# 다운로드한 파일이 있는 폴더에서 실행
sudo apt install ./PXagents-2.1.3-linux-x64.deb
# ARM64 시스템은 대신 다음 파일 사용
# sudo apt install ./PXagents-2.1.3-linux-arm64.debAppImage를 선택한 경우 FUSE 2 런타임이 추가로 필요할 수 있습니다. 모든 Linux 설치파일
설치 스크립트는 릴리스의 SHA-256 체크섬을 확인합니다. 서명·공증되지 않은 배포물은 Windows SmartScreen 또는 macOS 보안 확인이 나타날 수 있습니다.
왼쪽 사이드바의 업데이트를 누르면 GitHub의 최신 정식 버전을 확인합니다. 새 버전 다운로드가 끝나면 업데이트 후 재시작을 누르세요. OS와 CPU에 맞는 설치파일을 선택하고 SHA-256을 검증한 뒤 앱을 교체합니다. 계정, 에이전트 설정, 편지함과 작업 기록은 유지합니다. 실행 중이거나 대기 중인 작업·Goal은 먼저 완료하거나 중지해야 합니다.
2.1.0 이전 앱은 2.1.1 이상 설치파일을 한 번 덮어 설치하면 버튼이 생깁니다. 삭제할 필요가 없습니다. Linux DEB 자동 설치에는 pkexec(PolicyKit)과 관리자 승인이 필요합니다. 앱 설치 폴더에 쓰기 권한이 없거나 PolicyKit이 없으면 설치파일 열기로 기존 앱 위에 설치하세요. 웹 화면에서는 데스크톱 설치파일 다운로드를 안내합니다.
설정 → 앱 → 설치된 앱 → PXagents → 제거를 선택하세요. 기존 .exe 설치파일을 다시 실행하고 첫 화면에 **c**를 입력해도 삭제할 수 있습니다.
curl -fsSL https://raw.githubusercontent.com/choimagon/PXagent/main/install.sh -o /tmp/pxagents-install.sh
sh /tmp/pxagents-install.sh c앱을 종료한 뒤, 설치 스크립트로 설치했다면:
curl -fsSL https://raw.githubusercontent.com/choimagon/PXagent/main/install.sh -o /tmp/pxagents-install.sh
sh /tmp/pxagents-install.sh c.deb로 설치했다면:
sudo apt remove px-agents-office삭제는 앱 실행파일과 바로가기를 제거합니다. 저장된 작업·편지·설정과 계정 정보는 유지하며, 앱 안의 기록만 정리하려면 각 화면의 🗑️ 비우기를 사용하세요.
왼쪽 구독 사용량에서 초기화권 총 개수와 만료일별 개수를 확인합니다. 같은 만료일의 초기화권은 묶어 표시하며, 클릭하면 전체 일정을 봅니다. 만료가 없는 권한과 만료일 정보가 제공되지 않은 권한을 구분하고 1분마다 갱신합니다.
- 앱에서 Codex 연결을 누르고 브라우저로 본인 ChatGPT 계정에 로그인합니다.
- 로컬 작업은 내 컴퓨터로 시작, 원격 작업은 Tailscale 연결을 확인하고 컴퓨터 선택하기를 누릅니다.
- 사무실에서 일 시키기를 눌러 요청과 작업 폴더를 지정합니다.
- 사이드바에서 실행 상황을 확인하고 완료된 결과는 편지함에서 읽습니다.
앱은 현재 한국어 UI를 제공합니다. Codex는 지정한 작업에 대해 파일과 명령을 실행하며, 앱의 실행 설정은 추가 승인 없이 작업하는 방식입니다.
| 부서 | 기본 이름 | 맡는 일 |
|---|---|---|
| 사장실 | 호문클루스 | 기획, 부서 라우팅, 작업 그래프·의존성 관리, 실패 재계획, 최종 검수 |
| 사장실 | 비둘기 | 실제 작업·로그를 근거로 진행 상황 안내. 총괄이 배정·제어하는 작업자와 분리 |
| 개발부서 | 개발노예 | 실제 코드 확인 후 직접 구현·주니어·AutoResearch 선택, 개발 결과 검수 |
| 개발부서 | 따까리 | 작은 UI 수정, 단순 버그, 테스트 등 범위가 좁은 개발 작업 |
| 개발부서 | 카파시 | 개발 팀장 위임으로 반복 실험, 실제 metric 비교와 best 보존 |
| 문서부서¹ | 분석이 | PDF·DOCX·PPTX·MD·TXT·CSV 등 파일 읽기·주장·근거·표·그림·수식·한계 분석 |
| 문서부서¹ | 글싸게 | 분석 결과를 보고서·제안서·논문·요약·발표 문구로 집필 |
| 문서부서¹ | 양식이 | 사실 내용은 보존하고 스타일·레이아웃·제출 규격·참고문헌 정리 |
| 잡다부서 | 말똥이 | 정리, 아이디어와 일상 잡무 |
¹ 사무실 화면의 기존 논문부서는 모든 문서를 처리하는 문서부서입니다. 분석만 요청하면 분석이, 집필까지 요청하면 분석이 → 글싸게, 서식까지 요청하면 분석이 → 글싸게 → 양식이로 이어집니다.
캐릭터 또는 명패를 클릭하면 작업 배정이 맨 위에 나타납니다. 담당자별 역할 지침과 고정 프롬프트를 저장할 수 있고, 이름 옆 연필 버튼에서 이름과 외형을 바꿀 수 있습니다. 마법사·로봇·닌자·고양이·펭귄 등 26종 픽셀 캐릭터를 제공합니다.
사무실 오른쪽 위 🤖 버튼에서 전체 에이전트 조합을 한 번에 맞춥니다. 현재 모델·레벨 조합은 이름을 붙여 내 프리셋으로 저장하고 다시 적용할 수 있습니다. 프리셋은 사무실별로 유지됩니다.
| 에이전트 | 상급 | 중급 | 하급 |
|---|---|---|---|
| 호문클루스 | Astra / High | Sol / XHigh | Terra / High |
| 개발노예 | Sol / High | Terra / XHigh | Terra / Medium |
| 글싸게 | Sol / High | Terra / XHigh | Luna / XHigh |
| 양식이 | Terra / High | Terra / Medium | Luna / XHigh |
| 분석이 | Terra / High | Terra / High | Luna / XHigh |
| 카파시 | Sol / High | Terra / High | Luna / XHigh |
| 따까리·말똥이·비둘기 | Luna / Medium 고정 | Luna / Medium 고정 | Luna / Medium 고정 |
고정된 세 에이전트 외에는 사이드바에서 모델과 추론 레벨을 개별 조정할 수 있습니다. 변경은 다음 모델 호출부터 적용됩니다.
부서 오른쪽 위 버튼으로 Normal ↔ Fast를 전환합니다. 해당 부서의 다음 Codex 호출에 적용되며 설정은 저장됩니다. Fast에서는 캐릭터 머리 위에 픽셀 불꽃이 나타나고, 사장실은 밤 창문과 바닥 책, 개발부서는 서버 냉각 장치·배관·팬, 논문부서는 책더미, 잡다부서는 늘어난 택배박스와 기울어진 전광판으로 바뀝니다.
Fast는 지원 모델의 응답을 빠르게 처리하는 대신 구독 사용량을 더 소비합니다. 적용 가능 모델과 배율은 OpenAI 공식 Fast 모드 안내를 확인하세요.
직접 담당자를 선택하거나 총괄에게 배정을 맡길 수 있습니다. Goal은 목표와 완료 기준을 정하고 결과를 검토하면서 후속 회차를 이어갑니다. 작업 현황에서 상태·실행 단계·로그·결과를 확인하고 중지·재실행·이어서 작업을 사용할 수 있습니다. 같은 담당자의 작업은 대기열로 관리하고, 다른 담당자는 병렬로 일할 수 있습니다.
비둘기에게 “지금 무슨 일 하고 있어?”처럼 물으면 실제 작업과 로그를 기반으로 알려줍니다. 사이드바에는 구독 사용량과 조회 가능한 초기화권 정보도 표시합니다.
호문클루스는 요청을 최대 24개 작업으로 분해하고 dependsOn으로 실행 순서를 정합니다. 선행 작업이 검증된 뒤 그 결과를 다음 담당자에게 전달하며, 독립 작업은 서로 다른 담당자 최대 3명까지 병렬 실행합니다. 같은 담당자의 호출은 직렬로 처리합니다. 실패하면 완료한 작업은 유지하고 남은 작업만 최대 2회 재계획합니다.
Agent의 역할과 전문 Skill을 분리했습니다. React·Python·C++·Git·디버깅·테스트·PDF·논문·통계·LaTeX 등 21개 Skill 중 담당자에게 허용된 지침을 전달하고, 담당자가 현재 작업에 필요한 Skill을 선택해 적용합니다. 작업 상세창에서 담당자·의존성·Skill·검증 결과를 확인할 수 있습니다. 직접 담당자를 선택해도 해당 역할의 내장 Skill 지침이 전달되어 필요한 Skill을 사용할 수 있습니다.
Codex 실행은 실행 PC의 개인 설정을 로드하므로 설치하고 활성화한 개인 Skill·플러그인과 연결된 MCP 도구도 사용할 수 있습니다. 작업에 $skill-name을 넣으면 총괄이 담당자에게 호출을 전달합니다. 연결 도구는 같은 실행 PC의 Codex 설정과 인증이 필요합니다. 앱에서 지정한 모델·ChatGPT 로그인·단계별 샌드박스·승인 정책은 계속 적용됩니다.
Codex 작업은 지정한 실제 폴더에서 직접 실행합니다. 파일 접근은 **전체 접근(danger-full-access)**이며, 홈 폴더와 작업 폴더 밖의 파일도 요청에 필요하면 읽고 수정할 수 있습니다. Git worktree·파일 스냅샷·원본 반영 절차를 사용하지 않습니다. 변경은 즉시 실제 파일에 적용되고 자동 rollback하지 않습니다. Codex가 보고한 변경 파일의 구문과 프로젝트 검증 명령은 실제 경로에서 확인합니다. 작업 배정창에서 검증 명령을 직접 지정할 수도 있습니다. 격리 실험 엔진 대신 개발 담당자가 실제 파일에서 개선과 검증을 수행합니다. 데모는 SIMULATED, API 텍스트 모드는 TEXT_ONLY로 표시하며 실제 파일 실행 결과로 취급하지 않습니다.
문서 reader는 원본을 수정하지 않고 텍스트와 페이지·슬라이드 근거를 반환합니다. DOCX/PPTX에는 Python 3, PDF에는 Poppler의 pdftotext 또는 Python 3 + PyMuPDF/pypdf가 필요합니다. Windows는 Python·Git·Poppler 실행 파일을 PATH에 등록하고, macOS/Linux도 해당 도구를 설치하세요. 스캔 PDF는 OCR, PDF 페이지와 Word/PPT 내장 이미지는 현재 작업 폴더의 .px-runtime/doc-images에 추출해 이미지 보기 도구로 확인합니다. PDF 이미지 추출에는 Poppler의 pdftoppm 또는 PyMuPDF가 필요합니다. 원본 문서는 보존하며, 이미지·그림·수식 중 확인하지 못한 내용은 분석 한계에 기록합니다.
호문클루스가 개발부에 작업을 맡기면 개발노예가 코드를 읽고 반복 실험의 필요성을 판단합니다. 카파시는 총괄이 직접 배정하는 일반 작업자가 아니며, 캐릭터의 배정 버튼도 개발 팀장에게 실험 요청으로 연결됩니다. 단순 버그·색상·오타·명확한 기능 추가에는 직접 구현이나 주니어 위임을 사용합니다.
반복 비교가 유리하고 실제 objective metric·자동 테스트가 있는 로컬 Git 프로젝트에서만 AutoResearch를 실행합니다. 개발 팀장이 고정된 테스트와 metric 명령을 지정하고, metric은 실제 실행 후 마지막 JSON 줄에 {"metric": 숫자}를 출력해야 합니다. 카파시가 가설 한 개와 허용 파일 변경을 수행하면 서버가 테스트·측정·비교를 실행합니다. 이전 best보다 좋은 결과만 보존하고, 성능 악화·테스트 실패·범위 위반은 되돌립니다. 테스트·측정 파일 자체를 바꾸는 실험도 거부합니다.
최대 5회 · 10분 · 토큰 예산 20,000 · 변경 파일 10개이며 작업 배정창에서 더 낮게 설정할 수 있습니다. 토큰은 Codex의 실제 턴 사용량을 확인해 다음 회차를 차단합니다. 진행 중인 한 턴은 예산을 넘길 수 있으며, 초과한 변경은 폐기합니다. 구독 사용량의 사후 집계이므로 금액 단위의 결제 상한은 아닙니다. 중지 버튼으로 전체 작업과 실험을 종료할 수 있고, 상세창에 가설·변경 파일·metric 전후·채택/폐기·중지 이유를 저장합니다. 최적 결과는 개발 팀장 검수와 통합 검증을 거쳐 반영합니다.
원격 작업도 SSH를 통해 지정한 실제 경로에서 직접 실행합니다. SSH worktree와 별도 원본 반영 단계는 사용하지 않습니다.
공통 Event Bus에 작업 배정·시작·완료·실패, Agent의 생각·구현·검증·검수, 문서 분석, 실험 회차·best 갱신을 기록합니다. 픽셀 캐릭터는 실제 실행 이벤트에 따라 타이핑·검증·검수·분석·실험 상태를 표시하며, 타이핑 소리도 구현 상태일 때 재생합니다. 공통 이벤트는 최근 2,000개까지 저장되고 사무실별로 나뉘며, 관련 작업·활동 기록을 비우면 연결된 이벤트도 지웁니다.
완료·실패·중지된 작업의 보고는 편지함에 도착합니다. 읽음 표시, 결과 복사·다운로드, 뽀로롱 알림음과 작업 중 키보드 소리를 제공합니다. 활동 기록에서는 에이전트가 수행한 단계와 실행 이벤트를 볼 수 있습니다.
편지함·작업 현황·활동 기록의 🗑️ 비우기에서 전체 삭제 또는 선택한 날짜 이전 삭제를 고릅니다. 대상 개수를 확인한 뒤 삭제하며, 선택한 당일의 기록은 남습니다. 작업 정리에서는 실행·대기 중인 작업과 진행 중인 Goal을 유지합니다. 각 종류의 기록은 별도로 삭제하며, 자동으로 날짜가 바뀌어 리셋되지 않습니다. 활동 로그는 최근 1,000개까지 유지합니다.
Tailscale에 연결된 컴퓨터를 감지하고, 컴퓨터마다 독립된 사무실·작업·편지·프리셋을 관리합니다. 원격 접속 계정과 SSH 설정을 저장할 수 있습니다. Codex는 앱 실행 PC에서 실행하고, 원격 파일과 명령은 SSH로 처리합니다. 원격 작업 대상은 현재 Linux·macOS 등의 Unix 환경입니다.
tail웹을 켜면 작업 결과를 웹페이지로 공유하고 편지에 링크를 넣습니다. 같은 Tailscale 네트워크에서 앱이 실행 중일 때 열 수 있습니다. 데스크톱의 접속 비밀번호는 OS 보안 저장소를 통해 암호화합니다.
| 구성요소 | 출처·조건 |
|---|---|
| 픽셀 캐릭터·사무실·가구·로고·불꽃 | 프로젝트 코드로 직접 제작한 SVG. 외부 게임 스프라이트·유료 에셋팩 사용 없음 |
| Galmuri11 폰트 | Galmuri / quiple · SIL OFL 1.1 |
| 키보드 타이핑 효과음 | Keyboard Typing 7 / grcekh · CC0 1.0 |
외부 구성요소 고지는 THIRD-PARTY-NOTICES.md를 참고하세요. 앱과 직접 제작한 그래픽의 별도 재사용 라이선스는 아직 지정하지 않았습니다. 배포물에는 개인 작업 기록·로그인 파일·SSH 비밀번호를 포함하지 않습니다.