T3 Code란? 설치 방법, Claude Code·Codex 연결, 서드파티 API Key 설정과 자주 나는 오류 (0.1.9 실제 테스트)

T3 Code는 pingdotgg가 공개한 오픈소스 코딩 에이전트 콘솔입니다. 자체 모델 없이, 컴퓨터에 이미 설치된 Claude Code, Codex, Cursor 등의 CLI를 조작합니다. Linux에서 T3 Code 0.1.9를 테스트해 설치 명령, Claude Code와 Codex를 AICodeWith API Key에 연결해 T3 Code가 조작하도록 하는 설정, t3 thread 명령으로 두 에이전트를 실제로 돌린 결과, 실제로 만난 오류와 해결 방법을 정리했습니다.

6 分钟阅读
T3 Code란? 설치 방법, Claude Code·Codex 연결, 서드파티 API Key 설정과 자주 나는 오류 (0.1.9 실제 테스트)

T3 Code는 pingdotgg 팀(Theo의 팀)이 공개한 오픈소스 "코딩 에이전트 컨트롤 패널"입니다. 모델도 아니고 하네스도 아닙니다. 이미 설치하고 로그인한 Claude Code, Codex, Cursor CLI, OpenCode 같은 도구를 조작하고, 그 위에 데스크톱·웹·모바일 화면을 얹습니다. 저장소는 MIT 라이선스이며 2026년 11월 12일 기준 GitHub 스타는 약 5.7만 개입니다. X 검색 집계에 따르면 최근 7일 동안 "T3 Code / t3code"를 언급한 게시물은 하루 약 800~1,100건이었습니다.

2026년 11월 12일(베이징 시간, UTC+8), Linux x64 머신에서 그날 npm에 올라와 있던 T3 Code 0.1.9를 테스트했습니다. 클라이언트는 Claude Code 2.1.319와 Codex CLI 0.167.0이고, 둘 다 AICodeWith API Key에 연결했습니다. 아래의 단계, 출력, 오류는 모두 이 테스트에서 실제로 나온 것입니다.

Create API Key →

먼저 결론

질문답
T3 Code란?코딩 에이전트를 한곳에서 다루는 콘솔(데스크톱 앱, 웹, 모바일). 설치된 Claude Code, Codex 등의 CLI를 호출합니다. 모델은 제공하지 않고 토큰을 재판매하지도 않습니다.
설치 방법은?macOS / Linux는 공식 install.sh, Windows는 install.ps1을 씁니다. 한 번만 써 보려면 npx t3@latest. 명령은 아래 "T3 Code 설치"에 있습니다.
구독 대신 서드파티 API Key를 쓸 수 있나?쓸 수 있습니다. T3 Code는 각 CLI의 설정을 그대로 씁니다. Claude Code는 ~/.claude/settings.json, Codex는 ~/.codex/config.toml을 읽습니다. CLI가 단독으로 동작하면 T3 Code에서도 동작합니다.
테스트 결과T3 Code는 Claude를 "Custom API endpoint"(인증 완료), Codex를 ready로 감지했습니다. 같은 작업(버그 수정과 테스트 추가)에서 Claude Code 쪽은 약 30.4초, Codex 쪽은 약 32.5초가 걸렸고 테스트는 모두 통과했습니다.
가장 주의할 점공식 문서에 따르면 새 스레드의 기본 권한은 Full access여서, 명령 실행과 파일 수정이 확인 없이 진행됩니다. 실제 저장소에서 쓰기 전에 기본값을 Supervised나 Auto로 바꾸세요.

T3 Code란

T3 Code 공식 FAQ에 따르면 하네스는 LLM을 에이전트로 만드는 계층입니다. 모델에 도구를 주고, 실행하고, 결과를 돌려줍니다. Claude Code와 Codex가 이 계층에 해당합니다. T3 Code는 이 계층이 아니라 이런 하네스를 쓰는 쪽이며, 하네스 없이는 동작하지 않습니다. FAQ의 비유로는 LLM이 셰프, 하네스가 주방, T3 Code는 "주방을 직접 가져오는" 레스토랑입니다.

주요 특징(공식 사이트와 GitHub README 기준):

  • 내 구독 그대로 사용: 이미 쓰고 있는 Claude Code, Codex, Cursor, Grok Build, OpenCode, Antigravity 등의 로그인을 그대로 씁니다. T3 Code는 토큰을 재판매하지 않습니다.
  • 여러 에이전트를 한곳에서: 스레드마다 다른 provider와 모델을 고를 수 있습니다. 스레드는 각자의 브랜치에 쓰고, 버튼 하나로 커밋, 푸시, PR 생성까지 합니다.
  • 원격과 모바일: 아무 머신에서나 t3 up을 실행한 뒤 모바일 앱이나 브라우저로 접속합니다.
  • 완전한 오픈소스: MIT 라이선스라 fork해서 고치고 직접 호스팅할 수 있습니다.

