T3 Code로 Git worktree와 코딩 에이전트를 한곳에서 관리하기
T3 Code로 코딩 에이전트를 한곳에서 관리하고 Git worktree로 작업을 분리하는 방법을 살펴봅니다. 설치와 공급자 연결부터 브랜치 검토, 휴대폰 원격 접속까지 안내하고, 안정 버전 테마와 nightly CSS 맞춤 설정의 차이 및 도입 전 확인할 제약을 정리합니다.
게시일

T3 Code는 기존 코딩 에이전트를 하나의 워크스페이스에서 실행하고, Git worktree로 작업별 브랜치를 분리하며, 휴대폰에서도 하던 일을 이어갈 수 있게 해줍니다. 에이전트와 변경 사항, 여러 기기를 관리하는 일 자체가 부담이 됐다면 도입을 검토할 만합니다.
핵심은 작업 흐름을 정리하는 데 있습니다. 에이전트마다 다른 인터페이스에 맞춰 절차를 다시 짜지 않고도 작업에서 diff, 풀 리퀘스트까지 이어갈 수 있습니다. T3 Code는 무료 오픈 소스입니다. 에이전트 사용료는 각 서비스의 요금제에 따라 별도로 부과됩니다.
버전 기준: 2026년 11월 16일. 안정 버전의 기준은 11월 11일에 출시된 v0.1.9입니다. 이 글은 문서를 바탕으로 작성한 가이드이며, 직접 설치하거나 휴대폰 페어링을 시험한 후기는 아닙니다. 설정 방법은 저장소의 현재 문서를 따릅니다. 더 최근에 추가된 에이전트 기반 인터페이스 맞춤 설정은 아래에서 nightly 기능으로 명시합니다.
T3 Code를 쓰면 기존 코딩 에이전트에 무엇이 더해질까요?
T3 Code는 여러 에이전트가 일할 공통 공간을 제공합니다. Theo Browne의 팀이 만드는 오픈 소스 프로젝트로, macOS·Windows·Linux용 데스크톱 앱, iOS·Android용 모바일 앱, 웹 클라이언트를 제공합니다.
여러 전문가가 각자의 작업대에서 일하는 공방을 떠올리면 이해하기 쉽습니다. 전문가에 해당하는 것이 코딩 에이전트입니다. T3 Code는 이들의 워크스페이스와 대화, 검토 절차를 정리합니다. 자체 모델을 새로 제공하는 대신 에이전트가 이미 사용하는 하네스를 활용합니다. 하네스란 모델에 도구를 연결하고 모델의 동작을 실행하는 소프트웨어입니다.
저장소의 기능 소개에는 스레드 내 모델 전환, 에이전트 간 작업 위임, worktree, diff 검토, 원격 접속이 나와 있습니다. 스레드는 특정 작업에 연결된 대화이고, diff는 어떤 줄이 바뀌었는지 정확하게 보여주는 변경 내역입니다.
도입할 이유는 서로 다른 공급자의 기능을 한 흐름으로 묶을 수 있다는 데 있습니다. Worktree나 원격 접속이 있다는 사실만으로 각 에이전트의 자체 앱에는 그런 기능이 없다고 볼 수는 없습니다. 지금 환경에서 에이전트 하나와 작업 하나를 편하게 처리하고 있다면, 인터페이스를 하나 더 쓰는 데에도 분명한 이점이 있어야 합니다.
기반이 될 에이전트를 고를 때는 AI 코딩 에이전트 비교를, 직접 코드를 편집할 환경을 고를 때는 에디터 비교를 참고하세요.
설치한 뒤 작은 작업부터 실행하기
먼저 코드와 에이전트가 실행될 컴퓨터에서 시작합니다. 휴대폰 앱 설치는 그다음입니다.
- 데스크톱 앱을 설치합니다. 공식 다운로드를 이용합니다. macOS의 패키지 관리자 명령은
brew install --cask t3-code, Windows는winget install T3Tools.T3Code입니다. Linux에는 AppImage와.deb다운로드가 있습니다. 컴퓨터 아키텍처에 맞는 파일을 고릅니다. AppImage는 실행하기 전에 실행 권한을 부여해야 합니다. - 공급자 하나를 연결합니다. Settings → Providers를 열고 실제 작업을 수행할 컴퓨터인 환경을 선택한 뒤, 아래 표에 따라 에이전트를 활성화합니다. 에이전트 설치와 로그인은 그 컴퓨터에서 해야 합니다.
- 기존 Git 프로젝트를 추가합니다. Git은 변경 사항을 기록하는 버전 관리 시스템입니다. 웹 앱에서는 Add project를 사용합니다. 데스크톱에서는 폴더를 사이드바에 끌어다 놓을 수 있습니다. 데스크톱 앱이 실행 중이면
t3 app명령으로 터미널의 현재 디렉터리를 프로젝트로 열 수도 있습니다. - 스레드를 시작하고 작업 위치를 확인합니다. 프로젝트, 모델, 권한 모드를 선택합니다. 코드 변경을 분리하려면 작업을 보내기 전에 New worktree와 기준 브랜치를 고릅니다.
- 검증하기 쉬운 일을 맡깁니다. 예를 들면 “이 기존 유효성 검사 규칙에 대한 테스트를 추가하고, 관련 테스트 명령을 실행한 다음 diff를 설명해 주세요”라고 요청합니다. 변경 사항을 공개하기 전에 수정된 파일과 테스트 출력을 확인합니다.
웹부터 시험하려면 npx t3@latest를 사용할 수 있습니다. Node.js가 필요하며, npm이 선택한 안정 버전이 실행됩니다. 설치된 nightly 빌드를 실행하는 명령은 아닙니다. 설치 가이드에는 Linux 실행 시 유의 사항과 Windows Subsystem for Linux도 설명되어 있습니다. WSL을 사용한다면 선택한 Linux 배포판 안에 공급자 도구를 설치합니다.
지원 에이전트별 연결 방법
공통 원칙은 간단합니다. 에이전트가 실행되는 컴퓨터에서 로그인한 뒤 T3 Code에서 활성화합니다. 노트북에서 로그인했다고 원격 서버의 에이전트까지 설정되는 것은 아닙니다.
CLI는 명령줄 인터페이스를 뜻하며, 터미널에서 실행하는 프로그램입니다. 설치한 에이전트가 표시되지 않으면 공급자 설정의 Binary path에 프로그램 위치를 지정해 T3 Code가 찾을 수 있게 합니다. 공급자 카드에서 호환성 경고와 권장 버전도 확인합니다.
다른 에이전트를 ACP로 연결하려면 Settings → Providers → Add provider → Show more를 엽니다. ACP는 에이전트 소프트웨어와 클라이언트를 연결하는 Agent Client Protocol입니다. Registry 에이전트를 선택해 추가하고 로그인을 완료합니다. 반면 Local ACP command는 호스트에 이미 설치된 실행 파일을 연결하는 옵션입니다. 사용할 수 있는 모델과 옵션은 해당 에이전트가 제공하는 범위에 따라 달라집니다. 자세한 내용은 ACP 설정 가이드를 참고하세요.
Git worktree로 작업을 분리하고 브랜치 전체 검토하기
Worktree는 동일한 Git 저장소에 연결된 별도의 작업 디렉터리입니다. 한 작업이 파일을 수정하는 동안 다른 작업은 다른 디렉터리에서 진행하므로, 둘이 같은 체크아웃을 함께 수정하지 않아도 됩니다.
예를 들어 결제 버그 수정과 문서 업데이트에 각각 별도의 스레드를 만듭니다. 각 스레드에서 New worktree를 선택하고 원하는 기준 브랜치에서 시작합니다. 작업마다 자체 브랜치와 디렉터리가 생기므로 결과도 따로 검토할 수 있습니다.

