T3 Code 설정: Claude Code, Codex와 API 게이트웨이

Claude Code와 Codex를 한 화면에서 사용하면서 수동으로 작업을 넘기는 횟수를 줄이려면 T3 Code를 선택합니다. 먼저 프로바이더 하나의 CLI를 설치한 다음 인증하거나, API를 사용하는 별도 인스턴스를 구성합니다. 에이전트에 코드 변경을 허용하기 전에 저장소의 파일을 실제로 읽는지 확인합니다.

2026-11-12 기준 최신 안정 버전은 v0.1.9입니다. 11월 11일에 출시되었습니다. Use T3 Code in another app (MCP) 기능은 11월 9일 출시된 v0.1.8에서 추가되었습니다. 유지관리자용 미리 보기 버전보다 안정 버전으로 시작하는 편이 좋습니다.

T3 Code는 언제 사용하는 것이 좋습니까?

에이전트 사이에서 작업을 자주 넘기거나, 프로젝트의 여러 작업을 따로 진행하거나, 원격으로 진행 상황을 살펴볼 때 T3 Code를 선택합니다. 터미널 하나에서 에이전트 하나만 사용하고 이런 기능이 거의 필요 없다면 기존 CLI를 유지합니다.

T3 Code는 에이전트를 제어하는 인터페이스이지 새로운 모델이 아닙니다. 에이전트의 실행 환경인 하네스가 도구를 제공하고 실행합니다. T3는 데스크톱, 웹, 모바일 인터페이스에서 이러한 하네스를 제어합니다.

공식 프로젝트는 Claude Code, Codex, Cursor, Grok Build, OpenCode, Antigravity, fx 등을 지원합니다. 무료이며 MIT 라이선스로 배포됩니다. 모델 프로바이더에 내는 비용은 그대로 발생합니다. T3는 토큰을 재판매하지 않으며 구독에 별도의 사용 한도를 추가하지도 않습니다.

Claude Desktop이나 Codex 앱을 사용 중이라면 여러 에이전트를 한 화면에 모았을 때 반복 작업이 줄어드는지 판단합니다. 인터페이스 선택만 고민이라면 Codex CLI, 데스크톱 앱, IDE 확장 기능 비교를 참고합니다.

에이전트를 먼저 설치한 뒤 T3 Code를 설치합니다

T3가 에이전트를 실행할 컴퓨터에서 에이전트를 설치하고 인증합니다. 노트북에만 CLI를 설치해도 별도 서버의 설정까지 완료되는 것은 아닙니다.

작업 인계 예제에는 두 프로바이더가 모두 필요합니다. 하나만 시험하려면 설치한 프로바이더로 파일 읽기를 확인하고, 인계 단계로 넘어가기 전에 멈춥니다.

아래 터미널 예제는 Linux 또는 Apple Silicon 기반 macOS의 Bash를 사용합니다. README.md가 있고 민감한 테스트 데이터가 없는 저장소로 시작합니다.

Claude Code는 Anthropic의 네이티브 설치 안내에 따라 설치합니다.

curl -fsSL https://claude.ai/install.sh | bash
claude --version

구독을 사용하는 인스턴스에서는 claude auth login을 실행하고 브라우저에서 로그인을 마칩니다. API만 사용한다면 구독 로그인은 건너뜁니다. 스레드를 시작하기 전에 아래에서 설명하는 별도 게이트웨이 설정을 완료합니다.

Codex의 공식 CLI 안내는 다음 독립 실행형 설치 프로그램을 제공합니다.

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex login

T3는 t3.codes 또는 해당 사이트에 연결된 GitHub 저장소에서 받습니다. 도메인 철자를 확인해야 합니다. 공식 도메인은 t3.codes이며 t33.codes가 아닙니다.

로컬 웹 인터페이스를 사용하려면 다음 명령을 실행합니다.

curl -fsSL https://t3.codes/install.sh | sh
t3

t3 명령은 서버를 시작하고 로컬 웹 앱을 엽니다. 설치 프로그램이 해당 디렉터리를 PATH에 추가하라고 안내하면 그 지시에 따릅니다.

Node.js와 npm이 이미 준비되어 있다면 npx t3@latest로 한 번 실행해 볼 수 있습니다. macOS 데스크톱 앱은 터미널에서 brew install --cask t3-code를 실행해 설치합니다.

Windows에서는 먼저 프로바이더의 Windows 설치 안내에 따라 에이전트를 설치합니다. 그런 다음 PowerShell에서 T3를 설치합니다.

irm https://t3.codes/install.ps1 | iex
t3