Claude Code와 Codex를 오가며 작업한다면 "Claude Code 작업을 Codex로 넘기는 방법"도 참고하세요. T3 Code는 이런 전환을 한 화면에서 할 수 있게 해 줍니다.

T3 Code 설치

공식 방법(install.md 기준):

bash
# macOS / Linux: t3 명령을 ~/.local/bin에 설치
curl -fsSL https://t3.codes/install.sh | sh

# 설치 없이 한 번만 실행 (Node.js 필요)
npx t3@latest
powershell
# Windows PowerShell
irm https://t3.codes/install.ps1 | iex

데스크톱 앱은 GitHub Releases에서 받거나 패키지 매니저로 설치합니다. Windows는 winget install T3Tools.T3Code, macOS는 brew install --cask t3-code, Arch는 yay -S t3code-bin입니다.

자주 쓰는 명령:

하려는 일명령
서버를 시작하고 웹 화면 열기t3
브라우저 없이 서버만 시작 (서버, SSH)t3 serve
휴대폰이나 다른 기기에서 접속t3 up
백그라운드 상주t3 service install
업데이트t3 update
명령줄에서 스레드 시작, 메시지 전송, 결과 확인t3 thread start / send / show

이번에는 npx -y t3@0.1.9 serve --no-browser로 시작했습니다. 약 20초 뒤(npx 첫 다운로드 포함) T3 Code server is ready.와 Connection string: http://localhost:3773이 출력되었고, 모바일 앱용 페어링 토큰과 QR 코드도 함께 나왔습니다.

1단계: Claude Code와 Codex를 단독으로 먼저 동작시키기

공식 문서의 전제는 분명합니다. 스레드를 시작하기 전에 provider를 하나 이상 설치하고 로그인해 두어야 합니다. 구독이라면 각각 claude auth login과 codex login을 실행합니다. 서드파티 API Key라면 각 CLI의 전역 설정만 써 두면 T3 Code가 그대로 씁니다.

Claude Code: 전역 ~/.claude/settings.json (자세한 내용은 "Claude Code 서드파티 API 설정"):

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "내 AICodeWith API Key"
  }
}

Codex: 전역 ~/.codex/config.toml (설치는 "Codex 설치 가이드", 항목 설명은 "Codex config.toml 설정 가이드"):

toml
model_provider = "aicodewith"
model = "gpt-6.1-sol"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "내 AICodeWith API Key"

먼저 터미널에서 각각 단독으로 확인합니다. 둘 다 답이 돌아오면 됩니다:

bash
claude -p "Reply with exactly: pong"
codex exec --skip-git-repo-check "Reply with exactly: pong"

이번 테스트에서는 둘 다 pong을 반환했고, Claude Code는 약 3.0초, Codex는 약 3.7초 걸렸습니다. 이 단계가 안 되면 T3 Code에서도 안 됩니다. 문제 해결은 항상 여기서 시작하세요.

Create API Key →

2단계: T3 Code에서 provider 상태 확인

t3나 t3 serve를 실행하면 T3 Code가 PATH에 있는 CLI를 자동으로 감지합니다. 웹 화면의 Settings → Providers에서 provider별 상태를 볼 수 있습니다. 이번에 감지된 내용:

Provider버전상태인증감지된 모델(일부)
Claude (인스턴스 id claudeAgent)2.1.319readyauthenticated, 유형 customEndpoint (Custom API endpoint)claude-opus-5-5, claude-sonnet-5-5, claude-fable-5-2 등
Codex (인스턴스 id codex)0.167.0readyunknown (API Key 방식은 ChatGPT 로그인을 거치지 않으므로 정상)gpt-6.1-sol, gpt-6.1-terra, gpt-6-sol 등

즉 T3 Code는 Claude Code가 사용자 지정 API 엔드포인트를 쓴다는 것을 알아봤고, 모델 목록도 설정한 서비스에서 가져왔습니다.

전역 설정 외에 T3 Code는 다중 인스턴스도 지원합니다. 한 머신에서 구독과 API Key를 함께 쓸 때 유용합니다:

  • Settings → Providers에서 provider 인스턴스를 추가합니다. 공식 문서에 따르면 인스턴스마다 API Key나 사용자 지정 base URL 같은 환경 변수를 따로 둘 수 있습니다. 비밀 값은 sensitive로 표시하면 저장 후 다시 표시되지 않습니다.
  • Claude는 인스턴스마다 다른 CLAUDE_CONFIG_DIR을 지정할 수 있습니다. 예를 들어 기본 디렉터리는 구독 계정용으로 두고, API Key용으로 ~/.claude_api를 만듭니다. 설정 디렉터리가 다른 스레드끼리는 서로 격리됩니다.
  • CLI를 찾지 못하면(nvm, mise에서 흔함) provider 설정의 Binary path에 경로를 넣습니다.