스레드 작업 흐름에서는 같은 프롬프트를 여러 모델에 보낼 수도 있습니다. 새 스레드의 모델 선택기에서 Shift를 누른 채 모델을 클릭하고, 기준 브랜치를 고른 뒤 전송합니다. 선택한 모델마다 별도의 스레드와 worktree가 시작됩니다. 이 기능에는 Git 프로젝트가 필요합니다.
먼저 해당 턴의 diff로 그 턴에서 바뀐 내용을 살펴보고, 이어서 브랜치 비교로 기준 브랜치 대비 전체 변경 사항을 확인합니다. 프로젝트에 필요한 검사를 실행합니다. 변경이 준비되면 스레드의 Git 작업으로 커밋, 푸시, 풀 리퀘스트 생성을 할 수 있습니다. 풀 리퀘스트는 코드를 병합하기 전에 다른 사람이 검토할 수 있도록 보내는 변경 제안입니다.
Git과 코드 호스팅 서비스 인증은 T3 Code를 실행하는 컴퓨터에서 설정합니다. 로그인한 뒤 Settings → Source control → Rescan을 사용합니다. 소스 관리 가이드에서 인증과 검토 기능을 설명합니다.
Worktree는 파일을 분리할 뿐, 충돌하는 설계 결정을 양립하게 만들어주지는 않습니다. 두 작업이 같은 동작을 서로 다른 방식으로 바꿀 수 있습니다. 디렉터리가 다르다고 데이터베이스, 인증 정보, 외부 서비스까지 격리된다고 가정해서도 안 됩니다. 이런 부분은 프로젝트에서 별도로 설정해야 합니다.
업무 측면의 이점은 작업 상태를 파악하기 위해 오갈 곳이 줄어든다는 것입니다. 대화와 파일, 검토가 하나의 작업 흐름 안에 모입니다. 절차가 구체적으로 달라지는 셈입니다. 다만 여기에는 검증된 시간 절감 수치가 없으며, 에이전트를 더 많이 실행한다고 검토할 일이 사라지는 것도 아닙니다.
호스트는 계속 실행하고 휴대폰에서 작업 이어가기
휴대폰은 호스트 컴퓨터를 제어합니다. 프로젝트와 인증 정보, 실행 중인 에이전트는 계속 호스트에 있습니다.
- 데스크톱 호스트에서 Settings → Sharing & access를 열고 로그인한 뒤 해당 환경의 T3 Connect를 활성화합니다.
- 공식 사이트의 iOS 또는 Android 링크에서 모바일 앱을 설치합니다.
- 휴대폰에서 동일한 T3 Connect 계정으로 로그인하고 환경을 선택합니다.
- 기존 스레드를 열어 대화를 이어가거나 승인 요청을 처리합니다. 외부에서 사용하기 전에 실제로 이용할 네트워크에서 호스트에 접속할 수 있는지 확인합니다.
명령줄로 운영하는 호스트에서는 t3 up으로 T3 Connect, 로컬 네트워크 접속 또는 둘 다를 사용할 수 있으며, T3 Code를 백그라운드 서비스로 실행합니다. 대신 데스크톱 앱의 로컬 서버를 사용한다면 마지막 창을 닫을 때 서버도 종료됩니다. 컴퓨터는 계속 켜져 있어야 하고 접속 가능한 상태여야 합니다.