Settings → Providers를 열고 저장소가 있는 환경을 선택합니다. 그 환경에서 프로바이더를 활성화합니다. 기존 Codex CLI 로그인을 재사용하려면 Codex 인스턴스를 추가하고 Configure manually를 선택합니다.

프로바이더가 보이지 않으면 해당 환경의 컴퓨터에서 설치 상태와 로그인을 확인합니다. T3가 PATH에서 실행 파일을 찾지 못한다면 Binary path에 그 파일의 경로를 지정합니다. 환경별 설정은 설치 안내에서 설명합니다.

파일 읽기를 확인하고 스레드를 Codex로 넘깁니다

읽기 전용 작업으로 선택한 프로바이더, 저장소, 도구 실행을 확인합니다. 코드 변경 시험은 그다음에 진행합니다.

저장소를 프로젝트로 추가하고 New thread를 엽니다. 인계 예제에서는 Claude를 선택하고 메시지 입력 영역에서 권한 모드를 명시적으로 Supervised로 설정합니다. 이 모드는 명령과 파일 변경에 대한 승인을 요청합니다. 승인하기 전에 요청 내용을 검토합니다.

다음 메시지를 보냅니다. 파일 변경이나 테스트 실행 없이 README.md의 첫 번째 제목과 문서에 적힌 테스트 명령을 찾도록 요청합니다.

Read README.md from this repository.
Quote its first heading and identify the documented test command.
If no test command is documented, say so.
Do not modify files or run tests.

최종 답변만 보지 말고 기록된 도구 활동을 확인합니다. 에이전트가 올바른 파일을 읽고 실제 제목을 반환했는지 점검합니다. 파일을 읽지 않은 채 그럴듯한 설명만 내놓았다면 이 확인을 통과한 것이 아닙니다.

응답이 끝나면 모델 선택 메뉴를 열고 Codex 인스턴스와 사용 가능한 모델을 선택합니다. 단축키는 macOS에서 Cmd+Shift+M, Windows와 Linux에서 Ctrl+Shift+M입니다.

이어서 다음 메시지를 보냅니다. 이전 답변을 저장소 파일과 대조하고 테스트 명령에 추가 준비가 필요한지 확인하도록 요청합니다.

Review the previous answer against the repository files.
Check whether the proposed test command needs extra setup.
Do not modify files or run tests.

기대하는 결과는 동일한 T3 스레드에서 Codex가 후속 작업을 수행하고, 직접 파일을 확인한 도구 활동이 기록되는 것입니다. 이는 동작 확인 예제이며 어느 모델이든 결함을 찾아낼 것이라는 주장은 아닙니다.

T3의 작업 인계 문서는 전달되는 대화 맥락과 프로바이더의 전체 네이티브 세션을 구분합니다. 인계할 때 이전 프로바이더의 추론 내용, 도구 호출 상태, 첨부 파일은 복사하지 않습니다. 중요한 제약은 다시 전달하고 필요한 자료는 다시 첨부합니다.

여러 번 작업을 넘겨도 유지해야 하는 규칙은 프로젝트 지침에 저장합니다. 장기적으로 유지할 맥락은 코딩 에이전트 메모리 가이드에서 설명합니다.

별도 Claude 인스턴스로 API 게이트웨이를 연결합니다

Anthropic 호환 게이트웨이는 Claude 인스턴스의 환경 변수로 설정합니다. 인증 정보를 Launch arguments에 붙여 넣거나 평소 구독에 사용하는 인스턴스를 바꾸지 않습니다.

설정 디렉터리를 따로 만듭니다

기본 Claude 설정은 그대로 유지합니다. Bash에서 OpenRouter 인스턴스용 디렉터리를 만듭니다.

mkdir -p "$HOME/.claude_openrouter"

그 디렉터리에 저장된 Anthropic 로그인 정보가 이미 있다면 같은 디렉터리를 사용하는 Claude 세션을 엽니다.

CLAUDE_CONFIG_DIR="$HOME/.claude_openrouter" claude

해당 세션 안에서 /logout을 실행한 뒤 종료합니다. 그다음 게이트웨이 토큰을 추가합니다. 저장된 로그인 정보가 없는 새 디렉터리에서는 로그아웃 단계를 건너뜁니다. T3 문서는 저장된 로그인 인증 정보가 게이트웨이 토큰과 충돌할 수 있다고 경고합니다.

Settings → Providers에서 Claude OpenRouter라는 이름의 Claude 인스턴스를 추가합니다. Binary path에는 claude를, CLAUDE_CONFIG_DIR path에는 ~/.claude_openrouter를 지정합니다.

