ClOr

사이드 프로젝트를 "언젠간 해야지" 하면서 미루는 개발자가 대부분이다. 나도 그랬다. 포트폴리오에 넣을 게 하나 필요한데, 매번 기획만 하다 흐지부지됐다.그래서 이번엔 조건을 걸었다. 오늘 하루 안에 아이디어부터 배포까지 끝낸다. 안 되면 프로젝트를 버린다. 도구는 Claude Code 하나. 이 글은 그 하루의 기록이다. 튜토리얼이 아니라 실제로 무슨 일이 있었는지를 시간순으로 적은 것이다. 삽질도, 좌절도 다 포함이다.목차만들려는 것타임라인09:00 — 프로젝트 초기화 (30분)프로젝트 개요기술 스택컨벤션주의사항빌드/실행09:30 — GitHub API 연동 (1시간)10:30 — AI 분석 로직 (1시간)절대 금지11:30 — UI 구현 (2시간)13:30 — 점심 + 중간 정리 (30분)14:00..

Claude Code를 매일 쓰면서도 Escape 하나 모르고, Shift+Tab이 뭔지 모르고, 슬래시 커맨드 절반을 안 써본 사람이 대부분이다. 공식 문서에 흩어져 있는 단축키, 커맨드, CLI 플래그, 환경변수를 한 페이지에 전부 모았다. 북마크 걸어두고 필요할 때 꺼내 보면 된다.모르면 마우스를 잡고, 같은 명령을 반복 입력하고, 삽질하는 Claude를 멍하니 지켜본다. 알면 키 하나로 끝난다.목차핵심 키보드 단축키몰랐을 수도 있는 것들슬래시 커맨드 완전 정리세션 관리모델 / 성능도구 / 설정작업 흐름CLI 플래그 — 시작할 때 거는 옵션들-p 플래그의 핵심--max-turns를 습관화해라파워유저 워크플로우 5가지파이프라인으로 Claude 쓰기원샷 스크립트 실행모델 전환 워크플로우세션 관리 워크플..

Claude Code에는 Hooks라는 기능이 있다. 도구 실행 전후에 셸 명령을 자동으로 끼워 넣는 기능이다.Git hooks를 써본 적 있으면 감이 올 것이다. 커밋 전에 린트를 돌리고, 푸시 전에 테스트를 돌리는 그 구조다. Hooks는 그걸 AI 에이전트 레벨에서 하는 것이다. Claude가 파일을 수정하기 전에 백업을 뜨고, 위험한 명령을 실행하려 하면 차단하고, 작업이 끝나면 Slack으로 알림을 보낸다.설정 한 번으로 반복적인 안전장치와 자동화가 걸린다. 매번 프롬프트에 "이건 하지 마"라고 쓸 필요가 없다.목차Hooks가 뭔가PreToolUsePostToolUseNotification기본 구조입출력 프로토콜PreToolUse — 입력 (stdin)PreToolUse — 출력 (stdout)..

Claude Code를 쓰면서 "왜 맨날 같은 얘기를 반복하지?"라고 느낀 적 있다면, CLAUDE.md를 안 쓰고 있거나 잘못 쓰고 있는 거다.이 파일 하나가 Claude Code의 행동 품질을 결정한다. 잘 쓰면 프로젝트 컨벤션을 첫 메시지부터 따르는 팀원이 되고, 못 쓰면 매번 "아니 그거 말고..."를 반복하게 된다.이 글은 CLAUDE.md를 제대로 작성하는 실전 가이드다. 어디에 두는지, 뭘 써야 하는지, 흔한 실수는 뭔지 전부 다룬다.목차CLAUDE.md가 뭔가왜 중요한가필수 섹션 5가지프로젝트 개요 (2-3줄)코드 컨벤션Conventions빌드/실행 명령어Commands아키텍처 핵심 규칙Architecture하지 말 것 (금지 목록)Do NOT좋은 CLAUDE.md vs 나쁜 CLAUDE...