3단계: 스레드에서 실제 작업 돌리기

웹 화면에서는 New thread를 누르고 provider와 모델을 고르면 됩니다. 브라우저가 없는 서버에서는 t3 thread 명령을 쓸 수 있으며, 이번 테스트도 이 방식입니다:

bash
cd your-project
t3 project add .
t3 thread start . "calc.py의 add 함수에 버그가 있습니다. 고치고, unittest로 test_calc.py를 추가한 뒤 테스트를 실행해 결과를 알려 주세요." \
  --provider claudeAgent --model claude-opus-5-5 --wait

--wait는 에이전트가 작업을 마칠 때까지 기다렸다가 답변을 출력합니다. Codex는 --provider codex --model gpt-6.1-sol로 바꿉니다. 테스트 프로젝트는 파일 하나이고, add는 일부러 return a-b로 써 두었습니다.

경로실제 소요 시간결과
T3 Code → Claude Code (claude-opus-5-5)약 30.4초return a+b로 수정, unittest 6개 추가, Ran 6 tests ... OK
T3 Code → Codex (gpt-6.1-sol)약 32.5초a + b로 수정, 5개 추가, 5개 모두 통과(OK). 끝난 뒤 같은 폴더에서 python3 -m unittest test_calc를 다시 실행해도 OK

Claude Code는 답변에서, 테스트 파일을 쓴 처음 두 번은 들여쓰기가 깨져 IndentationError가 났고 세 번째에 스크립트로 파일을 생성해 통과했다고 설명했습니다. 에이전트의 자체 보고는 참고하되, 최종 판단은 직접 다시 돌린 테스트로 하세요.

기본 권한은 Full access: 먼저 바꾸세요

이번 테스트에서 가장 강조하고 싶은 점입니다. 공식 Permission modes 문서에 따르면 새 스레드의 초기 기본값은 Full access로, 명령 실행과 파일 수정 모두 묻지 않습니다. 프로세스 목록을 보니 T3 Code는 Claude Code를 --permission-mode=bypassPermissions로 실행하고 있었습니다.

Settings → Threads → New threads → Permissions에서 기본값을 바꾸세요:

모드동작
Supervised명령 실행과 파일 수정 전에 승인을 요청
Auto-accept edits파일 수정은 자동 승인, 다른 작업은 여전히 승인을 요청할 수 있음
Autoprovider의 자동 검토로 일상적인 작업은 허용하고 나머지는 물어봄
Full access전혀 묻지 않음

실제 저장소에서는 최소한 Supervised나 Auto를 쓰세요. 팀 머신에서는 managed policy로 선택 가능한 모드의 상한을 정할 수 있습니다.

자주 나는 오류와 해결 방법

오류 / 증상원인해결 방법
No T3 Code project matches '.'. Pass a project id or a path inside a project.현재 폴더가 아직 T3 Code 프로젝트가 아님 (이번에 겪음)먼저 t3 project add .를 실행하거나, 서버 시작 시 --auto-bootstrap-project-from-cwd를 붙임
Provider instance "claude" is disabled for project ...--provider에 인스턴스 id가 아닌 값을 넣음. claude로 이 오류가 났고 claudeAgent로 바꾸니 통과Settings → Providers에 보이는 인스턴스 id를 쓰고, provider가 활성화되어 있는지도 확인
provider가 미설치 / 찾을 수 없음으로 표시CLI가 서버 프로세스의 PATH에 없음 (nvm, mise에서 흔함)provider 설정에서 Binary path를 지정하거나 CLI를 전역으로 설치
스레드에서 401 / 인증 실패Key가 틀렸거나 만료됨, 또는 설정 오류먼저 터미널에서 claude -p / codex exec를 단독 실행한 뒤 "Codex 401 점검"에 따라 Key, base_url, 로그인 상태를 차례로 확인. 터미널에서 되면 T3 Code로 돌아감
429 Too Many Requests속도 제한 또는 사용 기간 창서버 응답에 따라 기다리거나 동시 실행 수를 줄임. 자세한 내용은 "Codex 429 해결 방법"
t3가 이미 서버가 실행 중이라고 표시데이터 디렉터리 하나에 서버는 하나만실행 중인 서버에 접속하거나, 별도 서버는 다른 --base-dir로 실행
휴대폰이나 외부 네트워크에서 접속 안 됨원격 연결 문제 (@TheElricLi의 사용자 피드백: 밖에서는 휴대폰도 iPad도 접속이 안 됨)공식 문서는 T3 Connect 문제 해결 페이지를 안내하며, Tailscale로 직접 경로를 만드는 방법도 있음

