본문 바로가기

Claude Code · Codex를 위한 읽기 전담 서브에이전트

AI 에이전트가 파일 읽느라 태우는 토큰,
76.6% 덜어내세요.

문서·코드·로그 수십 개를 비싼 주 모델이 통째로 읽게 두지 마세요. 에이픽 서브에이전트가 대신 읽고 원문 인용이 달린 핵심만 넘깁니다. 주 에이전트는 가벼워진 컨텍스트로 판단과 코딩에만 집중합니다.

  • 연결 코드로 바로 연결
  • 설치비 0원
  • 실패한 작업은 청구 없음
주 모델 컨텍스트에 들어가는 양
원문을 직접 읽으면
109.2만 토큰
서브에이전트를 쓰면
25.6만
−83.6만 토큰실제 운영 작업 188건 실측 · 2026-09-26 ~ 2026-10-04

에이전트 비용, 대부분은 ‘읽기’에서 샙니다.

컨텍스트가 금방 찹니다

파일 몇 개 열었을 뿐인데 대화가 압축되고, 앞에서 정한 설계를 에이전트가 잊어버립니다.

사용 한도가 순식간에 바닥납니다

가장 비싼 모델의 토큰을 판단이 아니라 문서 전수 읽기에 쏟고 있습니다.

판단은 1분, 읽기는 10분

에이전트가 자료를 다 읽을 때까지 개발자는 화면만 보고 기다립니다.

도입 효과

읽기를 맡기면 다섯 가지가 동시에 좋아집니다.

−76.6%

토큰 절감

주 모델에는 원문 대신 근거 달린 짧은 보고서만 들어갑니다. 실제 운영 작업 188건에서 109.2만 → 25.6만 토큰.

비싼 토큰은
판단에만

비용 절감

대량 읽기는 에이픽 서버가 처리합니다. 주 모델 요금은 설계·코딩·최종 결정처럼 꼭 필요한 곳에만 씁니다.

동시에
여러 건

속도

여러 읽기를 한꺼번에 맡기고 주 에이전트는 다음 일을 합니다. 컨텍스트가 가벼우니 응답도 가볍고, 대화 압축은 늦게 옵니다.

0회

캐시 재사용

검수 승인한 동일 작업을 다시 요청하면 외부 모델을 부르지 않고 저장된 결과를 1P에 돌려드립니다.

80/80

근거 검수

모든 결과에 원문 인용·줄 번호·파일 해시가 붙습니다. 그럴듯한 지어낸 답은 주 에이전트가 바로 걸러냅니다.

말이 아니라 숫자로

실측 데이터로 확인하세요.

모든 수치는 공개 평가 자료와 실제 운영 기록에서 나왔습니다.

주 모델에 들어간 텍스트실제 운영 작업 188건 누적 · 토큰 환산
원문 전체
1,091,872
서브에이전트 보고서
256,025

835,847 토큰을 주 모델이 읽지 않아도 됐습니다. 원문 대비 23.4%만 전달.

같은 작업 다시 요청평가 사례 80건 재요청
80/80결과 동일

외부 모델 호출 0회. 기다림도, 추가 토큰도 없습니다.

자동 검증 통과 사례평가 사례 80건 · 개선 회차별

독립 검수에서 필수 정보 80/80, 원문 인용 80/80 통과.

전달 텍스트는 UTF-8 바이트를 토큰으로 환산한 추정치이며, 주 모델의 실제 청구액은 작업 종류·자료·재검수량에 따라 달라집니다. 평가 자료 원본 보기 →

내 팀이라면 얼마나?

절감 효과 계산기

실측 절감률 76.6%를 그대로 적용해 계산합니다.

지금
도입 후

−229.8만 토큰주 모델 입력 비용 월 약 45,960원 절감

주 모델 단가는 쓰는 모델에 맞게 바꿔 넣으세요. 서브에이전트 이용료는 별도이며 성공한 작업만 사용량대로 정산합니다.

작동 방식

주 에이전트는 지시하고, 서브에이전트는 읽습니다.

  1. 1

    위임

    주 에이전트가 “이 문서들에서 ○○ 조건만 골라 줘”처럼 목표와 파일 범위를 정해 맡깁니다.

  2. 2

    대신 읽기

    서브에이전트가 자료를 끝까지 읽고 조사·추출·요약·비교 결과를 원문 인용과 함께 만듭니다.

  3. 3

    근거만 확인

    주 에이전트는 줄 번호·해시로 핵심 근거만 대조하고 승인합니다. 원본 수정과 최종 결정은 주 에이전트 몫입니다.

이럴 때 효과가 큽니다

개발자들이 가장 많이 맡기는 일

처음 보는 저장소 파악

폴더 구조·설정·진입점을 훑어 목록으로. 에이전트가 수백 개 파일을 다 열 필요가 없습니다.

“이 저장소의 결제 관련 파일과 역할을 목록으로”

문서 묶음 요약

운영 문서·회의록·스펙 수십 개에서 필요한 규칙만 근거와 함께.

“docs 전체에서 배포 금지 조건만 골라 줘”

변경 전후 비교

두 버전의 계약서·스펙·설정에서 바뀐 곳과 충돌을 정리합니다.

“v1·v2 요금 약관의 차이와 충돌을 비교”

대량 자료 추출

