Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Codeman은 Claude Code, Codex, Gemini 등 다양한 AI 코딩 에이전트들을 하나의 대시보드에서 통합 관리할 수 있도록 설계된 도구입니다. 이 네이티브 Mac 앱은 여러 모델을 중앙 집중식으로 제어하여 개발 워크플로우의 효율성을 높이는 것을 목표로 합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기<a href="https://github.com/Ark0N/Codeman/graphs/contributors"><img src="https://img.shields.io/github/contributors/Ark0N/Codeman?style=flat-square&color=3b82f6" alt="Contributors"></a>
<a href="https://github.com/Ark0N/Codeman/commits/master"><img src="https://img.shields.io/github/commit-activity/t/Ark0N/Codeman?style=flat-square&color=1e3a5f" alt="Total commits"></a>
<strong>Codeman</strong>은 AI 코딩 에이전트를 위한 자체 호스팅 미션 컨트롤입니다. 이 도구는 Claude Code, OpenCode, Codex, Antigravity, Gemini, Pi, Grok, DeepSeek Harness, OMP 또는 GitHub Copilot CLI를 영속적인 tmux 세션 내에 실행하고, 실제 터미널을 모든 브라우저로 스트리밍하며, 사용자가 자리를 비운 후에도 에이전트들이 생산성을 유지하도록 합니다. 즉, 유휴 상태일 때 재프롬프트(re-prompts)를 수행하고, 사용량 제한이 초기화되면 작업을 재개하며, 예약된 작업을 실행하고, 모든 백그라운드 에이전트가 실시간으로 작동하는 모습을 보여줍니다.
한 줄로 시작하기 (macOS 및 Linux, Windows는 WSL을 통해):
curl -fsSL https://getcodeman.com/install | bash
codeman web
# http://localhost:3000에서 열고 첫 세션을 시작하세요
설치 프로그램은 모든 시스템 변경 전에 사용자에게 질문하며, 동일한 라인을 다시 실행하면 제자리에서 업데이트됩니다. 자세한 내용은 빠른 시작 - 설치을 참고하십시오.
Mac 사용자의 경우 터미널 단계를 건너뛸 수 있습니다: Codeman.dmg 다운로드를 다운로드하면 앱이 Codeman을 설치하고, 이미 실행 중인 것을 열거나 다른 기기의 세션에 연결해 줍니다. 자세한 내용은 Mac에서: Codeman 앱을 참고하십시오.
codeman agent 및 MCP 서버를 통해 하나의 에이전트가 모든 CLI에서 워커(worker)를 시작하고, 프롬프트를 지정하며, 결과를 기다리고 답변을 수집할 수 있습니다.curl -fsSL https://getcodeman.com/install | bash
이 과정은 Node.js, tmux 및 빌드 툴체인(build toolchain)이 누락된 경우 설치하고(node-pty는 Linux 사전 구축본을 제공하지 않으므로 소스에서 컴파일됨), Codeman을 ~/.codeman/app으로 클론한 뒤 빌드합니다. 이 과정은 시스템에 이미 존재하는 것을 확인하고, 최대 세 가지 질문만 하며, 이후 모든 작업을 원격으로 처리하여 휴대폰용 QR 코드가 포함된 URL로 마무리됩니다. 알아두면 좋은 몇 가지 사항:
세 가지 질문, 모두 초기에 합니다. 대시보드(dashboard)에 어떻게 접근하는지, 선택적으로 tailnet에서 이 기계를 무엇이라고 부를지, 그리고 Codeman을 백그라운드 서비스(systemd/launchd, 부팅 시 자동 시작; Enter를 누르면 예로 간주됨)로 실행할지 등을 묻습니다. 모든 것이 필요로 하는 것들—모든 누락된 패키지에 대한 동의 한 번, sudo 비밀번호 한 번, 그리고 Tailscale 로그인—은 빌드 전에 처리되므로, 컴파일되는 동안 자리를 비워도 됩니다.
어떻게 접근 가능한지, 사용자가 선택합니다. Tailscale (tailscale serve를 통해 루프백 바인딩을 전면으로 하여, 실제 인증서를 가진 https://<기계>.<tailnet>.ts.net과 tailnet 자체를 로그인으로 사용할 수 있으며 비밀번호가 필요하지 않음), 네트워크상의 모든 장치 (0.0.0.0, 강력히 권장되는 비밀번호 프롬프트와 함께 사용), 또는 이 기계만 (127.0.0.1, 가장 안전함) 중 선택할 수 있습니다. 네트워크 바인딩에서 비밀번호를 건너뛰려면 명시적인 확인이 필요하며 큰 경고 메시지로 끝납니다. 강조 표시된 기본값은 이미 시스템에 존재하는 것을 반영합니다(이미 연결된 경우 Tailscale, 재실행 시 기존 바인딩). 단순히 Enter를 누르는 것은 새로운 소프트웨어를 가져오지 않습니다. 만약 다른 앱이 노드에서 :443 포트를 이미 사용하고 있다면, Codeman은 이를 대체하는 대신 https://<기계>.<tailnet>.ts.net/codeman 또는 두 번째 포트에서 실행됩니다. 수동으로 시작한 bare codeman web 역시 기본적으로 루프백에 설정됩니다.
이름은 사용자가 선택합니다. 기본적으로 URL은 기계의 기존 tailnet 이름을 사용합니다. 두 번째 질문에 '예'라고 답하면 기계 이름이 codeman-<호스트명>으로 변경되며 (SSH에서도 이름이 변경되므로, 기본값은 아니요), 나중에 install.sh name을 실행하여 변경할 수 있습니다.
업데이트를 위해 재실행합니다. 동일한 한 줄 명령은 완료된 설치를 제자리에서 업데이트합니다: ~/.codeman/app의 로컬 변경 사항은 스태시(stashed, 폐기되지 않음)되며, 실행 중인 서비스는 재시작 및 검증됩니다. 만약 첫 설치가 중단되었다면, 재실행 시 전체 설정이 다시 시작됩니다. install.sh status를 실행하면 URL과 QR 코드가 다시 출력하며, install.sh update, install.sh tailscale, 그리고 install.sh uninstall도 존재합니다.
관리자 권한이 필요하지 않습니다. sudo가 없거나, 설치 프로그램이 확인할 수 없는 sudo 권한을 가진 계정(즉, sudo, wheel, admin 그룹 외의 경우이며 여전히 비밀번호가 필요한 경우) 또는 관리자가 아니며 Homebrew가 쓸 수 있는 공간이 없는 Mac 계정의 경우, 설치 프로그램은 nodejs.org에서 Node.js를 다운로드하고 tmux 프로젝트 자체 빌드를 ~/.codeman/runtime에 저장합니다. 이 과정에서 각 파일은 SHA-256으로 검증되며, 작동하는 git 레포지토리가 없을 경우 소스 코드는 아카이브 형태로 사용됩니다. --no-admin 플래그는 이러한 경로를 강제하며, CODEMAN_NO_ADMIN=0 변수는 이를 비활성화합니다. 두 가지 제한 사항이 있습니다: Linux 환경에는 make, C++ 컴파일러, python3가 이미 설치되어 있어야 하며, tmux 다운로드의 경우 macOS 15 이상이 필요합니다. 자세한 내용은 wiki를 참조하십시오.
급한 사용자를 위한 플래그. curl -fsSL https://getcodeman.com/install | bash -s -- --tailscale --service 명령어는 명령줄에서 질문에 답변합니다(예: --lan, --local, --run, --no-start, --name <n>, --port <n>, --yes). CI / 헤드리스 환경: 터미널이 연결되어 있지 않은 경우, 시스템을 변경하는 단계는 조용히 실행되는 대신 지침과 함께 중단됩니다. 자동화를 위해 이를 승인하려면 CODEMAN_NONINTERACTIVE=1로 설정하십시오.
최소한 하나의 AI 코딩 CLI가 설치되어 있어야 합니다 — Claude Code, OpenCode, Codex, Antigravity, Gemini CLI, Pi, Grok Build, DeepSeek Harness, OMP, 또는 GitHub Copilot CLI (어떤 조합이든 작동합니다. Gemini CLI는 Google의 소비자 서비스 전환 이후 엔터프라이즈 전용이며, Antigravity가 그 후속작입니다). 설치 프로그램은 이 열 개 중 어떤 것이 존재하는지 감지합니다. 만약 아무것도 발견되지 않으면, 메뉴에서 그중 하나를 설치할 것인지 제안하거나 (DeepSeek 제외, DeepSeek의 npm 패키지는 실행 가능한 프로필이 없는 런처만 설치하기 때문입니다), 건너뛰고 나중에 직접 설치할 수도 있습니다. 설치 후:
codeman web
# Open http://localhost:3000 and start your first session
소규모 팀과 공유하시나요? 대신 멀티 유저 모드(multi-user mode)로 시작하세요. 각 사용자에게 자체 로그인 및 작업 공간이 제공됩니다.
codeman users add alice --admin # 첫 번째 관리자 계정 생성
codeman web --multiuser # 이름 지정 로그인 + 사용자별 작업 공간
자세한 내용은 아래 Multi-User Mode를 참고하세요.
Docker Compose를 선호하시나요? 레포지토리를 클론하고 스크립트 하나만 실행하세요 (Linux, Docker with the Compose v2 plugin):
git clone https://github.com/Ark0N/Codeman.git && cd Codeman
bash docker/Start-Codeman.sh
첫 실행 시 세 가지 질문(데이터 폴더, 포트, 비밀번호)을 하며, 엔터 키를 누르면 생성된 비밀번호를 포함한 기본값이 사용됩니다. 사용자 대신 docker/.env 파일을 작성하고 이미지를 빌드하며, Codeman이 답변하면 URL로 연결됩니다. 이 이미지에는 Claude Code, Codex, Gemini CLI 및 OpenCode가 이미 포함되어 있습니다. Codeman은 컨테이너 내에서 실행되며 호스트 소켓을 통해 형제 컨테이너(sibling containers)로서 Docker 케이스를 생성합니다. 업데이트하려면 일반적인 docker compose up 대신 앱 설정 → 업데이트를 사용하거나, 스크립트를 다시 실행하기 위해 git pull을 사용해야 합니다. 이렇게 해야 재빌드된 이미지, 새로 고침된 볼륨(volumes), 그리고 진입점(entrypoint)이 함께 적용됩니다. Unraid, 직접적인 Compose 명령어, 스토리지 및 네트워킹 옵션에 대한 내용은 Docker 배포 가이드를 참조하십시오.
Codeman.dmg 다운로드 · Apple Silicon 및 Intel용 범용 앱 · macOS 11.3 이상