Claude Code 평균 비용은 하루 $6, 90%의 사용자가 $12 이하다. 공식 문서에 명시된 수치다.하지만 모델을 잘못 고르거나, 컨텍스트 관리를 안 하거나, 팀을 과하게 돌리면 이 수치를 훌쩍 넘긴다. 이 글은 공식 문서와 검증된 커뮤니티 사례에서 가져온 비용 절약 전략 7가지를 정리한 것이다.목차먼저 요금 체계구독 플랜API 토큰 단가 (1M 토큰)Max vs API: 어느 쪽이 유리한가전략 1: 컨텍스트를 적극적으로 관리하라/compact — 대화 요약/clear — 작업 전환 시 즉시 실행전략 2: 모델을 전환하라전략 3: Effort 레벨을 조절하라전략 4: Hooks로 불필요한 토큰 유입을 차단하라전략 5: 서브에이전트에 장황한 작업을 위임하라전략 6: CLAUDE.md를 200줄 이하..

같은 이슈에 Claude, Codex, Copilot을 동시에 할당해서 각자 다른 접근법을 비교할 수 있다. GitHub Agent HQ는 이걸 가능하게 하는 멀티 에이전트 통합 플랫폼이다.2025년 10월 GitHub Universe에서 처음 발표됐고, 2026년 2월 4일 Claude와 Codex가 퍼블릭 프리뷰로 공개되면서 본격 가동됐다. 추가 구독료 없이 기존 Copilot 구독에 포함된다.목차사용 가능한 에이전트구독과 접근동작 방식VS Code 멀티 에이전트 통합실전 시나리오아키텍처 비교엣지 케이스 탐색단계별 분업Agent HQ vs 개별 실행커뮤니티 반응지금 시작하려면요약사용 가능한 에이전트현재 퍼블릭 프리뷰:에이전트제공상태GitHub CopilotGitHub (기본 내장)GAClaudeAnt..

Claude Code 세션 하나로 부족할 때가 있다. 보안 리뷰, 성능 분석, 테스트 커버리지를 동시에 돌리고 싶을 때. 프론트엔드, 백엔드, 테스트를 병렬로 작업하고 싶을 때.Agent Teams는 여러 Claude Code 인스턴스를 팀으로 묶어서 병렬로 돌리는 실험적 기능이다. 팀 리더 하나가 작업을 배분하고, 팀원들이 각자 독립된 컨텍스트 윈도우에서 작업한다. 팀원끼리 직접 메시지를 주고받을 수도 있다.환경변수 하나면 켜진다.목차활성화서브에이전트와 뭐가 다른가팀 구조사용법: 자연어로 지시병렬 코드 리뷰경쟁 가설 디버깅모듈별 분업팀원 간 통신디스플레이 모드Plan Approval — 구현 전 계획 승인비용: 단일 세션의 약 7배알려진 제한사항언제 쓰고 언제 안 쓰나요약활성화// ~/.claude/s..

Claude Code의 도구, 에이전트 루프, 컨텍스트 관리를 그대로 가져다 쓸 수 있는 SDK가 있다. pip install claude-agent-sdk 한 줄이면 된다.Claude Agent SDK(구 Claude Code SDK)는 Claude Code를 CLI가 아닌 라이브러리로 쓸 수 있게 해주는 공식 SDK다. 파일 읽기, 명령어 실행, 코드 편집, 웹 검색까지 — Claude Code가 할 수 있는 모든 것을 Python이나 TypeScript 코드에서 프로그래밍 가능하다.핵심은 query() 함수 하나다. 프롬프트를 넣으면 Claude가 알아서 도구를 호출하고, 파일을 읽고, 코드를 수정한다. 도구 실행 루프를 직접 구현할 필요가 없다.목차설치와 첫 실행최소 동작 코드Client SDK와..