AI Neo Lab
스킬

T3 Code로 여러 AI 코딩 에이전트 한 번에 제어하는 법

Claude Code, Codex, Cursor 등 서로 다른 AI 에이전트를 각각 띄워놓고 번갈아 쓰느라 맥락이 끊긴 경험이 있으실 겁니다. T3 Code는 이들을 하나의 백엔드 서버로 통합해 모바일·웹·데스크톱 어디서든 단일 인터페이스로 조작할 수 있게 해줍니다. 이 글은 설치부터 다중 에이전트 연동, 원격 접속까지 실무 흐름에 맞춰 5단계로 정리합니다.

로컬에 깔린 AI 코딩 도구가 늘어나면서 '어떤 창에서 무슨 명령을 내렸더라?' 하며 헤매는 일이 잦아졌습니다. T3 Code는 2.5만 개 스타를 받은 오픈소스 허브로, 주요 에이전트 6종을 한 화면에서 제어하고 원격에서도 이어서 개발할 수 있게 만듭니다.

T3 Code란 무엇인가

T3 Code는 여러 AI 코딩 에이전트를 한곳에서 제어하는 허브입니다. Codex·Claude Code·Cursor·Grok Build·OpenCode·Google Antigravity까지 6종 프로바이더를 기본 지원하며, 내 컴퓨터에 이미 설치·인증된 CLI만 있으면 별도 설정 없이 바로 연동됩니다. 저장소 pingdotgg/t3code는 2.5만 개 스타를 받았고, MIT 라이선스로 공개되어 있어 누구나 포크해 원하는 에디터로 확장할 수 있습니다.

지원 프로바이더와 준비 명령어

프로바이더CLI 설치 후 실행할 인증 명령어
Codexcodex login
Claude Codeclaude auth login
Cursoragent login
Grok Buildgrok login
OpenCodeopencode auth login
Google Antigravity설정에서 'Install Antigravity' → Google 로그인 (CLI 불필요)

크로스 플랫폼 앱은 iOS·Android 네이티브, 웹 앱(app.t3.codes), Electron 데스크톱 네 가지로 제공됩니다. 서버는 로컬에서 t3 명령어로 실행하며, t3 service install로 백그라운드 서비스로 등록하면 상시 대기 상태로 쓸 수 있습니다. 8개월 전(2026년 2월) 처음 만들어져 이번 달(2026년 10월)까지 활발히 업데이트되고 있습니다.

  1. 최소 하나의 프로바이더 CLI 설치·인증

    위 표의 명령어 중 하나를 실행해 인증을 마칩니다.

  2. T3 Code 서버 실행

    터미널에서 t3를 입력하면 로컬 웹 앱이 열립니다.

  3. 원하는 클라이언트 접속

    모바일·웹·데스크톱 중 편한 앱으로 동일 세션에 들어갑니다.

자주 묻는 질문

별도 클라우드 계정이 필요한가요? — 아니요. 내 구독·인증만 사용하며 데이터는 로컬에 남습니다.

Windows에서도 되나요? — PowerShell에서 동일하게 t3 명령어로 실행됩니다.

왜 T3 Code를 쓰는가

T3 Code를 쓰는 가장 큰 이유는 분산된 AI 코딩 에이전트 창을 하나로 합칠 수 있기 때문입니다. Codex·Claude Code·Cursor·Grok Build·OpenCode·Google Antigravity까지, 이미 내 컴퓨터에 깔려 있고 로그인된 구독만 있으면 T3 Code가 자동으로 감지해 단일 인터페이스에서 제어합니다. 터미널마다 띄워 둔 에이전트 창 사이를 오가며 컨텍스트를 잃을 일이 사라집니다.