T3의 공식 OpenRouter 설정 안내에 따라 해당 인스턴스의 Environment variables에 다음 값을 입력합니다.

변수	값
ANTHROPIC_BASE_URL	https://openrouter.ai/api
ANTHROPIC_AUTH_TOKEN	본인의 OpenRouter API 키를 입력하고 Sensitive로 표시합니다
ANTHROPIC_API_KEY	명시적으로 빈 값으로 설정합니다

ANTHROPIC_API_KEY 항목은 유지하되 값은 비워 둡니다. 값으로 따옴표를 입력하지 않습니다. 실제 토큰은 민감한 인증 정보로 표시한 필드에만 입력하고, 채팅 메시지나 저장소 파일에는 넣지 않습니다.

이 인스턴스용으로 새 스레드를 만듭니다. 기존 Claude 스레드에서는 설정 디렉터리가 같은 Claude 인스턴스 사이에서만 전환할 수 있습니다.

정확한 모델 ID를 선택하고 청구된 요청을 확인합니다

T3에서 게이트웨이의 전체 모델 ID를 선택합니다. Claude 별칭이 원하는 모델을 자동으로 선택할 것이라고 가정하지 않습니다.

2026-11-12 기준 OpenRouter의 예시 모델은 anthropic/claude-sonnet-5.5입니다. Claude 인스턴스 설정에 없다면 Add custom model로 추가합니다. 그런 다음 채팅의 모델 선택 메뉴에서 해당 모델을 선택합니다.

ANTHROPIC_DEFAULT_*_MODEL 변수는 sonnet과 같은 Claude Code 별칭에 모델을 연결합니다. T3에서 명시적으로 선택한 모델을 덮어쓰지는 않습니다. 사용자 지정 모델은 기본 제공 모델보다 추론 강도, 사고 모드, 컨텍스트를 조정하는 설정이 적을 수 있습니다.

게이트웨이 인스턴스로 새 스레드를 시작하고 README.md 테스트를 반복합니다. OpenRouter 활동 대시보드에서 해당 요청과 모델을 찾습니다. 그곳에서 사용량과 청구 금액을 확인합니다. 올바른 답변이 나왔더라도 게이트웨이에 대응하는 기록이 없다면 청구 경로를 확인한 것이 아닙니다.

OpenRouter도 Claude Code 연동 안내에서 같은 엔드포인트와 인증 변수를 설명합니다. 이 요청은 OpenRouter 크레딧으로 결제하며, T3의 추가 토큰 사용 한도를 쓰는 것이 아닙니다.

2026-11-12 기준 OpenRouter가 Claude Code와의 호환성을 보장하는 범위는 Anthropic이 직접 제공하는 프로바이더로 한정됩니다. 이번 시험에서는 해당 안내의 권장대로 Anthropic 1P를 우선하도록 설정합니다.

BetterToken의 Claude Code 문서는 Anthropic 기본 URL로 https://bettertoken.ai를 지정하며 /v1은 붙이지 않습니다. 민감한 인증 정보용 ANTHROPIC_AUTH_TOKEN 필드에 본인의 BetterToken 키를 입력합니다. ANTHROPIC_API_KEY는 비워 두고 ~/.claude_bettertoken과 같은 별도 디렉터리를 사용합니다.

2026-11-12 기준 BetterToken 카탈로그에는 claude-sonnet-5-5가 있습니다. 이 정확한 ID를 선택하고 큰 작업을 시작하기 전에 파일 읽기와 청구 확인을 반복합니다. 별도로 과금되는 API 사용이므로 현재 요금을 확인합니다.

로컬 라우터를 사용한다면 또 다른 별도 Claude 인스턴스를 만듭니다. T3가 실행되는 컴퓨터에서 라우터에 접근할 수 있는지 확인합니다. 추가 라우팅 과정은 Claude Code Router 설정 가이드에서 설명합니다. 이 Anthropic 변수들은 Claude 프로바이더를 설정하며, Codex 설정에 적용하는 절차가 아닙니다.

MCP로 다른 어시스턴트에서 T3 Code를 사용합니다

외부 어시스턴트가 T3의 프로젝트와 스레드에 접근해야 할 때 MCP를 사용합니다. T3 안에서 Claude와 Codex를 일반적으로 전환할 때는 이 설정이 필요하지 않습니다. 먼저 외부 어시스턴트 자체의 모델 인증이 정상적으로 작동하는 상태를 준비합니다.

외부 에이전트 안내는 T3의 MCP 서버로 프로젝트를 읽고 사용 가능한 프로바이더를 조회하는 방법을 설명합니다. 스레드를 시작하거나 메시지를 보내는 작업도 포함합니다.