일반적인 T3 Connect 계정의 호스트 컴퓨터 한도는 3대이며, 휴대폰과 브라우저는 이 한도에 포함되지 않습니다. 로컬 네트워크나 Tailscale을 통한 직접 페어링도 가능합니다. 페어링 URL 자체가 인증 정보이며, 기본 페어링은 폭넓은 권한을 부여합니다. 권한 범위를 좁히거나 접근을 취소하는 방법은 원격 접속 가이드에서 다룹니다.
장시간 이어지는 작업이라면 장기 실행 프로덕션 작업 가이드를 참고하세요. 작업 자체를 어떻게 감독할 것인지는 별도로 다뤄야 할 문제입니다.
인터페이스 맞춤 설정: 안정 버전의 테마와 nightly의 CSS
새 맞춤 설정 기능은 색상 선택을 넘어섭니다. 에이전트가 웹 인터페이스의 모양을 정하는 규칙인 CSS로 인터페이스 스타일을 바꿀 수 있습니다.
여기서는 버전 구분이 중요합니다. 안정 버전 v0.1.9는 해당 버전의 외형 설정 가이드에 따라 팔레트 편집, 테마 가져오기·내보내기, 환경별 테마를 지원합니다. 에이전트 기반 색상 및 레이아웃 맞춤 설정은 11월 14일에 나온 프리릴리스 v0.1.10-nightly.20261114.4669의 기능으로 릴리스 이력에 올라 있습니다.
새 기능이 포함된 빌드에서는 Settings → Appearance → Create theme를 연 뒤 Custom CSS로 들어갑니다. 테마를 내보내면 CSS도 함께 포함됩니다. 또는 서버 컴퓨터에서 실행되는 에이전트에 채팅 헤더 높이를 늘리는 것처럼 구체적인 변경을 요청할 수 있습니다. 이때 해당 스레드는 Full access를 사용해야 합니다.
적용 범위에도 유의해야 합니다. 모바일에는 별도의 외형 설정이 있습니다. 환경별 테마는 app.t3.codes 및 다른 연결에는 적용되지 않습니다. CSS 클래스 이름은 릴리스 사이에 바뀔 수 있으므로, 현재 가이드에서는 비교적 안정적으로 보이는 data- 속성을 선택자로 사용하는 것을 권장합니다. 테마 CSS를 통한 외부 파일 로딩은 제한됩니다.
맞춤 설정 때문에 필요한 조작 요소가 사라지면 다른 테마를 선택하거나 서버에서 t3 theme set t3-chat을 실행합니다. 현재 외형 설정 문서에 기능과 복구 방법이 나와 있습니다. 처음에는 가독성을 높이는 변경 하나만 적용한 뒤, diff와 승인 관련 조작 요소가 여전히 보이는지 확인하는 것을 권합니다.
먼저 시도해 볼 작업 흐름 5가지
아래는 실제로 시도해 볼 만한 활용법이며, 측정된 고객 성과는 아닙니다.
T3 Code를 기반으로 만들 만한 서비스 2가지
가장 유망한 기회는 저장소별 worktree 설정 키트입니다. 팀은 작업 디렉터리마다 의존성, 로컬 설정, 테스트 데이터베이스, 개발 서버 포트를 반복 가능하게 준비하는 방법에 비용을 지불할 수 있습니다. 최소한으로 유용한 버전은 한 팀의 저장소를 지원하고, 사전 조건을 검사하며, 정리 명령을 제공하는 형태일 것입니다. 작업을 시작하고 검토하는 인터페이스는 계속 T3 Code가 맡습니다.
기본 작업 흐름에 관심이 있다고 해서 이 제품에 대한 수요까지 입증되는 것은 아닙니다. 사업성을 시험하려면 팀이 새 worktree를 사용할 수 있게 만드는 데 반복적으로 시간을 낭비하는지 확인해야 합니다. 어려운 점은 저장소마다 구성이 다르다는 것입니다. 범용 래퍼는 쉽게 모방할 수 있지만, 안정적인 설정에 필요한 지식은 기술 스택마다 다릅니다. 바로 이 구체성이 가장 유망한 기회인 이유이기도 합니다.
두 번째 선택지는 공급자 온보딩 및 호환성 키트입니다. 에이전시나 사내 도구 팀은 이를 통해 각 호스트에 어떤 에이전트 도구가 설치되어 있는지 확인하고, 인증 정보를 수집하지 않으면서 인증 과정을 안내하며, 작동이 확인된 구성을 문서화할 수 있습니다. MVP는 로컬 진단 보고서와 팀 설정 가이드를 묶은 형태가 될 수 있습니다. 소규모 구축 서비스로 먼저 제공한 뒤 소프트웨어로 발전시키는 방식입니다.
관련 정보를 찾아본다는 사실만으로 유료 설정 키트를 원한다고 볼 수는 없습니다. T3 Code에는 이미 공급자 설정, 호환성 경고, 업데이트 제어 기능이 있으므로 이를 복제하는 제품은 매력이 약합니다. 기회를 찾으려면 팀의 환경을 재현 가능하게 만들고 온보딩 절차를 정립하는 데 초점을 맞춰야 합니다. 공급자가 바뀔 때마다 지속적인 유지보수도 필요합니다.
T3 Code를 도입할 만한 때는 언제일까요?
여러 에이전트를 아우르는 공통 작업 흐름, 서로 분리된 여러 작업, 다른 기기에서의 접속이 필요할 때 도입합니다. 이 중 어느 것도 반복되는 문제를 해결해 주지 못한다면 기존 환경을 유지합니다.
제약은 실무적입니다. 공급자 인증과 사용 한도는 그대로 남습니다. 원격 호스트는 계속 이용 가능한 상태여야 합니다. Worktree에도 의존성 설치와 테스트가 필요합니다. 자동 생성된 풀 리퀘스트 설명은 코드 검토를 대신하지 못합니다. 현재 main 브랜치의 문서에는 안정 버전 다운로드보다 새로운 기능이 설명되어 있을 수 있고, nightly 맞춤 설정은 관리할 요소를 하나 더 늘립니다.
처음 사용하는 날에는 위험이 낮은 변경 하나를 전체 과정에 통과시켜 봅니다. 에이전트 하나를 연결하고, 저장소를 열고, worktree를 만들고, 검사를 실행한 다음 diff를 살펴보고 풀 리퀘스트를 준비합니다. 이 흐름이 잘 작동한 뒤에 휴대폰 접속을 추가합니다. 전체 작업을 관리하기가 더 쉬워졌다면 T3 Code를 계속 사용하면 됩니다.
T3 Code Nightly를 써야 할까요?
처음 설정할 때는 안정 버전을 기준으로 삼습니다. Nightly는 프리릴리스이며, 새로 추가된 에이전트 기반 CSS 맞춤 설정이 꼭 필요한 경우에 고려할 만합니다. 이 가이드는 안정 버전 v0.1.9와 해당 기능이 명시된 11월 14일 nightly를 구분합니다.
T3 Code Mobile은 휴대폰에서 에이전트를 실행하나요?
휴대폰은 다른 컴퓨터의 T3 Code 서버에 연결됩니다. 에이전트를 실행하고 프로젝트를 보관하는 곳은 해당 호스트입니다. 호스트를 계속 켜두고 접속 가능한 상태로 유지한 뒤, T3 Connect 또는 적절한 페어링 방식으로 연결합니다.
T3 Code는 Windows와 Linux에서도 작동하나요?
네. Windows용 데스크톱 설치 프로그램과 패키지 관리자 옵션이 있습니다. Linux에는 지원 아키텍처용 AppImage와 Debian 패키지가 있습니다. WSL을 사용한다면 선택한 배포판 안에서 에이전트를 설정합니다.
웹 브라우저에서 T3 Code를 사용할 수 있나요?
네. 웹 클라이언트가 사용자의 T3 Code 서버에 연결됩니다. 호스팅된 app.t3.codes 클라이언트에는 HTTPS 엔드포인트가 필요합니다. 클라이언트 자체가 접속 불가능한 호스트를 접속 가능하게 만들어주지는 않습니다.
팀의 에이전트 워크스페이스에 반복 가능한 설정이 필요하다면, 이를 뒷받침할 프로덕션 워크플로 구축을 도와드릴 수 있습니다.
- 게시일
- 카테고리
- Build
- 언어