401과 429의 자세한 점검 절차는 "Codex 401 Unauthorized 해결 방법"과 "Codex 429 Too Many Requests 해결 방법"을 참고하세요. 원격 연결 관련 사용자 피드백은 @TheElricLi의 게시물에서 가져왔습니다.

FAQ

T3 Code에서 Claude Code 구독을 쓸 수 있나요?

공식 FAQ에 따르면 가능합니다. 로그인된 Claude Code를 호출하므로 구독은 평소처럼 쓰입니다. FAQ는 T3 Code가 Claude Code, Codex, Google Antigravity의 이용 약관 범위 안에 있다고도 밝히지만, 이는 T3 Code 측의 설명입니다.

서드파티 API Key를 T3 Code에 따로 입력해야 하나요?

아닙니다. CLI 전역 설정만 써 두면 되고, 이번 테스트도 그렇게 돌렸습니다. 구독과 API Key를 함께 쓰려면 provider 다중 인스턴스나 별도의 CLAUDE_CONFIG_DIR로 나눕니다.

Codex 데스크톱 앱이나 Claude Desktop과 무엇이 다른가요?

그 둘은 각각 한 회사의 에이전트만 다룹니다. T3 Code는 여러 회사의 에이전트를 한 화면에 모으고 원격 접속과 모바일 앱을 더했습니다. 대신 관리할 서버 프로세스가 하나 늘어납니다.

GUI가 없는 서버에서도 쓸 수 있나요?

네. t3 serve로 시작해 t3 thread 명령을 쓰거나, 다른 기기에서 t3 up이나 페어링 링크로 접속하면 됩니다.

Create API Key →

자료

相关文章

UI SDK는 무엇이고 어떻게 쓰나? Vercel과 shadcn이 Agent를 위해 만든 동작 라이브러리를 Claude Code / Codex / Cursor에서 설치하고 실측하기 (0.1.0-beta.1)

UI SDK는 무엇이고 어떻게 쓰나? Vercel과 shadcn이 Agent를 위해 만든 동작 라이브러리를 Claude Code / Codex / Cursor에서 설치하고 실측하기 (0.1.0-beta.1)

UI SDK는 Vercel이 2026년 11월 12일에 공개한 Agent용 동작(behaviors) 라이브러리이며, 버전은 0.1.0-beta.1입니다. 동작은 프레임워크에 의존하지 않는 @ui-sdk/core에 있고, React, Vue, Svelte, Solid, Web Components 어댑터가 렌더링합니다. 공식 문서를 따라 무엇인지, 어떻게 설치하는지, Claude Code / Codex / Cursor에 skill을 어떻게 넣는지 정리하고, 테스트 머신에서 실제로 실행한 명령, 소요 시간, 출력을 기록합니다.

AWS Emulator란? 설치 방법과 Claude Code / Codex로 AWS 앱을 로컬에서 테스트하는 법 (1.0.322 실측)

AWS Emulator란? 설치 방법과 Claude Code / Codex로 AWS 앱을 로컬에서 테스트하는 법 (1.0.322 실측)

AWS Emulator는 AWS 공식 로컬 AWS 에뮬레이터로, 2026년 11월 11일(미국 시간)부터 정식 출시(GA)되었습니다. 추가 서비스 요금이 없고 소스가 공개되어 있으며 AWS 계정 없이 200개가 넘는 서비스를 다룹니다. 이 글에서는 Debian 13에서 1.0.322를 직접 테스트해 설치 명령, AWS CLI를 로컬 endpoint로 향하게 해 S3 버킷과 DynamoDB 테이블을 만드는 과정, 실제로 만난 오류, 그리고 Claude Code·Codex·Cursor가 에뮬레이터를 상대로 코드를 짜고 테스트하게 하는 방법을 정리합니다.

Claude Code / Codex / Cursor Agent Hooks 설정 방법? PreToolUse 비교, 최소 스크립트와 fail-open 실측

Claude Code / Codex / Cursor Agent Hooks 설정 방법? PreToolUse 비교, 최소 스크립트와 fail-open 실측

Instructions, AGENTS.md, skills는 모델이 무시할 수 있는 제안이고, hooks는 harness가 고정된 시점에 실행하는 결정론적 스크립트다. 이 글에서는 Claude Code, Codex, Cursor의 PreToolUse(또는 동등한 이벤트) 설정 경로, 이벤트 이름, exit 2 / deny, fail-open과 fail-closed를 비교하고, Claude Code에서 실측한 최소 인터셉트 스크립트를 제공한다.