Claude Code 소개
아이디어 구상에서 커밋까지 이어지는 단일 워크플로우에서 Claude Code의 실제 작동 모습을 확인하세요.
빠Mintlify, Claude로 개발자 문서 자동화하여 3배 빨라진 배포 속도
산업:
소프트웨어
기업 규모:
중소기업
제품:
AI Platform
위치:
북아메리카
3~4배
엔지니어당 담당하는 엔지니어링 코드 생산량 증가
50% 더욱 빠른 속도
신규 기능용 출시 기간
The problem
Claude Code 소개
아이디어 구상에서 커밋까지 이어지는 단일 워크플로우에서 Claude Code의 실제 작동 모습을 확인하세요.
Claude Code 소개
아이디어 구상에서 커밋까지 이어지는 단일 워크플로우에서 Claude Code의 실제 작동 모습을 확인하세요.
The solution
Introducing Claude Opus 4.6
.jpg)
We’re upgrading our smartest model. The new Claude Opus 4.6 improves on its predecessor’s coding skills. It plans more carefully, sustains agentic tasks for longer, and features a 1M token context window.
Introducing Claude Opus 4.6
We’re upgrading our smartest model. The new Claude Opus 4.6 improves on its predecessor’s coding skills. It plans more carefully, sustains agentic tasks for longer, and features a 1M token context window.
Introducing Claude Opus 4.6
We’re upgrading our smartest model. The new Claude Opus 4.6 improves on its predecessor’s coding skills. It plans more carefully, sustains agentic tasks for longer, and features a 1M token context window.
"우리 팀원 모두는 수동적으로 작성하기 보다는 Claude를 사용하여 훨씬 방대한 양의 많은 코드를 작성하고 있습니다."
Mintlify의 엔지니어링 담당 매니저
Claude Code 소개
아이디어 구상에서 커밋까지 이어지는 단일 워크플로우에서 Claude Code의 실제 작동 모습을 확인하세요.
Claude Code 소개
아이디어 구상에서 커밋까지 이어지는 단일 워크플로우에서 Claude Code의 실제 작동 모습을 확인하세요.
Video caption
Claude Code 소개
아이디어 구상에서 커밋까지 이어지는 단일 워크플로우에서 Claude Code의 실제 작동 모습을 확인하세요.
Introducing Claude Opus 4.6
We’re upgrading our smartest model. The new Claude Opus 4.6 improves on its predecessor’s coding skills. It plans more carefully, sustains agentic tasks for longer, and features a 1M token context window.
Introducing Claude Opus 4.6
We’re upgrading our smartest model. The new Claude Opus 4.6 improves on its predecessor’s coding skills. It plans more carefully, sustains agentic tasks for longer, and features a 1M token context window.
Video caption
Introducing Claude Opus 4.6
We’re upgrading our smartest model. The new Claude Opus 4.6 improves on its predecessor’s coding skills. It plans more carefully, sustains agentic tasks for longer, and features a 1M token context window.
Mintlify는 Coinbase, HubSpot 및 Perplexity 같은 기업에게 개발자 문서를 제공해 드리는 플랫폼입니다. Claude를 사용하여 문서와 관련된 문의 사항에 대한 67%를 담당 인력이 개입하지 않아도 해결해 주는 AI 어시스턴트를 운영합니다.
이와 동시에, 자동화 처리된 에이전트에서는 고객님의 문서를 코드 변경 사항과 함께 동기화로 처리합니다. Claude Code를 사용하여 내부적으로 엔제니어링 팀에서는 해당 기능을 3~4배 더욱 빠른 속도로 출시하는 것입니다.
Mintlify 문서 사이트에서는 담당 개발자만큼이나 AI 에이전트에서 수많은 요청 사항을 받고는 합니다.
Claude를 사용하여 Mintlify 가 거둔 성과는 아래와 같습니다.
- 문서와 관련된 문의 사항의 67% AI 어시스턴트가 담당 인력이 개입하지 않아도 해결
- 엔지니어당 담당하는 엔지니어링 코드 생산량은 증가 3~4배 증가
- 문서 버그 및 구식으로 구현된 콘텐츠 40% 감소
- 신규 기능 출시 기간은 50% 단축
당면했던 난제
Mintlify의 고객사에서는 두 가지 난제를 맞닥들였던 것입니다. 반복적으로 문서와 관련된 문의 사항때문에 개발자 관계팀에서는 업무 과부하 상태에 빠지게 되었던 것입니다. 그렇기 때문에 급격한 속도로 발전하는 코드 베이스에 맞춰서 문서화 작업이 이런 속도를 따라잡지 못하는 상황이 벌어졌던 것입니다.
리소스를 상당히 이미 고객수천 명의 API 개발자를 보유하고 있는 기업 고객사의 경우에는 이미 문서에 명시된 상태로 있는 내용에 대한 문의 사항에 상당한 규모의 지원 리소스를 할당해야 한다는 상황이 발생됐음을 의미했던 것입니다.
한편 API 엔드포인트는 변경되었으며, 코드 예시는 구식이 되어버린 상태였습니다. 이로써 매개변수 이름은 변경된 상황인데도 종종 몇 주 또는 몇 달 동안 이러한 내용이 변경됐다는 사실도 눈치채지 못하는 경우가 많았습니다. 커밋을 수동으로 검토 작업하는 기술 문서 작성자들은 이러한 내용들의 변경량에 대한 속도를 따라잡기에는 역부족이었습니다. 그 결과 발생한 문서 작업의 공백은 개발자들의 신뢰를 훼손하기에 이르렀습니다.
Mintlify는 고객사 뿐만 아니라 자체적인 엔지니어링 팀을 위해서라도 이러한 난제를 해결하는 일에 박차를 가했습니다. 품질을 유지시키면서도 기능 개발을 가속화해야 했고, 고객사에서 요청하는 개선 사항을 더욱 빠른 속도로 제공해 주어야 했던 것입니다.
Claude를 선택하다
Mintlify에서는 여러 개의 AI 공급업체를 평가했습니다. 이로써 AI 어시스턴트의 해결률과 문서 에이전트의 병합률을 측정했던 것입니다.
Claude에서는 두 지표 모두에서 경쟁사보다 지속적으로 뛰어난 수준의 성과를 보였던 것입니다.
Opus 4.5의 확장된 20만 단어 컨텍스트 창은 필수적인 항목이었습니다. 해당 문서 사이트에서는 API, SDK, 튜토리얼, 참고 자료에 관련된 내용을 다루고 있는 수백 페이지에 달하는 경우가 많기 때문입니다.
콘텐츠를 조각으로 분할하여 해당 맥락을 잃으려고 하는 대신에 단일 요청을 사용하여 전체 문서 코드 베이스를 처리할 수 있다는 사실은 AI 어시스턴트가 더욱 정확한 상태이고 해당 맥락에 충족하는 답변을 제공할 수 있는 수준이라는 것을 의미했습니다.
Mintlify의 엔지니어링 담당 매니저인 Nick Khami는 "우리 팀원 모두는 Claude를 사용하게 되고 이로써 수동으로 작성하는 양보다 훨씬 더많은 코드를 작성하게 되었습니다."라고 설명했습니다.
"엔지니어들은 Claude가 프로그래밍 작업에 가장 적합한 수준이라고 평가합니다. 사용해 봤던 타사 모델에 비해 모든 엔지니어들이 Claude를 선호하고 있습니다."
Claude를 구현하다
AI 어시스턴트는 2주만에 설계 원형 타입에서 생산 환경으로 구현을 완료했습니다. 소요 시간의 대부분은 설계 원형 엔지니어링과 컨텍스트 파이프라인 설계에 소요됐습니다. Claude API 통합에 대한 자체적인 작업은 간단하게 이루어졌습니다.
문서 유지를 하는 에이전트를 구축하는 것에는 일반적으로 소요되는 7~8주가 아닌 3~4주가 소요됐습니다. 이것은 Claude와의 호환성 부분에서 문제가 발생했다고 하기 보다는 코드 베이스 분석 및 git 작업 처리에 대한 복잡성을 반영한 결과물이었습니다. Claude Code에서는 별도의 구현을 하지 않아도 됩니다.
엔지니어들은 당일 설치한 이후에 바로 사용을 시작했습니다. 또한 기존의 개발 워크 플로우에 직접 통합되므로 학습 곡선도 최소화된 것입니다.
Mintlify, Claude를 고객사 문서에서 내부 개발까지 배포하다
AI 기반 문서 어시스턴트 기능: 모든 Mintlify 문서 사이트에서는 이제 Opus 4.5 기반으로 구축된 어시스턴트가 포함된 상태입니다.이로써 문서, 코드 예제, 실시간 API 스키마를 사용하여 자연어 질문에 답변하는 것입니다.
복잡한 다단계 질의를 처리해 드립니다. “SSO로 인증을 설정한 이후에 사용자 프로필 페이지를 어떤 방법으로 맞춤 설정하는 것인가요?”와 같은 복합적 질문을 분해하여 여러 개의 문서 섹션에서 정보를 추출하는 것입니다. 이로써 일관된 단계별 답변을 제공해 드리게 되는 것입니다.
해당 어시스턴트에서는 실시간 API 스키마를 가져오기 위해 도구 사용 기능을 사용하는 것이고 응답이 각 고객사의 제품 최신 상태를 반영해 드리도록 이를 보장해 드립니다.
자동화된 상태의 문서 유지 관리: 에이전트 시스템에서는 코드 저장소를 모니터링하게 됩니다. 또한 코드와 문서 사이에서의 불일치한 부분(예: 문서에서는 구버전을 참고하고 있는 동안 변경 작업 처리된 API 엔드포인트)를 감지하게 된다면 자동적으로 풀 리퀘스트를 생성해 내는 것입니다.
한 기업 고객사에서 첫 달에만 43개의 구식 코드 예제가 식별 및 수정 작업이 되었다는 사실이 입증됐습니다. 이러한 사실이 발견되지 않았다면 잠재적으로 지원 티켓을 발생해야 하는 문제들이었습니다.
Claude Code를 사용한 내부 엔지니어링 작업: 팀에서는 기능 구현, 레거시 코드 리팩토링, 복잡한 문제 디버깅, 테스트 작성 등 일상적인 개발 작업하기 위해서 Claude Code를 사용합니다. 해당 도구는 특히 프레임워크 마이그레이션과 엔지니어가 작업에 익숙하지 않은 코드베이스 부분을 이해하기 위한 것에 대단히 유용하다는 사실 입증된 바 있습니다. 최근 인증 시스템 리팩토링 작업은 3~4일정도 작업 시간이 소요될 것으로 예상했습니다. 그러나 해당 작업은 6시간 만에 완료된 것입니다.
결과
한 기업 고객사에서 개발 담당자의 만족도 점수는 어시스턴트를 도입한 이후 5점 만점에 3.8점에서 4.6점으로 만족도 점수가 상승했습니다. 해당 개발 담당자들은 특히 업무 시간 이외에도 즉각적으로 답변을 받는 것이 가능한 상태라는 점을 높이 평가했습니다.
수천 명의 API 개발자를 보유하고 있는 고객사의 경우, AI 어시스턴트를 사용하여 매월 수백 시간의 지원 작업 시간이 단축됩니다.
문서의 품질적인 측면에서 대단히 향상된 상태였습니다. 고객사들은 문서를 유지 및 관리하기 위해서 주당 8~12시간을 단축했습니다. 엔지니어링 작업 속도는 급격한 수준으로 가속화된 것이었습니다.
이제는 Mintlify팀에서는 이전 대비 3~4배 빠른 속도로 기능을 출시하고 있습니다. 또한기능요청부터 배포까지 소요되는 작업 시간은 3~4주에서 1~2주로 단축됐습니다.
이로써 고객사 유지율은 15% 개선된 상태입니다. AI 어시스턴트는 잠재 고객사가 Mintlify를 선택할 때 잠재 고객사가 지목하는 핵심적인 차별화 강점으로 자리매김하게 된 것입니다.
앞으로 Mintlify는 관련된 코드 베이스 내용 전반에 일관성 유지를 목적으로 다중 저장소 문서 오케스트레이션을 구현 중에 있습니다. 또한 지원 문제 사항이 되기 전에 문서의 누락 부분을 사전에 식별이 가능한 능동적 문서 인텔리전스의 기술을 탐색하고 있습니다.
"우리 팀원 모두는 수동적으로 작성하기 보다는 Claude를 사용하여 훨씬 방대한 양의 많은 코드를 작성하고 있습니다."
Mintlify의 엔지니어링 담당 매니저
Video caption