Claude Code Projects: 코디네이터, /btw, /fork, 사용 한도
Claude Code Projects는 코디네이터가 관련 개발 작업을 여러 병렬 스레드로 나누어 관리하는 기능입니다. 프로젝트 생성과 GitHub 연결 방법, /btw와 /fork의 차이, 알림, 읽기 전용 공유를 설명합니다. 기본 Opus와 high effort 설정을 조정하고 토큰 사용량, 1시간 캐시, 하루 500개 스레드 제한, Auto-continue를 관리하는 방법을 알아봅니다. 로컬 CLI 세션, agent view, T3 Code와도 비교합니다.
목차

Claude Code Projects는 관련된 개발 작업을 여러 세션에서 병렬로 실행하고 하나의 코디네이터가 관리해야 할 때 유용합니다. 2026년 11월 14일 기준으로 Pro, Max, Ultra 요금제에 공개 베타가 단계적으로 제공되고 있습니다. 기본 설정인 Opus와 high effort는 기존 요금제의 공통 사용 한도를 더 빨리 소진할 수 있습니다.
처음에는 작은 작업 하나만 실행하십시오. 작업 난도에 따라 더 작은 모델과 낮은 effort를 선택하십시오. 다음 사용 기간의 한도를 남겨 두려면 Auto-continue도 끄는 것이 좋습니다.
11월 14일 업데이트에서는 코디네이터가 진행 상황을 더 적극적으로 알리도록 변경되었습니다. Projects 안에서 /btw, /fork, 스레드 알림, 읽기 전용 공유, 개선된 아티팩트 탐색 기능도 발표되었습니다.
Projects를 사용하는 이유는 관련 작업을 한 대화에서 요청하고 각 실행 세션의 관리를 Claude에 맡길 수 있기 때문입니다. 다만 실행 중인 스레드는 각각 완전한 Claude Code 세션이며 기존 구독 한도를 소비합니다.
Claude Code Projects란 무엇이며 누가 사용할 수 있나요?
Claude Code Project는 하나의 지속적인 대화에서 코디네이터가 여러 작업 세션을 생성하고 관리하는 기능입니다. 개별 작업 세션을 스레드(thread)라고 합니다.
예를 들어 다음 세 가지 작업을 요청할 수 있습니다.
- 인증 기능에서 발생한 회귀 오류를 수정합니다.
- 결제 엔드포인트에 누락된 테스트를 추가합니다.
- 느린 데이터베이스 쿼리의 원인을 조사합니다.
코디네이터는 작업을 별도 스레드에 배정하고 진행 상황을 추적하며 프로젝트 대화에 결과를 보고합니다. 새 스레드는 프로젝트의 공통 지침을 받으므로 같은 배경 정보를 반복해서 입력할 필요가 없습니다.
대부분의 스레드는 Claude Code 클라우드 세션으로 실행됩니다. 각 클라우드 스레드는 별도의 샌드박스, 저장소 복제본, Git 브랜치를 사용합니다.
작업에 로컬 파일이나 컴퓨터에 설치된 도구가 필요하면 Remote Control을 통해 해당 컴퓨터에서 스레드를 실행하도록 요청할 수 있습니다.
클라우드 스레드는 노트북을 닫아도 작업을 계속할 수 있습니다. 반면 로컬 스레드는 실행하는 컴퓨터가 켜져 있고 사용 가능한 동안에만 동작합니다.
기존 Claude.ai Projects와도 차이가 있습니다. 기존 기능은 대화와 참고 파일을 묶어 두는 방식이었습니다. Claude Code Projects는 코디네이터가 실제 개발 세션을 시작하고 관리합니다.
제공 요금제와 대기자 명단
2026년 11월 14일 기준 Anthropic의 공식 제공 상태는 다음과 같습니다.
| 요금제 | Projects 제공 상태 |
|---|---|
| Pro | 공개 베타, 단계적 출시 |
| Max | 공개 베타, 단계적 출시 |
| Ultra | 공개 베타, 단계적 출시 |
| Team | 아직 제공되지 않음 |
| Enterprise | 아직 제공되지 않음 |
지원 대상 요금제를 구독하더라도 계정에 기능이 활성화되었다고 보장할 수는 없습니다.
다음 순서로 확인합니다.
- 웹에서 Claude Code를 엽니다.
- 사이드바에서 Projects를 찾습니다.
- 보이지 않으면 More를 엽니다.
- Claude 데스크톱 앱의 Code 탭에서도 확인합니다.
- 여전히 없다면 Projects 대기자 명단을 확인합니다.
Projects 브라우저 페이지로 직접 이동하는 방법도 있습니다.
초기 배포에서는 클라우드 세션을 사용한 적이 있고 Claude.ai chat 또는 Cowork에 기존 프로젝트가 없는 계정을 우선 대상으로 삼았습니다.
터미널의 Claude Code만 업데이트한다고 Projects가 활성화되지는 않습니다. 기능은 계정 자격에 따라 웹, 데스크톱, 모바일 앱에서 제공됩니다.
11월 14일 Projects 업데이트에서 무엇이 달라졌나요?
2026년 11월 14일 06:51 UTC+8에 Anthropic의 @ClaudeDevs 계정이 Projects 업데이트를 발표했습니다.
주요 변경 사항은 코디네이터와의 상호작용, 개별 스레드 관리, 아티팩트 탐색에 관한 것입니다.
| 기능 | 동작 | 사용하기 좋은 상황 |
|---|---|---|
| 더 적극적인 코디네이터 | 프로젝트 대화에서 질문에 답하고 스레드 상태를 보고합니다 | 여러 작업의 진행 상황을 한 번에 확인할 때 |
/btw | 부가적인 질문을 위한 별도 스레드를 만듭니다 | 기존 작업을 중단하지 않고 다른 문제를 조사할 때 |
/fork | 현재 스레드에서 새로운 스레드를 분기합니다 | 서로 다른 구현 방법을 비교할 때 |
| 스레드 알림 | 지정한 시각까지 스레드를 숨겼다가 다시 표시합니다 | 리뷰나 다른 작업이 끝난 후 돌아올 때 |
| 읽기 전용 공유 | 조건에 맞는 개별 스레드의 공유 링크를 제공합니다 | 다른 Claude 사용자에게 작업 내용을 보여줄 때 |
| 아티팩트 탐색 | 최근에 열거나 수정하거나 고정한 아티팩트와 미리보기를 표시합니다 | 이전 작업의 결과물을 찾을 때 |
코디네이터가 진행 상황을 더 적극적으로 알려줍니다
코디네이터는 이제 프로젝트 대화에서 질문에 답하고 실행 중인 스레드의 상태도 더 적극적으로 보고합니다.
여러 작업을 시작한 뒤 다음과 같이 질문할 수 있습니다.
지금 실행 중인 스레드는 무엇인가요? 리뷰가 필요한 pull request는 무엇이며, 제 결정이 필요한 작업은 무엇인가요?
코디네이터는 각 스레드가 전달한 보고 내용을 확인합니다. 하지만 스레드 내부에서 실행된 모든 단계를 직접 확인하는 것은 아닙니다.
오류를 자세히 분석하려면 해당 스레드를 여십시오. 실행한 명령어, 도구 호출, 작업 결과를 확인할 수 있습니다.
Anthropic은 11월 14일 코디네이터 업데이트 발표에서 이 변경을 설명했습니다.
/btw와 /fork는 어떻게 다른가요?
두 명령어 모두 Projects에서 사용할 수 있지만 목적이 다릅니다.
현재 작업과 관계없는 질문이 갑자기 생기면 /btw를 사용합니다.
예를 들어 어떤 스레드가 인증 미들웨어를 수정하고 있다고 가정하겠습니다. 그때 별개의 결제 오류가 발견되면 /btw로 새 스레드를 만들어 조사할 수 있습니다. 기존 인증 작업은 원래의 흐름을 유지합니다.
반면 /fork는 현재 작업의 다른 해결 방법을 시험할 때 사용합니다.
예를 들어 데이터베이스 쿼리를 JOIN으로 최적화하는 스레드가 있다면, 해당 스레드에서 분기하여 구체화된 뷰를 사용하는 방법도 조사할 수 있습니다. 원래 스레드의 작업을 덮어쓰지 않습니다.
차이를 정리하면 다음과 같습니다.
/btw는 새로운 주제를 현재 작업과 분리합니다./fork는 현재 스레드의 작업을 다른 스레드로 분기합니다.
두 명령어 모두 추가 세션을 만들 수 있으므로 사용량이 늘어날 수 있습니다. 결과를 비교할 이유가 없다면 불필요한 분기를 반복하지 않는 편이 좋습니다.
Anthropic은 두 명령어에 관한 공식 발표에서 동작을 설명했습니다. Projects에서의 동작이 모든 터미널 CLI 버전에도 동일하게 적용된다고 가정하지 마십시오.
알림, 읽기 전용 공유, 아티팩트 탐색
개별 스레드에 알림을 설정하거나 Claude에게 나중에 알려 달라고 요청할 수 있습니다.
Anthropic의 알림 기능 발표에 따르면 해당 스레드는 알림 시각까지 목록에서 잠시 사라집니다. 정해진 시간이 되면 다시 나타나며 Claude가 프로젝트 대화에서도 알려줍니다.
리뷰나 외부 작업이 끝난 뒤 다시 확인해야 하는 경우에 유용합니다. 다만 결과 검토까지 자동으로 대신하는 것은 아닙니다.
Anthropic은 개별 스레드의 읽기 전용 공유 기능도 발표했습니다.
- 공유할 스레드를 엽니다.
- 스레드 메뉴를 엽니다.
- Share 항목이 표시되면 선택합니다.
- Claude에 로그인한 사용자에게 링크를 전달합니다.
사용자의 컴퓨터에 접근했던 스레드는 이 기능으로 공유할 수 없습니다.
2026년 11월 14일 기준으로 문서 내용에는 차이가 있었습니다. 공식 공유 기능 발표는 개별 스레드 공유를 설명하지만, Projects의 제한 사항에는 스레드 대화 기록을 공유할 수 없다는 기존 설명이 남아 있었습니다.
따라서 실제 스레드 메뉴에 Share가 있는지 확인해야 합니다. 이 UI 업데이트에 필요한 별도의 Projects 전용 CLI 버전도 확인되지 않았습니다.
읽기 전용 링크라고 해서 민감한 정보가 보호되는 것은 아닙니다. 공유하기 전에 저장소 정보, 로그 및 기타 비공개 데이터를 확인하십시오.
아티팩트 탐색 업데이트 발표는 스레드 패널 상단에 새로운 행이 생겼다고 설명합니다. 이 행에는 최근에 열거나 수정하거나 고정한 아티팩트가 표시됩니다. 각 스레드에는 해당 스레드의 아티팩트 미리보기도 나타나며, 보기 설정에서 끌 수 있습니다.
프로젝트 설정과 로컬 폴더 접근 화면도 웹과 데스크톱에서 간소화되었습니다. 최신 모바일 앱에도 새로운 디자인이 적용되었다고 발표했습니다.
첫 번째 Claude Code Project 설정하기
처음에는 명확한 목표를 가진 프로젝트 하나를 만드십시오. 병렬 작업을 여러 개 실행하기 전에 작은 작업으로 저장소 연결과 결과를 확인하는 것이 좋습니다.
1. 저장소 접근 권한 확인
코드를 처리하는 클라우드 스레드에는 다음 조건이 필요합니다.
- 저장소가 GitHub Enterprise Server, GitLab, Bitbucket이 아닌
github.com에 있어야 합니다. - 연결된 GitHub 계정에 push 권한이 있어야 합니다.
- 해당 저장소에 접근할 수 있도록 Claude GitHub App이 설치되어 있어야 합니다.
/web-setup으로 설정한 GitHub 토큰만으로는 Projects의 클라우드 스레드를 실행하기에 충분하지 않습니다.
저장소가 보이지 않으면 공식 GitHub 연결 안내를 확인하십시오. GitHub 계정을 연결한 뒤 필요한 저장소에 대한 Claude GitHub App 접근 권한을 설정합니다.
조직에서 SAML SSO를 사용한다면 해당 조직에서 Claude 앱을 별도로 승인해야 할 수도 있습니다.
클라우드 스레드의 설정 방식은 로컬 세션과 다릅니다.
각 저장소의 CLAUDE.md에 있는 지침은 읽습니다. 하지만 저장소의 skills, .mcp.json에 등록된 MCP 서버, .claude/settings.json은 불러오지 않습니다.
따라서 .claude/settings.json에 정의된 hooks, 권한 규칙, 환경 설정도 클라우드 스레드에는 적용되지 않습니다.
컴퓨터에만 설치된 도구 역시 자동으로 사용할 수 없습니다. 필요한 기능은 프로젝트 클라우드 환경과 지원되는 Claude 계정 연동 기능에서 설정하십시오. 로컬 도구가 필수라면 Remote Control을 고려합니다.
2. 프로젝트 생성
Anthropic의 공식 프로젝트 생성 문서는 다음 단계를 안내합니다.
claude.ai/code또는 데스크톱 앱의 Code 탭을 엽니다.- 사이드바 또는 More에서 Projects를 선택한 다음 New project를 누릅니다.
- Name에 프로젝트 이름을 입력합니다.
- 필요하다면 **What do you want to work on?**에 목표를 적습니다.
- Context에서 **+**를 사용해 필요한 GitHub 저장소, 파일, 폴더를 추가합니다.
- Create project를 선택합니다.
필수 입력 항목은 Name뿐입니다. 목표와 컨텍스트는 나중에 추가할 수 있습니다.
New project 대신 Get started가 표시된다면 기존 Claude.ai 프로젝트를 업그레이드하거나 보관 처리해야 할 수 있습니다.
첫 프로젝트를 만들면 Claude가 생성 직후 먼저 작업을 시작할 수 있습니다. 이 작업도 구독 사용량에 포함됩니다. 저장소를 조사하는 스레드를 시작하거나 초기 설정을 제안할 수도 있습니다.
추천된 저장소와 예약 작업을 수락하기 전에 내용을 검토하십시오.
3. 프로젝트 지침과 사용 설정 변경
프로젝트 사이드바 메뉴 또는 상단 메뉴에서 Project settings를 엽니다.
Project settings > Memory > Project instructions로 이동한 다음 새 스레드에 적용할 규칙을 입력합니다.
예를 들면 다음과 같습니다.
선택한 저장소에서만 작업하세요. 각 구현에는 별도의 브랜치를 사용하세요. 완료를 보고하기 전에 관련 테스트를 실행하세요. 공개 API의 동작을 변경하기 전에는 승인을 요청하세요. 제가 구현 계획을 승인하기 전에는 pull request를 열지 마세요.
새로 생성하는 스레드는 이 지침을 받습니다.
Project settings에서 지침, 저장소, 플러그인, 환경을 변경하면 새 스레드에 적용됩니다. 이미 실행 중인 스레드는 자동으로 재설정되지 않습니다.
이어서 Project settings > General을 열어 모델과 effort 설정을 확인합니다.
4. 작은 작업을 실행하고 결과 확인
성공 여부를 판단하기 쉬운 작업을 먼저 요청합니다.
orders 엔드포인트가 잘못된 입력에 대해 틀린 HTTP 상태를 반환하는 원인을 조사하세요. 스레드는 하나만 시작하세요. 실패 사례를 확인하고 회귀 테스트를 추가한 뒤 최소한의 수정안을 제시하세요. 제가 계획을 승인하기 전에는 pull request를 열지 마세요.
이는 요청 예시이며 실제로 테스트를 실행했다는 의미는 아닙니다.
Overview에서 스레드 상태를 확인합니다. 화면에는 Working, Waiting on you, Ready for review 등의 상태가 표시됩니다.
스레드를 열어 다음 항목을 검토하십시오.
- 어떤 파일을 읽거나 변경했는지 확인합니다.
- 요청한 테스트가 실제로 실행되었는지 확인합니다.
- 설명이 diff와 일치하는지 확인합니다.
- 권한, 의존성, 사용자의 추가 결정이 필요한지 확인합니다.
클라우드 스레드는 일반적으로 서로 다른 브랜치에서 작업합니다. 요청하면 pull request를 열 수 있으며, 구체적인 버그 수정에서는 자체적으로 열 수도 있습니다.
Couldn’t start the session 또는 Unable to access your repository가 나타나면 Claude GitHub App 설치 상태와 저장소 권한을 확인합니다. 오류 메시지에서 제시하는 복구 작업을 수행한 다음 같은 작업에 대해 새 스레드를 시작하십시오.
별도의 브랜치를 사용해도 Git 병합 충돌은 발생할 수 있습니다. 두 스레드가 같은 코드를 수정했을 수 있으므로 병합 전에 변경 사항을 검토해야 합니다.
첫 스레드가 예상대로 작동하면 두 번째 독립 작업을 추가합니다.
Claude Code Projects 사용량 줄이기
사용량을 줄이려면 먼저 기본 모델과 effort 설정을 검토하십시오.
Anthropic 문서에 따르면 새 프로젝트는 코디네이터와 모든 스레드에 Opus를 사용합니다. 스레드의 effort는 high이고 프로젝트 대화의 effort는 low입니다.
단순한 버그 수정, 테스트 추가, 문서 작업에는 이 기본 설정이 필요 이상으로 많은 자원을 사용할 수 있습니다.
Thread model, effort, Auto-continue 변경
Project settings > General을 엽니다.
| 설정 | 새 프로젝트 기본값 | 사용량을 줄이기 위한 시작 설정 |
|---|---|---|
| Thread model | Opus | 일반 작업에는 계정에서 선택할 수 있는 더 작은 모델 |
| Thread effort | High | 범위가 명확한 작업에는 Medium 또는 low |
| Coordinator model | Opus | 작업 분배와 상태 보고에는 더 작은 모델 |
| Coordinator effort | Low | 코디네이터가 제대로 동작하면 low 유지 |
| Auto-continue when usage limits reset | On | 다음 사용 기간에 자동 재개하지 않으려면 Off |
선택할 수 있는 모델은 계정과 당시 모델 제공 상태에 따라 다를 수 있습니다.
복잡한 디버깅, 아키텍처 결정, 깊은 추론이 필요한 작업에는 Opus와 high effort를 유지할 가치가 있습니다. 단순한 테스트나 수정 작업에서는 작은 모델과 낮은 effort부터 시도하는 것이 좋습니다.
설정의 역할은 다음과 같이 구분됩니다.
- Thread model과 Thread effort는 실제 작업을 수행하는 스레드를 제어합니다.
- Coordinator model과 Coordinator effort는 프로젝트의 주 대화를 제어합니다.
새 작업에는 별도의 모델을 지정하도록 요청할 수 있습니다. 이미 실행 중인 스레드의 모델을 변경하려면 해당 스레드의 모델 선택 메뉴를 사용합니다.
이 설정은 Projects 화면에서 관리하며 로컬 settings.json에 적용하는 설정이 아닙니다.
스레드 수를 줄이도록 요청하되 강제 제한으로 생각하지 않기
Anthropic은 코디네이터가 실행 전에 스레드 구성을 제안하도록 요청하는 방법을 권장합니다.
다음과 같은 지침을 사용할 수 있습니다.
작업을 시작하기 전에 필요한 스레드를 제안하세요. 동시에 최대 두 개의 스레드만 실행하세요. 간단한 질문에는 이 대화에서 직접 답하고 새 스레드를 만들지 마세요. 작업 결과와 방해 요인을 보고한 뒤 다음 작업 묶음은 제 승인을 기다리세요.
이 지침은 의도한 작업 흐름을 조절하는 데 도움이 됩니다. 하지만 시스템 차원의 강제 동시 실행 제한을 설정하지는 않습니다.
Anthropic은 사용자가 요청한 스레드 수를 엄격한 상한이 아닌 선호 사항으로 취급한다고 설명합니다.
실제로 적용되는 제한은 모든 Projects를 합해 하루에 새 스레드 500개입니다.
이는 무료 세션 500개를 의미하지 않으며, 스레드 500개를 동시에 실행할 수 있다는 보장도 아닙니다.
Overview에서 실제 생성된 스레드 수를 확인하십시오.
토큰은 어디에 사용되나요?
Projects 사용량에 관한 공식 문서는 주요 소비 원인을 네 가지로 설명합니다.
실행 중인 스레드: 각 스레드는 완전한 세션입니다. 여러 스레드가 동시에 실행되면 공통 사용 한도를 병렬로 소비합니다.
코디네이터: 스레드 보고를 읽고 다음 작업을 결정하며 프로젝트 대화에서 답하는 데도 토큰이 사용됩니다.
Pull request 감시: CI 실패나 리뷰 댓글이 발생하면 대기 중이던 스레드가 다시 실행될 수 있습니다. 이때 추가 사용량이 발생합니다.
긴 대화 기록: 오래된 스레드에 다시 메시지를 보내면 Claude가 이전 대화의 많은 부분을 다시 읽어야 할 수 있습니다.
Pro, Max, Ultra에서 요금제에 포함된 사용량을 소비하는 경우 Anthropic은 캐시 유효 기간을 1시간으로 설명합니다.
스레드가 1시간 넘게 유휴 상태였다면 다음 메시지를 처리하기 전에 대화 기록 전체를 다시 읽습니다.
완전히 새로운 작업이라면 긴 기록이 있는 스레드를 되살리는 것보다 새 스레드를 만드는 편이 사용량을 줄일 수도 있습니다. 다만 이전 조사 내용이 필요한 경우에는 기존 스레드의 컨텍스트가 더 유용할 수 있습니다.
Anthropic은 Projects의 사용량이 일반 세션보다 정확히 몇 배 많은지 정해진 수치를 제공하지 않습니다. 실제 소비량은 스레드 수, 모델, effort, 대화 길이, 반복 작업에 따라 달라집니다.
Project settings > Usage에서는 스레드별, 모델별, 프로젝트 주 대화별 토큰 사용량을 확인할 수 있습니다.
Projects 외부의 추가 토큰 소비 사례는 Claude Code agent_summary 사용량 분석에서 확인할 수 있습니다. 다만 그 수치를 Projects 자체의 추가 비용으로 해석해서는 안 됩니다.
사용하지 않는 Project도 한도를 소비하나요?
실행 중인 스레드가 없고 감시 중인 pull request가 없으며 새 메시지도 없다면 유휴 프로젝트는 사용 한도를 소비하지 않습니다.
Anthropic에 따르면 보관 처리된 프로젝트도 유휴 상태에서 사용량이 발생하지 않습니다.
따라서 사용량을 줄이기 위해 완료된 프로젝트를 반드시 삭제할 필요는 없습니다.
그러나 pull request를 계속 감시하는 스레드는 CI 또는 리뷰 이벤트 이후 다시 실행될 수 있습니다. 감시가 불필요해지면 해당 스레드에 중단하도록 요청하십시오.
Projects가 사용 한도에 도달하면 어떻게 되나요?
Projects의 사용량은 다른 Claude Code 세션과 동일한 구독 한도에 포함됩니다. Projects만을 위한 별도의 무료 토큰 할당량은 없습니다.
2026년 11월 14일 기준 주요 한도는 다음과 같습니다.
| 요금제 | 관련 사용 한도 |
|---|---|
| Pro | 5시간 세션 한도 및 주간 한도 |
| Max | 5시간 세션 한도 및 주간 한도 |
| Ultra | 주간 한도. 인증된 Ultra 계정에는 5시간 한도가 없음 |
아직 인증되지 않은 Ultra 계정에는 임시 세션 한도가 적용될 수 있습니다.
Anthropic의 Ultra 요금제 공식 문서가 이 차이를 설명합니다. 자세한 비교는 Ultra와 Max의 5시간 및 주간 사용 한도 안내를 참고하십시오.
Auto-continue가 다음 사용 기간의 한도를 소비할 수 있습니다
스레드 또는 코디네이터가 적용되는 요금제 한도에 도달하면 작업이 중단되고 대기합니다.
기본적으로 한도가 초기화되면 중단된 작업이 자동으로 재개됩니다. 재개 이후의 사용량은 다음 사용 기간에 포함됩니다.
자동 재개를 막으려면 다음 순서로 설정합니다.
Project settings > General을 엽니다.- Auto-continue when usage limits reset를 찾습니다.
- 표시된 초기화 시각 전에 Off로 변경합니다.
- 한도가 초기화된 뒤 스레드나 프로젝트 주 대화에 메시지를 보내 수동으로 재개합니다.
이 설정은 현재 보고 있는 스레드 하나가 아니라 프로젝트 전체에 적용됩니다.
Auto-continue를 꺼도 다른 유료 사용 옵션이 자동으로 비활성화되는 것은 아닙니다. 별도로 확인해야 합니다.
Usage credits는 구독에 포함된 한도와 별개입니다
Pro, Max, Ultra 구독자는 포함된 사용 한도를 초과한 뒤에도 일부 요청을 처리하도록 usage credits를 활성화할 수 있습니다.
이 기능이 켜져 있으면 대상 요청에 추가 요금이 부과되면서 작업을 계속할 수 있습니다. Projects의 스레드가 계정 소유자 대신 usage credits를 활성화할 수는 없습니다.
대량의 작업을 시작하기 전에 Claude 계정의 Settings > Usage를 확인하십시오.
Usage credits가 활성화되어 있다면 예산에 맞는 월간 지출 상한을 설정합니다. 요금제에 포함된 사용 한도를 소진한 후 추가적인 사용량 기반 요금을 내고 싶지 않다면 usage credits를 끄십시오.
이 usage credits는 Max와 Ultra에 포함된 월간 API credits와 서로 다른 항목입니다.
스레드에 Additional usage credits are required가 표시된다면 요청한 모델이나 컨텍스트 크기가 포함된 요금제의 범위를 벗어나 추가 크레딧이 필요할 수 있습니다.
먼저 구독 한도 내에서 사용 가능한 모델이나 컨텍스트 옵션이 있는지 확인합니다. 추가 결제를 결정하기 전에 Anthropic의 usage credits 공식 안내를 검토하십시오.
Projects, 로컬 Claude Code 세션, T3 Code 중 무엇을 선택해야 하나요?
서로 관련된 여러 작업을 Claude가 장기간 조정해야 한다면 Projects를 선택합니다. 로컬 환경과 실행 과정을 직접 제어해야 한다면 로컬 세션이 더 적합합니다.
| 방식 | 적합한 작업 | 조정 주체 | 주요 제약 |
|---|---|---|---|
| Claude Code Projects | 여러 세션, 저장소, 날짜에 걸친 관련 작업 | Claude 코디네이터 | Anthropic 모델만 사용, 베타 접근, 구독 한도 공유 |
| 여러 로컬 Claude Code CLI 세션 | 로컬 도구가 필요한 독립적인 소수 작업 | 사용자 | 세션 시작과 진행 상황 관리를 직접 수행 |
| Claude Code agent view | 여러 로컬 세션을 한 화면에서 확인 | 사용자 | Research preview, Projects 코디네이터 없음 |
| T3 Code | Claude Code, Codex 등 로컬 개발 에이전트 관리 | 사용자 또는 구성된 워크플로 | 에이전트 설치와 실행 중인 호스트 컴퓨터 필요 |
실행 과정을 직접 관리하려면 로컬 CLI 세션 선택
독립적인 개발 작업이 두 개 정도라면 별도의 Claude Code 세션과 Git worktrees만으로도 충분할 수 있습니다.
worktree는 각 세션에 독립된 Git 작업 복사본을 제공합니다. 따라서 병렬 세션이 같은 작업 디렉터리를 실수로 수정할 위험을 줄입니다.
로컬 세션은 컴퓨터에 설치된 도구, hooks, 설정, 지원되는 모델 공급자 구성을 사용할 수 있습니다. 다만 자동으로 Projects 스레드가 되지는 않습니다.
Claude Code의 claude agents 인터페이스도 여러 세션을 시작하고 관찰하는 기능을 제공합니다. 이 기능은 Research preview 단계입니다.
Anthropic은 Run agents in parallel에서 여러 방식을 비교합니다.
모든 작업에 로컬 데이터베이스, 사용자 지정 hooks, 클라우드에서 접근할 수 없는 인프라가 필요하다면 로컬 방식을 먼저 검토하십시오.
여러 개발 에이전트를 함께 관리하려면 T3 Code 선택
T3 Code는 사용자 컴퓨터에서 실행되는 코딩 에이전트를 한곳에서 관리하는 오픈소스 인터페이스입니다.
공식 문서에는 Claude Code, Codex, Cursor, OpenCode 및 기타 지원되는 에이전트가 나와 있습니다.
공개 README에 따르면 T3 Code는 여러 에이전트의 스레드를 하나의 화면에 표시하고 원격 연결을 지원합니다. 각 스레드는 Git worktree를 사용해 코드 변경 사항을 분리할 수도 있습니다.
T3 Code는 사용자가 설정한 에이전트와 인증 방식을 사용합니다. 토큰을 재판매하는 서비스는 아닙니다.
따라서 Claude Code와 Codex 사이에서 작업을 넘기거나 다른 기기에서 로컬 작업을 확인할 때 유용합니다.
그러나 T3 Code가 로컬 세션을 Claude Code Projects로 바꾸지는 않습니다. Anthropic이 호스팅하는 Projects 코디네이터를 제공하지도 않습니다.
모델 공급자, 접근 권한, 요금 청구 방식은 각각의 에이전트와 해당 설정에 따라 결정됩니다.
자세한 연결 과정은 Claude Code, Codex 및 API 게이트웨이를 사용하는 T3 Code 설정 가이드에서 확인할 수 있습니다.
Projects에 자체 API key나 모델 공급자를 연결할 수 있나요?
Projects에 사용자 지정 모델 공급자를 연결하는 공식 설정 방법은 문서화되어 있지 않습니다.
Anthropic의 Projects 제한 사항에는 클라우드 스레드와 Remote Control 스레드 모두 Anthropic을 모델 공급자로 사용한다고 명시되어 있습니다.
Projects는 터미널 CLI, VS Code 확장 프로그램, JetBrains 플러그인에서 직접 실행할 수도 없습니다.
자체 API endpoint가 필수라면 사용자 지정 모델 공급자를 지원하는 로컬 개발 도구나 타사 에이전트 관리 인터페이스를 선택하십시오. 해당 도구의 지원 범위는 별도로 확인해야 합니다.
사용량 기반으로 요금을 내는 API 접근 방식이 Projects의 코디네이터, 계정 이용 자격, 클라우드 세션 관리를 대신할 수는 없습니다.
사용량을 절약하는 초기 설정
Pro 계정이 Projects 사용 대상이며 하나의 서비스에 작은 버그가 여러 개 남아 있다면 다음 구성으로 시작하는 것이 좋습니다.
- 해당 서비스용 Project 하나를 만들고 필요한 저장소만 연결합니다.
- Project instructions에 브랜치, 테스트, 승인 규칙을 작성합니다.
- 일반 작업에는 더 작은 Thread model을 선택하고 Thread effort를 낮춥니다.
- Coordinator effort는 low로 유지하고 필요한 경우 Coordinator model도 더 작은 모델로 변경합니다.
- 먼저 스레드 구성을 제안받고 한 번에 하나 또는 두 개의 작업만 승인합니다.
- 다음 사용 기간의 한도를 확보하려면 Auto-continue를 끕니다.
- 첫 작업 묶음이 끝나면
Project settings > Usage에서 실제 사용량을 확인합니다.
어려운 디버깅이나 충분한 추론이 필요한 작업에는 Opus와 high effort를 유지할 수 있습니다. /btw와 /fork는 별도의 작업 맥락이 실제로 필요할 때 사용하십시오.
여러 저장소에 걸쳐 장기간 진행하는 마이그레이션에서는 Projects가 수동 조정 부담을 줄일 수 있습니다. 반면 로컬에서 몇 가지 수정만 한다면 독립적인 CLI 세션이나 agent view가 더 간단할 수 있습니다.