Cmd/Ctrl+K를 눌러 명령 팔레트를 열고 **Use T3 Code in another app (MCP)**를 선택합니다. Settings → Sharing & access에서도 같은 기능을 사용할 수 있습니다. 클라이언트를 선택하고 표시되는 지침에 따릅니다.

Settings → Environments에서 저장된 환경의 메뉴를 열고 Copy MCP URL을 선택합니다. T3 서버는 계속 실행해 둡니다. Bash에서 다음 블록을 실행한 뒤 read가 입력을 기다리면 복사한 URL을 붙여 넣고 Enter를 누릅니다.

read -r T3_MCP_URL
claude mcp add --transport http t3 "$T3_MCP_URL"
claude mcp login t3

Codex 클라이언트에서는 대신 다음 블록을 사용합니다.

read -r T3_MCP_URL
codex mcp add t3 --url "$T3_MCP_URL"
codex mcp login t3

첫 연결에서는 설정 과정이나 로그인 승인 화면에서 Read only를 선택합니다. 이 모드는 사용 가능한 리소스를 조회할 수 있지만 변경은 허용하지 않습니다.

외부 어시스턴트에 T3 프로젝트와 사용 가능한 프로바이더 목록을 요청합니다. 결과를 T3 인터페이스와 대조합니다. 이렇게 해야 연결 URL을 저장했는지만 확인하는 것이 아니라 실제 도구 작업을 검증할 수 있습니다.

로그인에 실패하면 모델 API 인증 정보를 바꾸기 전에 클라이언트에서 복사한 환경 주소로 접근할 수 있는지 확인합니다.

어시스턴트가 작업을 시작하거나 제어하도록 허용할 때만 실행 권한을 부여합니다. 승인 전에 접근 범위를 검토합니다. 모델 API 토큰과 MCP 로그인은 서로 다른 인증 정보입니다. 한쪽을 바꿔도 다른 쪽 연결 문제가 해결되지는 않습니다.

사용 한도, 개인정보 보호와 오류 발생 지점을 확인합니다

문제를 진단할 때는 구독 사용 한도, API 비용, 클라이언트 설정을 구분합니다.

2026-11-12 기준 T3 FAQ는 Claude의 5시간 사용 한도가 더 빨리 차감되는 문제를 계속 알리고 있습니다. Anthropic Agent SDK를 사용할 때 Claude Code를 직접 사용하는 경우보다 더 빠르게 소진된다는 보고입니다. 유지관리자들은 원인을 Anthropic 측 버그로 설명합니다. 이처럼 빠르게 차감되는 현상은 주간 한도에 영향을 주지 않는다고 하지만, 주간 한도 자체가 사라지는 것은 아닙니다.

5시간 사용 한도가 있는 계정에서는 하루 작업 전체를 T3로 옮기기 전에 작은 대표 작업으로 사용량을 비교합니다. 이 시간 구간의 한도가 가장 큰 제약이라면 Claude Code를 직접 실행하는 선택지도 유지합니다.

FAQ는 T3가 로컬 모델을 지원하지 않는다고 설명합니다. 로컬에서 실행되는 라우터가 호스팅된 모델로 요청을 전달한다고 해서 모델 추론이 로컬에서 이루어지는 것은 아닙니다.

추론 요청에 관해 FAQ는 코드와 프롬프트가 컴퓨터에서 프로바이더로 전송되며 T3 서버로는 전송되지 않는다고 설명합니다. API 게이트웨이를 사용하면 해당 게이트웨이도 이 경로에 포함됩니다. 그렇다고 텔레메트리가 전혀 없다는 뜻은 아닙니다. T3는 프로바이더, 모델, 총 토큰 수와 같은 사용 메타데이터를 전송합니다.

텔레메트리 문서에 따르면 제품 사용 이벤트에는 프롬프트나 파일 내용이 포함되지 않습니다. 민감한 저장소를 사용하기 전에 별도의 진단 정보 관련 항목도 읽어야 합니다.

프로바이더가 없으면 선택한 컴퓨터에서 설치, 로그인 또는 Binary path를 수정합니다. 게이트웨이 인증에 실패하면 민감한 토큰, 빈 ANTHROPIC_API_KEY 값, 저장된 로그인 정보의 유무를 확인합니다. 모델을 사용할 수 없으면 게이트웨이의 정확한 모델 ID와 스레드에서 선택한 인스턴스를 확인합니다.

설정을 바꿀 때마다 새 테스트 스레드를 시작하고 파일 읽기를 반복합니다. 도구 활동과 의도한 프로바이더의 사용 기록이 일치할 때만 변경 사항을 유지합니다.