AI 보조 코딩 잘하는 법 — 컨텍스트 관리·스킬·훅·서브에이전트 실전 팁

핵심 메시지

• AI 코딩의 성패는 컨텍스트 관리에 달려 있다. 컨텍스트 창은 유한한 "유리잔"이며 70~80%를 넘기면 품질이 급격히 떨어진다.
• 규칙(Claude.md/agents.md)과 스킬은 모델을 떠받치는 "발판"이지만, 새 모델이 나오면 오히려 발목을 잡을 수 있어 주기적으로 걷어내고 점검해야 한다.
• 스킬은 도구 간 이식이 가능한 표준으로, 직접 짜기보다 스킬 크리에이터로 만들고 반복 작업을 스킬로 굳히는 것이 좋다.
• 항상 계획부터 세우고(plan mode는 읽기 전용 안전 모드), 그 계획을 저장해 AI가 스스로 결과를 검증하게 만든다.
• 코드 작성이 병목이던 시대의 도구·프로세스를 그대로 쓰지 말고, 병목이 사람과 검증으로 옮겨간 현실에 맞게 재설계해야 한다.

쉽게 이해하기

발표자 알렉스는 노르웨이의 클로드 코드 앰버서더로, 지난 여름 이후 코드를 직접 한 줄도 쓰지 않았다고 말한다. 그는 도구에 상관없이 적용되는 마인드셋 중심의 팁 10가지를 빠르게 훑는다. 출발점은 "페어 프로그래밍 마인드셋": AI에 프롬프트만 던지고 결과를 받아들이는 게으른 방식 대신 능동적으로 협업해야 더 나은 버전의 자신이 된다는 것이다.

가장 중요한 원칙은 "컨텍스트가 왕"이다. 컨텍스트 창은 시스템 프롬프트, Claude.md, 도구·스킬 정의, 대화 내용이 채워지는 유리잔이며 크기는 오랫동안 20만 토큰, 최근 100만 토큰까지 늘었다. 다만 70~80%를 넘기면 결과가 나빠지므로 /context로 무엇이 창을 채우는지 확인하고, /compact로 압축을 유도하거나 요약을 마크다운으로 저장한 뒤 세션을 새로 시작하라고 조언한다.

규칙·메모리·스킬은 모두 관리 대상이다. Claude.md와 agents.md는 서로 참조시켜 어떤 도구에서도 같은 규칙을 쓰게 할 수 있다. 발표자는 규칙을 "발판(scaffolding)"에 비유하며, 새 모델이 나오면 과거의 상세한 규칙이 오히려 성능을 억누를 수 있으니 과감히 지우거나 클로드에게 "무엇을 없애야 하냐"고 물어보라고 권한다. 스킬은 이식 가능하고 이 업계가 모두 지지하는 표준이므로, 반복하는 일은 스킬로 만들되 직접 짜지 말고 스킬 크리에이터(평가 루프 내장)를 쓰라고 강조한다.

계획을 먼저 세우는 습관도 핵심이다. 플랜 모드는 읽기 전용이라 코드베이스를 안전하게 탐색하는 데도 쓸 수 있다. 계획을 마크다운으로 남기면 세션이 바뀌어도 이어지고, 무엇보다 AI가 완료 후 스스로 그 계획과 대조해 검증하게 만든다. 발표자는 코드 작성이 더 이상 병목이 아니게 되면서 병목이 "사람이 의도를 전달하는 일"과 "검증하는 일" 양쪽으로 옮겨갔다고 진단한다.

후반부는 통제와 확장 도구를 다룬다. 훅(hook)은 추론 밖에서 동작하는 확실한 가드레일로, pre-tool-use 이벤트로 rm 같은 위험 명령을 막거나 커밋 전 린트 실행 등을 강제한다. 서브에이전트는 각자 컨텍스트 창을 가져 사실상 무한 컨텍스트를 만들며 최대 5단계 중첩과 컨텍스트 포크가 가능하다. MCP와 CLI, 워크트리를 이용한 병렬 작업, 그리고 목표와 종료 조건만 주고 다수 에이전트를 돌리는 "루프 엔지니어링", /insights로 지난 세션을 분석해 개선점을 뽑는 컴파운드 엔지니어링까지 이어진다. 결론은 "클로드에게 물어보라", 그리고 사람이 루프 안에 남아 있으라는 것이다.

주요 인사이트

• 컨텍스트를 "귀한 자원"으로 다루는 것이 모든 팁의 토대다. 창을 가득 채우면 정보가 뒤섞여 모델이 중요한 규칙을 잊거나 무시하기 시작한다.
• 스킬과 규칙, 서브에이전트는 한 번 만들고 방치하면 새 모델의 발목을 잡는 "낡은 발판"이 된다. 모델이 바뀔 때마다 걷어내고 다시 점검해야 한다.
• AI에 일을 맡길수록 "완료됐다"를 사람이 일일이 확인하는 대신, AI가 스스로 검증할 도구와 방법을 주는 것이 가장 레버리지가 큰 투자다.
• 컴파운드 엔지니어링 — 매번의 실수에서 배우게 하고 그 학습을 스킬·훅으로 굳히는 것 — 이 반복될수록 협업 결과가 복리처럼 좋아진다.
• 코딩에서 먼저 드러났을 뿐, 병목이 이동하니 도구와 프로세스를 다시 설계하라는 통찰은 모든 지식 노동에 적용된다.

자주 묻는 질문

관련 AI 소식