두 번째 이점은 모바일·웹·데스크톱 어디서든 원격 개발이 가능하다는 점입니다. iOS·안드로이드 네이티브 앱, 웹 앱(https://app.t3.codes), Electron 데스크톱 앱(https://t3.codes) 모두 같은 백엔드 서버에 붙습니다. 밖에서 스마트폰으로 PR 리뷰를 하고, 집에서는 전체 화면 데스크톱 앱으로 이어서 작업하는 흐름이 끊기지 않습니다.

서버 실행·백그라운드 등록
t3
# 백그라운드 서비스로 유지하려면
t3 service install

포크 가능한 완전 오픈소스

세 번째는 MIT 라이선스로 공개된 저장소(pingdotgg/t3code)를 통째로 포크해 나만의 에디터를 만들 수 있다는 점입니다. 2.5만 개 스타, 6,411개 포크, 주 언어 TypeScript, 8개월 전(2026년 2월) 처음 만들어져 이번 달(2026년 10월)까지 활발히 갱신되고 있습니다. 상업적 방향이 마음에 들지 않으면 언제든 내 입맛대로 고쳐 쓸 수 있는 안전장치가 코드 자체에 있습니다.

지표수치
스타2.5만 개 (배지 25K)
포크6,411개
라이선스MIT
주 언어TypeScript
최초 릴리스8개월 전(2026년 2월)
최근 업데이트이번 달(2026년 10월)

설치·사전 준비 5단계

T3 Code를 쓰려면 먼저 지원하는 AI 코딩 에이전트 중 하나 이상을 설치·인증해야 해요. Codex·Claude Code·Cursor·Grok Build·OpenCode·Antigravity가 해당되며, 각 도구 공식 채널에서 CLI를 내려받은 뒤 로그인 명령어를 실행하면 돼요.

에이전트CLI 설치 경로인증 명령어
CodexCodex CLIcodex login
Claude CodeClaude Codeclaude auth login
CursorCursor CLIagent login
Grok BuildGrok Build CLIgrok login
OpenCodeOpenCodeopencode auth login
Antigravity별도 CLI 없음설정 → Install Antigravity → Google 로그인

CLI 준비가 끝나면 T3 Code 자체를 설치합니다. macOS·Linux는 Homebrew, Windows는 PowerShell에서 다음 명령어를 차례대로 실행하세요.

macOS / Linux (Homebrew)
brew install pingdotgg/t3code/t3
Windows (PowerShell)
irm https://t3.codes/install.ps1 | iex
  1. T3 서버 실행

    터미널에서 t3를 입력하면 로컬 웹 앱이 열리며 서버가 포그라운드로 뜹니다.

  2. 백그라운드 서비스 등록(선택)

    t3 service install을 실행하면 시스템 서비스로 등록돼 부팅 후에도 자동 실행됩니다.

  3. 모바일·데스크톱 앱 연동

    iOS·Android 앱이나 Electron 데스크톱 앱에서 같은 계정으로 로그인하면 원격 제어 준비 완료입니다.

한눈에 보는 인터페이스 구성

T3 Code는 웹·데스크톱·모바일 세 가지 화면에서 같은 세션을 이어갈 수 있게 설계됐어요. 브라우저에서 https://app.t3.codes를 열거나, 일렉트론 기반 데스크톱 앱을 설치하면 로컬 서버와 바로 연결되고, iOS·안드로이드 앱은 원격에서도 동일한 터미널·에이전트 상태를 보여줘요.

에이전트 전환 방식

사이드바 아이콘을 클릭하면 즉시 해당 에이전트 프로세스에 attach돼요. 이미 실행 중인 세션이 있으면 그대로 이어지고, 없으면 새 세션이 자동 생성돼요. 전환 시 작업 디렉터리·환경 변수·히스토리가 그대로 유지돼서 컨텍스트 손실이 없어요.

  1. 웹에서 Codex 세션 열기

    app.t3.codes 접속 → 왼쪽 Codex 아이콘 클릭 → 터미널에서 바로 코딩 시작

  2. 데스크톱에서 Claude Code로 전환

    데스크톱 앱 실행 → 사이드바 Claude Code 선택 → 기존 세션 이어서 작업

  3. 모바일로 이어받기

    앱 로그인 → 동일 워크스페이스 선택 → 실시간 터미널 뷰 확인

세션 공유·동기화

  • 로컬 서버(t3 명령으로 기동)가 단일 소스 오브 트루스 역할을 해요.
  • 웹·데스크톱·모바일 모두 웹소켓으로 같은 서버에 붙어서 터미널 출력·입력·파일 변경을 실시간 동기화해요.
  • 인증 토큰은 로컬 키체인/자격 증명 관리자에만 저장되고, 외부로는 세션 ID·읽기 전용 토큰만 전달돼요.
데스크톱 앱에서 백그라운드 서비스 등록
t3 service install

주의할 점과 트러블슈팅

T3 Code를 처음 쓰다 보면 인증 절차와 백그라운드 서비스 설정에서 실수하기 쉽습니다. 먼저 하나 이상의 프로바이더를 설치·인증해야 로컬 에이전트를 제어할 수 있어요. 인증이 안 된 상태에서 t3를 실행하면 화면이 열리지만 에이전트와 연결되지 않아 작업이 멈춥니다. 또한 Windows에서는 백그라운드 서비스 권한을 부여하지 않으면 t3 service install 명령이 정상적으로 동작하지 않을 수 있습니다.

프로바이더인증 명령
Codexcodex login
Claudeclaude auth login
Cursoragent login
Grok Buildgrok login
OpenCodeopencode auth login
AntigravitySettings → Install Antigravity → Sign in with Google

백그라운드 서비스를 항상 켜두려면 PowerShell(또는 CMD)에서 아래 명령을 실행하고, 관리자 권한이 필요한 경우 ‘관리자 권한으로 실행’을 선택하세요.

터미널에서 실행
t3 service install
백그라운드 서비스가 안 켜지는 경우

관리자 권한이 없으면 t3 service install이 실패합니다. PowerShell을 ‘관리자 권한으로 실행’한 뒤 다시 시도해 보세요. 그래도 안 되면 Windows 서비스 목록에서 t3 항목을 찾아 수동으로 시작할 수 있습니다.

핵심 체크포인트

정리: 내 워크플로에 맞춰 확장하기

T3 Code는 MIT 라이선스로 공개돼 있어 누구나 자유롭게 포크·수정·배포할 수 있어요. 저장소는 2026년 2월에 만들어졌고, 벌써 2.5만 개 스타와 6,411개 포크를 모으며 커뮤니티가 빠르게 성장 중입니다. 핵심 로직이 TypeScript로 작성돼 있어 타입 안전성을 유지하면서도 플러그인이나 커스텀 에이전트 어댑터를 추가하기 쉽습니다.

  1. 커스텀 에이전트 어댑터 만들기

    packages/adapters 아래 새 폴더를 만들고 AgentAdapter 인터페이스를 구현하세요. spawn(), send(), onEvent() 세 메서드만 채우면 T3 Code가 자동 인식합니다.

  2. 공유 서버 띄우기

    docker compose -f docker/team.yml up -d 로 세션 브로커·PostgreSQL·Redis를 한 번에 올립니다. .env 에 JWT_SECRET, PROVIDER_KEYS만 채우면 팀원 전용 엔드포인트 완성.

  3. 데스크톱·모바일 빌드 커스터마이징

    apps/desktop(Electron), apps/mobile(Expo) 에서 브랜드·테마·단축키를 바꾼 뒤 pnpm build:all 로 아티팩트 생성.


이런 글도 있어요