핵심 요약
앤트로픽(Anthropic) 개발자들이 클로드 코드(Claude Code)를 직접 개발하고 매일 현업에서 활용하며 축적한 실무 작업 노트를 모은 개발자 허브 사이트 claude.dev가 공개됐다. 등록된 아티클은 13편에 불과하지만 오푸스(Opus) 5.5 모델 전환, 토큰 비용 최적화, 컨텍스트 엔지니어링 등 실무에서 가장 빈번하게 마주하는 병목 지점마다 정밀한 처방을 담았다. 이 가이드는 어디서 필요한 정보를 찾고, 선배 엔지니어들의 실전 권고를 어떻게 내 개발 환경에 옮겨올 수 있는지 체계적으로 짚는다.
claude.dev는 어떤 사이트인가
앤트로픽 개발자 공식 계정(@ClaudeDevs)은 2026년 9월 30일 공식 소셜 미디어를 통해 사이트 공개를 알렸다. 사이트는 스스로를 “앤트로픽 개발자들의 팁과 요령, 관점을 나누는 공간(Sharing tips, tricks, and POVs from Anthropic’s developers)”으로 규정한다.
https://t.co/sRyO7OigQ7 is our new home for developers building with Claude.
— ClaudeDevs (@ClaudeDevs) September 30, 2026
You'll find engineering deep dives, Claude Code and API guides, tips from the teams building Claude, and some fun easter eggs. pic.twitter.com/8fC7k63xpP
로그인 없이 자유롭게 열람할 수 있는 아티클은 10월 3일 기준 총 13편이다. 7편은 타리크 시히파르(Thariq Shihipar)가, 4편은 애디 오스마니(Addy Osmani)가 집필했다. 두 사람 모두 클로드 코드를 만드는 핵심 엔지니어다. 1인칭 개발 경험담이 주를 이뤄 딱딱한 사용 설명서라기보다 선배 엔지니어의 생생한 작업 노트에 가깝다.
공식 기술 문서와는 성격과 지향점이 확연히 다르다. 화면 상단 메뉴의 DOCS를 누르면 code.claude.com의 클로드 코드 공식 문서로 연결된다. 설치 명령어와 설정값의 표준 규격을 확인하는 곳이 문서라면, claude.dev는 그 기능을 언제, 왜, 어떤 실무 맥락에서 선택해야 하는지 해설한다. 이용약관에서도 사이트 콘텐츠를 엔지니어링 일반 정보로 규정하고 있으며, 일부 초안은 AI의 지원을 받아 작성되었을 수 있음을 명시하고 있다.
기존 claude.com 블로그 링크를 북마크해 둔 독자라도 접속에 혼선은 없다. 13편 중 7편은 원래 claude.com/blog에 게시되었던 글이지만, 예전 주소로 접속해도 claude.dev의 해당 글로 끊김 없이 자동 연결된다.
첫 화면에서 길 찾기
화면 위쪽 네비게이션 메뉴는 HOME, MODS, DOCS, TERMINAL 4개로 구성된다. 메뉴 이름 앞 대괄호 안의 알파벳이 단축키다. 실제로 눌러 보면 H, M, D, T 키가 각각 해당 화면으로 즉시 전환된다.
HOME 화면에는 글 목록과 분류 필터, 검색창, 추천 영상이 배치돼 있다. 필터는 ALL, AGENTS, ENGINEERING, PLAYBOOKS, SKILLS, TUTORIALS 6개 카테고리로 나뉜다. 첫 화면에는 10편이 표시되며, R 키를 누르거나 하단의 ‘LOAD MORE’를 누르면 나머지 3편이 이어진다. 첫 화면 아래 추천 영상 5편은 클로드 공식 유튜브 채널로 연결된다. 램프(Ramp) 엔지니어의 AI 에이전트 활용기와 도어대시(DoorDash)가 전사 직원에게 클로드 코드를 배포한 사례 영상도 이곳에서 확인할 수 있다.
| 분류 | 편수 | 주요 다룸 내용 |
|---|---|---|
| PLAYBOOKS | 5 | 오푸스 5.5·소넷(Sonnet) 5.5 사용법, 작업 비용, 평가 설계, HTML 결과물 |
| ENGINEERING | 4 | 프롬프트 캐싱, 컨텍스트 설계, effort, claude.ai 속도 개선기 |
| AGENTS | 2 | 에이전트용 도구 설계, 동적 워크플로 |
| SKILLS | 1 | 앤트로픽 내부의 스킬 운영 경험 |
| TUTORIALS | 1 | 첫 mod 만들기 |
S 키를 누르면 열리는 검색창은 아티클 제목을 기준으로 색인된다. cache로 검색하면 결과가 0건으로 나오며, 제목에 명시된 단어인 caching으로 입력해야 캐싱 관련 글이 노출된다. 모든 글의 제목이 영문이므로 검색어 역시 영문 표제어 기반으로 입력해야 한다.
상황별로 먼저 읽을 글
13편을 처음부터 순서대로 완독할 필요는 없다. 아래 표는 각 아티클이 제시하는 실무 처방을 한눈에 파악할 수 있도록 집약한 로드맵이다. 왼쪽 열에서 지금 당장 겪고 있는 병목이나 당면 과제를 먼저 찾으면 된다.
기능 이름보다 막힌 일이 더 좋은 검색어다.
| 이런 때 | 먼저 읽을 글 | 글이 권하는 것 |
|---|---|---|
| 새 모델로 바꿨는데 결과가 어색하다 | 오푸스 5.5 가이드 | 일을 한 번에 넘기고 ‘끝’의 기준을 적는다. “신중히 생각하라” 같은 문장은 지운다 |
| 소넷과 오푸스 중 무엇을 쓸지 모르겠다 | 소넷 5.5 가이드 | 범위가 분명한 일상 작업은 소넷, 판단이 많은 긴 작업은 오푸스 |
| 사용량 한도가 빨리 닳는다 | 오푸스 5.5 작업 비용 | /usage로 캐시 비율을 보고, effort는 medium에서 시작한다 |
| effort 단계를 언제 올려야 할지 모르겠다 | effort 가이드 | 구현은 low, 검증은 high로 나눈다 |
| 지침이 길어지고 서로 부딪친다 | 컨텍스트 엔지니어링 | 규칙을 덜어내고 모델의 판단에 맡긴다 |
| 같은 지시를 매번 다시 붙여 넣는다 | 스킬 활용 가이드 | 스킬로 묶고, 자주 틀리는 지점을 따로 적는다 |
| 여러 단계짜리 큰 일을 맡기고 싶다 | 동적 워크플로 가이드 | 동적 워크플로로 여러 에이전트를 돌린다. 토큰은 더 든다 |
| 긴 결과물을 읽고 공유하기 힘들다 | HTML 산출물 가이드 | 마크다운 대신 HTML로 받아 링크로 공유한다 |
| 에이전트에 붙일 도구를 설계한다 | 에이전트 도구 설계 | 모델의 눈으로 도구를 본다 |
| 내 앱 품질을 숫자로 올리고 싶다 | 평가 자동화 가이드 | 평가를 먼저 만들고 한 번에 하나씩 바꾼다 |
| 클로드 코드 화면에 기능을 더하고 싶다 | mods 튜토리얼 | 빈 폴더에서 80줄짜리 mod를 만든다 |
한 편을 고를 때는 작성 일자와 제목 속 모델명부터 확인해야 한다. 오푸스 5.5나 소넷 5.5처럼 특정 모델명이 명시된 글은 해당 모델의 아키텍처를 전제로 서술된 조언이다. 세대가 다른 모델에서는 기본 반응 특성과 파라미터 최적값이 달라 조언이 그대로 적용되지 않을 수 있다.
글을 열면 제목 하단에 저자와 게시 일자, 예상 완독 시간이 표시된다. ‘TREE’로 표기된 목차 네비게이션을 통해 원하는 절로 곧바로 이동할 수 있으며, 키보드 위아래 화살표 키로 단락을 넘길 수 있다. 비용 분석 글처럼 변수를 바꿔가며 결과를 시뮬레이션할 수 있는 인터랙티브 계산기가 내장된 아티클도 존재한다.
코딩을 하지 않아도 쓸 수 있는 대목
개발자 전문 사이트라고 해서 소프트웨어 엔지니어만 얻을 수 있는 정보에 국한되지 않는다. 오푸스 5.5 실전 가이드의 「클로드 앱에서(In the Claude App)」 절은 터미널이 아닌 일반 웹 채팅 인터페이스에서 즉시 적용할 수 있는 프롬프트 노하우를 집중적으로 다룬다. 출발점은 상단 모델 선택 메뉴가 오푸스 5.5로 지정돼 있는지 확인하는 절차다.
방대한 분량의 기획서나 보고서, 발표 자료에서 논리적 충돌과 오류를 교정하게 할 때는 프롬프트를 극도로 구체적으로 설계해야 한다. 아티클이 권장하는 질문 템플릿은 숫자, 일자, 고유명사 간 상호 모순을 적시하고, 문제마다 원문 문장을 직접 인용해 출처 위치를 명시하도록 요구하는 구조다.
차트나 대시보드 화면은 텍스트로 옮겨 적지 말고 캡처 이미지를 대화창에 직접 첨부하는 편이 정확하다. 정형화된 데이터나 구조화된 문서가 필요할 때는 대략적인 개요가 아닌 완전한 서식 파일을 요구해야 한다. 긴 세션에서 후속 질의 응답 속도가 현저히 느려질 경우, 프로젝트 지침에 “앞서 답변한 내용은 완료된 것으로 간주하라”는 문구를 명시하는 것만으로 연산 지연을 줄일 수 있다.
시스템 안전 장치나 사용량 제한으로 인해 이전 세대 모델로 자동 다운그레이드된 경우의 대처법도 정리돼 있다. 채팅창에 “Switched to” 알림이 나타나면 모델 메뉴에서 오푸스 5.5를 수동으로 다시 지정해야 한다. 일방적인 자동 다운그레이드 대신 사전 확인을 거치게 설정하려면, 환경설정(Settings)의 기능(Capabilities) 탭에서 해당 자동 전환 옵션을 비활성화하면 된다.
클로드 코드 사용자라면 비용 글을 계기판처럼 쓴다
「오푸스 5.5에서 작업 한 건은 얼마인가」는 예상 독서 시간이 21분에 달하는, 사이트 내에서 가장 방대한 아티클이다. 핵심 메커니즘은 턴(Turn) 구조에 있다. 클로드 코드는 턴이 진행될 때마다 그때까지 누적된 대화 전체를 모델에 다시 전송한다. 따라서 이전 턴의 컨텍스트를 재사용하는 프롬프트 캐시(prompt caching) 히트율이 작업 비용 전체를 좌우한다. 아티클이 제시한 실측 예시에서 입력 280만토큰은 캐시가 전혀 없을 때 11.2달러(약 1만5000원)에 달하지만, 90%를 캐시에서 읽어 들이면 1.62달러(약 2200원)로 급감한다.
캐시는 기다려 주지 않는다. API 키 연동 환경에서 프롬프트 캐시의 유효 수명은 기본 5분이며, 유료 구독 요금제 기반에서는 1시간 동안 유지된다.
자리를 비운 사이 데워 둔 냄비가 식는 것과 같다.
아래 CLI 명령어들은 비용 가이드에서 제시하는 필수 점검 도구들이며, 매 작업이 종료될 때마다 /usage를 실행해 세션을 계측하는 습관이 비용 통제의 기본이다.
/usage 결과 화면에서는 세 가지 지표를 교차 검증해야 한다. 장시간 이어진 세션임에도 캐시 히트 비율이 낮다면 작업 도중 긴 자리 비움이 있었거나, 잦은 모델 교체, 혹은 중간에 무겁게 추가된 MCP 서버의 영향인지 의심해야 한다. 경미한 코드 수정임에도 출력 토큰이 비정상적으로 많다면 effort 설정이 과도하게 높거나 모델이 내부 재시도를 반복한 흔적이다. 총 입력 토큰이 실제 대화 분량의 수 배에 달한다면 턴 수가 과다하게 누적되었다는 방증이므로, 로그를 복기해 모델이 어느 지점에서 맴돌았는지 짚어내야 한다.
오푸스 5.5의 effort 기본값은 medium으로 설정돼 있으며, 이는 이전 오푸스 5의 high보다 한 단계 낮은 수치다. 글은 오푸스 5에서 사용하던 effort 값을 무비판적으로 계승하지 말 것을 당부한다. 동일한 단계 명칭이라도 모델 세대마다 투입되는 사고(Thinking)의 총량이 근본적으로 다르기 때문이다.
시히파르는 effort 분석 글에서 자신의 실무 작업 파이프라인을 공개했다. 먼저 요구 명세를 전달한 뒤 누락된 맥락을 클로드가 역질문하게 유도하고, low 단계에서 빠른 초안 코드를 뽑아낸 다음, 전반적인 아키텍처 방향성을 검토한 뒤 최종 검증 단계에서만 high로 올려 꼼꼼하게 에러를 잡는 방식이다. 신속한 초안 생성과 정밀한 검증을 단계별로 나누어 연산 비용을 최적화하는 전략이다.
지침과 스킬을 정리할 때
프로젝트 루트의 CLAUDE.md와 스킬 파일이 과도하게 비대해졌다면 컨텍스트 엔지니어링 가이드를 정독할 필요가 있다. 시히파르는 오푸스 5 계열 모델 도입 당시 클로드 코드 시스템 프롬프트의 80% 이상을 과감히 삭제했음에도, 벤치마크 평가에서 유의미한 성능 저하는 전혀 측정되지 않았다고 공개했다. 세부 지침이 빽빽하게 상충할수록 모델은 규칙 간의 우선순위 충돌을 조율하는 데 아까운 추론 자원을 허비하기 마련이다.
아티클은 CLAUDE.md를 최대한 슬림하게 유지하라고 주문한다. 저장소가 해결하고자 하는 핵심 목표를 한두 줄로 간결히 규정하고, 나머지 분량은 해당 코드베이스에서만 발생하는 비직관적 함정(Gotchas)을 명시하는 데 집중해야 한다. 디렉터리 구조나 표준 라이브러리처럼 파일을 열어보면 즉시 알 수 있는 자명한 사실은 적지 않는 것이 원칙이다. 클로드 코드의 /doctor 명령어를 실행하면 불필요하게 비대해진 지침을 진단하고 정돈하는 데 도움을 받을 수 있다.
스킬 아티클은 스킬의 본질을 지침과 자동화 스크립트, 참조 자료가 응축된 전용 디렉터리로 정의한다. 개발팀이 꼽은 가장 가치 있는 파트는 클로드가 자주 실수하는 패턴을 집약한 ‘함정(gotchas)’ 섹션이다. 아울러 스킬 설명문(Description)은 단순한 기능 요약이 아니라 모델이 ‘어떤 조건과 트리거에서 이 스킬을 호출해야 하는지’를 명시하는 호출 조건문이어야 한다. 구체적인 설치 및 레지스트리 등록 절차는 사용 중인 도구의 공식 문서를 통해 교차 확인해야 한다.
스킬 내용을 웹 채팅창에 붙여 넣는다고 스킬이 설치되지는 않는다.
에이전트에게 claude.dev를 읽힐 때
claude.dev는 사람뿐만 아니라 AI 에이전트가 직접 읽고 소비하기에도 최적화된 아키텍처를 지니고 있다. 사이트는 LLM 크롤러를 위해 전체 글 목록을 정리한 llms.txt를 공식 제공한다. 각 아티클 주소 끝에 .md 확장자만 덧붙이면 군더더기 없는 마크다운 원문을 즉시 획득할 수 있으며, 전체 메타데이터는 posts.json으로, 신규 발행 피드는 RSS로 구독 가능하다.
| 용도 | 접속 엔드포인트 |
|---|---|
| AI 에이전트용 글 목록 | https://claude.dev/llms.txt |
| 개별 아티클 마크다운 원문 | https://claude.dev/blog/<아티클_주소>.md |
| 글 목록 전체 JSON 데이터 | https://claude.dev/posts.json |
| 신규 아티클 RSS 피드 | https://claude.dev/rss.xml |
웹 화면 상단의 ‘Copy markdown’ 버튼을 눌러 본문 전체를 복사한 뒤, 클로드 코드나 IDE에 붙여 넣고 내 프로젝트 환경과 비교 검토를 요청하면 손쉽게 맞춤형 조언을 얻을 수 있다.
이용약관상 예제 코드는 관대한 MIT 라이선스가 적용되지만, 본문 아티클은 출처를 명시한 제한적 인용만 허용되므로 글 전문을 외부 매체나 저장소에 무단 복제해 게시하는 행위는 피해야 한다.
TERMINAL과 MODS 둘러보기
TERMINAL 메뉴는 웹 브라우저 안에서 CLI 명령어로 사이트 전체를 탐색할 수 있는 가상 셸 인터페이스다. 프롬프트 창에 /help를 입력하면 사용 가능한 11개 명령어가 출력된다. 실제로 터미널에서 /read 1을 실행하면 목록 최상단의 mods 튜토리얼 아티클이 즉시 호출된다.
| 명령어 | 수행 기능 |
|---|---|
/posts | 글 다섯 편을 추가로 불러오기 |
/read <n> | 직전 조회 목록의 n번째 아티클 열람 |
/home · /clear | 메인 화면 복귀 · 터미널 화면 초기화 |
/changelog | 클로드 코드 릴리스 변경 이력 조회 |
/theme | 터미널 색상 테마 전환 |
/radio · /game | 스트리밍 라디오 재생 · 터미널 게임 ‘CLAWD QUEST’ 실행 |
/stickers · /plushies | 클로드 코드 공식 스티커·인형 교환 코드 |
MODS 페이지는 클로드 코드 플러그인 생태계 내부에서 인터페이스와 런타임 동작을 커스텀 확장하는 마이크로 함수 ‘mods’를 소개하고 3가지 대표 사례를 시연한다. ‘Token weather’는 현재 컨텍스트 윈도우가 얼마나 차올랐는지를 날씨 위젯 형태로 시각화하며, ‘Blast radius’는 파일 삭제 등 파괴적인 셸 명령어를 사전 감지해 영향 범위를 경고한다. ‘Replay theater’는 직전 턴 동안 클로드가 수정한 코드 내역을 기록해 변경 사항을 단계별로 되감아 볼 수 있게 돕는다.
웹에서 ‘Play’ 버튼을 눌러 인터랙티브 데모를 감상하는 것만으로는 로컬 환경에 플러그인이 설치되지 않는다. 실제로 mod를 구동하려면 클로드 코드 2.1.287 이상 버전이 필요하며, 세부 설치 기준은 공식 mods 개요 문서에 명시돼 있다. 터미널에서 claude --version 명령으로 현재 설치된 버전을 사전에 확인해야 한다.
설치를 진행하기 전 공식 문서가 명시한 보안 경고를 숙지해야 한다. 공식 가이드에 따르면 mod는 사용자의 로컬 시스템 권한으로 실행되므로 파일 시스템을 임의로 읽고 쓰거나, 환경 변수의 API 키 등 민감 정보를 탈취하고 도구 호출을 대신 승인할 수 있는 강력한 실행 권한을 가진다. 따라서 신뢰성이 완벽히 검증된 제작자의 코드만 설치해야 하며, 설치 전 claude plugin validate 명령으로 해당 플러그인이 어떤 시스템 이벤트를 후킹하는지 검사해야 한다. 비활성화 시에는 /plugin의 Installed 탭에서 개별 해제하거나, --safe-mode 옵션으로 전체 플러그인을 일시 격리할 수 있다. GUI를 렌더링하는 mod는 순수 터미널 및 데스크톱 앱의 Code 탭에서만 동작하며, VS Code 확장 프로그램 채팅창이나 데스크톱 앱의 WSL 세션에서는 렌더링되지 않는다.
읽을 때 주의할 점
claude.dev에 인용된 성능 및 비용 수치는 앤트로픽 내부의 특수 통제 환경에서 실측된 수치가 상당수 포함돼 있다. effort 가이드의 벤치마크 데이터는 과제당 5회 반복 실행의 내부 통계이며, 특히 비교군으로 등장한 페이블(Fable) 5.1은 상용 프로덕션 환경의 안전 개입 필터가 해제된 상태였다. 아티클 본문에서도 외부 공개 리더보드의 수치와 완벽히 일치하지 않을 수 있음을 각주로 단서를 달았다.
비용 분석 아티클의 금액 역시 종량제 API 정가를 기준으로 산출된 모델링 예시다. 정액제 구독 요금제 환경에서 /usage가 출력하는 달러 수치는 실제 결제 청구서가 아니라 작업 세션의 상대적 부하를 나타내는 연산 눈금으로 해석해야 한다. mods 개발 가이드 역시 내부 API 규격이 향후 마이너 릴리스마다 변경될 수 있음을 지속적으로 경고한다.
따라서 아티클에서 유용한 처방 하나를 발견했다면, 곧장 전체 프로젝트에 적용하기보다 격리된 작업 단위 하나를 골라 전후 차이를 직접 계측해야 한다. 동일한 코딩 과제를 변경 전과 후로 나누어 수행한 뒤 /usage 토큰량과 코드 품질을 대조해보면 해당 기법이 내 워크플로에 진정으로 부합하는지 명확히 판별할 수 있다.
비용 분석 아티클을 기고한 애디 오스마니 역시 글 말미에 엔지니어링의 본질을 꿰뚫는 한마디를 남겼다.
“남의 벤치마크나 정가표가 아닌, 당신의 터미널에서 직접 잰 숫자가 유일하게 신뢰할 수 있는 기준이다.”