보고서·로그·대본 묶음에서 조건에 맞는 문장만 골라냅니다.

“조사 자료에서 수치가 나온 문장만 추출”

3분이면 끝

설치하고, 연결 코드로 바로 연결하세요.

Codex와 Claude Code에 스킬과 MCP를 한 번에 구성합니다. 기존 설정은 그대로 둡니다.

  1. 1

    설치

    npm install -g apick-subagent
    apick-subagent install
  2. 2

    인증키 연결

    마이페이지 › API 정보에서 연결 코드 발급을 누르고, 아래 명령을 실행해 코드를 붙여 넣습니다. 코드는 10분 동안 한 번만 쓸 수 있고, 인증키가 이 PC에 자동으로 저장됩니다.

    apick-subagent login

    연결한 뒤 클라이언트를 다시 시작하세요. 코드와 키는 대화나 공개 설정 파일에 붙여 넣지 마세요.

  3. 3

    연결 확인

    apick-subagent doctor

    이제 “이 자료 비교를 apick-subagent에 맡기고 핵심 근거를 검수해 줘”라고 말하면 됩니다.

성공한 작업만사용량대로 정산. 실패·취소·자동 검증 실패는 청구 없음
동일 결과 1P검수 승인한 결과는 캐시로 재사용
고객별 암호화7일 뒤 자동 만료, 언제든 즉시 삭제
한도 없음파일 수·작업 수 제한 없이 충전 잔액 안에서

작동 흐름

읽기는 서브에이전트가, 판단은 고성능 에이전트가.

같은 작업을 두 방식으로 흘려 보면, 고성능 모델의 토큰이 쓰이는 자리가 달라집니다.

지금: 고성능 에이전트가 전부 처리

  1. 원문 읽기파일 수십 개를 통째로 읽음
  2. 반복 확인같은 검색과 대조를 여러 번
  3. 단순 정리목록 만들기, 조건에 맞는 문장 추출
  4. 판단·작성결정과 결과물

도입 후: 역할을 나눠 처리

  1. 목표와 범위 전달짧은 지시만 고성능 에이전트가
  2. 대량 읽기·반복·단순 작업에이픽 서브에이전트가 대신 수행
  3. 근거 달린 보고서 확인원문 인용과 줄 번호로 핵심만 받음
  4. 판단·검증·승인최종 결정은 고성능 에이전트가

고성능 모델이 쓰는 토큰 서브에이전트가 저렴하게 처리

고성능 모델에 들어간 텍스트 양실제 운영 작업 188건 실측 · 100 기준

지금 100도입 후 약 23

같은 작업에서 고성능 모델이 읽는 양이 약 4.3배 적습니다. 판단과 검증에 쓰는 토큰은 그대로이고, 원문을 읽는 몫이 줄어듭니다.

수치는 2026-09-26 ~ 2026-10-04 운영 작업을 UTF-8 기준 토큰으로 환산한 추정치이며, 주 모델의 실제 청구액은 작업 종류와 자료량에 따라 달라집니다. 평가 80건 모두에서 필수 정보 80건, 원문 인용 80건이 독립 검수를 통과했습니다.

자주 묻는 질문

Claude Code에 기본으로 있는 서브에이전트와 무엇이 다른가요?

기본 서브에이전트도 결국 내 구독·API 사용 한도 안에서 토큰을 씁니다. 에이픽 서브에이전트는 읽기를 에이픽 서버에서 처리하므로 그 한도를 건드리지 않고, 원문 인용·해시 검수와 동일 결과 캐시까지 붙여 돌려줍니다.

76.6% 절감은 어떻게 나온 숫자인가요?

실제 운영 작업 188건에서 주 모델이 원문을 직접 읽었을 때의 양(1,091,872 토큰)과 서브에이전트 보고서의 양(256,025 토큰)을 비교했습니다. 실패·반려·재작업을 포함한 전체 기록이며 평가 자료에 공개돼 있습니다.

어떤 도구에서 쓸 수 있나요?

Codex와 Claude Code는 설치 명령 하나로 스킬과 MCP가 구성됩니다. 그 밖에 Bearer 인증을 지원하는 Streamable HTTP MCP 클라이언트는 https://apick.app/mcp/subagent로 연결하고, REST API로 직접 호출할 수도 있습니다.

올린 자료는 안전한가요?

자료는 고객별로 분리해 암호화하고 7일 뒤 만료됩니다. 즉시 삭제할 수 있고, 저장 안 함을 고르면 처리·검수에 필요한 동안만(최대 1시간) 보관합니다. 고객 간 캐시는 공유하지 않습니다.

요금은 어떻게 나가나요?

성공한 작업만 실제 사용량대로 포인트에서 차감합니다. 접수 때 예상 최대치를 잠시 예약하고 끝나면 차액을 돌려드립니다. 실패·취소·자동 검증 실패는 청구하지 않고, 검수 승인한 동일 결과 재요청은 1P입니다.

결과가 틀리면 어떻게 하나요?

모든 주장에 원문 인용과 줄 번호가 붙으므로 주 에이전트가 근거를 대조해 반려할 수 있습니다. 원본 수정과 최종 판단은 언제나 주 에이전트가 합니다.

오늘 저녁 작업부터 토큰을 아끼세요.

설치 3분 · API 키 하나 · 성공한 작업만 정산

지금 설치하기