TECHNIQUE
기법
바로 따라 할 수 있는 워크플로·패턴·레시피
페이지 35개 · 가나다순
스킬 문제 해결
스킬이 기대할 때 안 불리거나, 원치 않을 때 자꾸 불리거나, 처음엔 따르다 나중에 안 따를 때 증상별로 볼 순서다. 안 불리면 스킬 설명(description)에 사용자가 자연스럽게 말할 키워드가 들어 있는지부터 보고, 사용자가 부를 수 있는 스킬이면 /스킬이름으로 직접 불러 본다.
시스템 프롬프트·도구·예시 설계
에이전트에게 주는 바탕 지시(시스템 프롬프트), 쓸 수 있는 도구, 예시를 어떻게 짜야 하는지에 대한 원칙이다. 지시는 너무 세세한 규칙(if-else)도 너무 막연한 지침도 아닌 중간 수준으로 쓰고, 도구는 사람 엔지니어도 언제 무엇을 쓸지 확실히 말할 수 있게 겹치지 않는 최소 세트로 두며, 예외 규칙을 줄줄이…
업무 절차를 스킬로 만들기
반복하는 업무 절차 하나를 Claude Code의 스킬로 만들어, 다음부터 이름으로 불러 같은 절차를 따르게 하는 순서다. 후보 고르기, 둘 위치 정하기, 지시 파일 쓰기, 누가 부를지 정하기, 시험하기, 스킬을 켠 채와 끈 채로 결과 비교하기, 팀과 나누기로 진행한다.
업무 플러그인 설치·맞춤화
Anthropic이 GitHub에 공개한 직무별 업무 플러그인(영업, 재무, 법무 등)을 설치하고, 회사의 도구·용어·업무 방식에 맞게 고치는 절차다. Claude Code에서는 마켓플레이스를 먼저 추가한 뒤 플러그인 하나를 설치하고, 고칠 곳은 도구 연결 파일(.mcp.json)과 스킬 파일이다.
에이전트 시스템 패턴 고르기
업무를 AI로 자동화할 때 '어디까지 맡길까'를 정하는 사다리다. 원본(2024년 Anthropic 글)은 프롬프트 한 번으로 되는 일은 그렇게 하고, 부족할 때만 미리 정한 순서대로 도는 워크플로로, 그래도 유연한 판단이 많이 필요할 때만 AI가 스스로 과정을 정하는 에이전트로 한 칸씩 올리라고 한다.
장기 작업 컨텍스트 관리
작업이 길어져 Claude가 한 번에 볼 수 있는 양(컨텍스트 창)을 넘을 때 목표와 일관성을 잃지 않게 하는 세 방법이다: 대화를 요약해 이어 가기(컴팩션), 진행 상황을 파일에 노트로 남기기, 곁가지 일을 보조 작업자(서브에이전트)에게 맡기기.
처음 시작하기 - 비개발자를 위한 AI 에이전트 입문 코스
AI 에이전트를 처음 쓰는 사람이 "어디서부터, 무엇을, 어떤 순서로" 하면 되는지를 한 장에 모은 길잡이다. 코드 없이 문서·메시지·표 업무를 맡기고 싶으면 A 갈래(Claude Cowork), 내 컴퓨터의 작업 폴더에서 파일을 고치고 명령을 실행하는 에이전트를 안전하게 써 보고 싶으면 B 갈래…
AGENTS.md와 CLAUDE.md 함께 쓰기
Codex 같은 다른 AI 코딩 도구용 지시 파일 AGENTS.md가 이미 있는 폴더에서, Claude Code도 같은 지시를 읽게 하는 방법이다. Claude Code(v2.1.277 이상)는 기본으로 작업 폴더나 그 위에 CLAUDE.md(개인용 CLAUDE.local.md 포함)가 하나도 없을 때만…
ChatGPT Work 첫 업무 위임
ChatGPT Work에 처음 맡길 업무를 고르고 요청을 쓰는 방법이다. 결과가 분명하고, 쓸 자료가 몇 개 있고, 검토할 수 있는 결과물이 나오는 일을 고른 뒤, 요청에는 필요한 결과·쓸 자료·지킬 제약·좋은 결과의 모습·검토나 승인을 위해 멈출 시점 다섯 가지를 담는다.
Claude 대화 하나로 보고서·슬라이드 맡기기
Cowork와 일반 대화가 하나로 합쳐진 뒤, 평소 직접 만들던 주간 보고서와 발표 슬라이드를 대화 하나에서 함께 맡기는 방법이다. 무엇을 볼지, 어떤 형식으로 쓸지, 슬라이드가 몇 장 필요한지를 한 번에 말하고, 원본 사례에서도 사용자는 공유하기 전에 직접 한 줄을 고치고 메모를 단다.
Claude Code 관리자 권한 통제
회사 관리자가 Claude Code의 권한 모드와 규칙을 조직 단위로 정해, 고객이나 보안팀이 묻는 '에이전트가 마음대로 하지 않나'에 근거를 갖고 답하도록 정리한 페이지다. 핵심 장치는 조직 배포 설정(managed settings)의 금지 규칙과 모드 잠금이고, 금지 규칙은 모든 권한 모드에서 막는다.
Claude Code 권한 모드 고르기
Claude Code가 파일 편집이나 명령 실행 앞에서 얼마나 자주 물을지를 상황에 맞게 고르는 방법이다. 최근 버전(v2.1.283 이상)은 따로 정하지 않으면 대화형 터미널·VS Code 세션이 자동 모드로 시작하니, 먼저 입력창 아래 표시에서 지금 모드를 확인한다(세부 조건은 6절).
Claude Code 샌드박스 설정하기
Claude가 돌리는 셸 명령을 운영체제가 정한 경계 안에 넣고, 닿을 수 있는 파일과 인터넷 주소를 정하는 절차다(macOS는 바로 켜고, Linux·WSL2는 도구 두 개를 먼저 설치하며, Windows에서는 WSL2 안에서만 쓴다).
Claude Code 서브에이전트 만들기·운영
서브에이전트(일을 떼어 맡기는 별도 AI 작업자)를 만들고, 시험하고, 쓸 수 있는 도구를 좁혀 운영하는 절차다. Claude에게 '읽기 전용 코드 개선 도우미를 ~/.claude/agents/에 만들어 줘'처럼 부탁하면 정의 파일을 써 주고, 트랜스크립트(대화 기록 화면)에 그 이름의 호출 행이 보이면 위임된…
Claude Code 서브에이전트 문제 해결
서브에이전트가 안 보이거나, 로드되지 않거나, 엉뚱한 정의가 쓰이거나, 도구를 못 쓸 때 원인을 증상별로 모은 페이지다. 새로 만든 서브에이전트를 Claude가 못 찾으면 먼저 세션 시작 때 그 agents 폴더가 있었는지 보고, 없던 폴더에 첫 파일을 만들었다면 재시작한다.
Claude Code 설정 바꾸기·확인·문제 해결
Claude Code 설정 하나를 바꾸고, 정말 적용됐는지 확인하고, 안 먹으면 원인을 찾는 순서다. 나만·이 프로젝트만·팀 전체 중 누구에게 적용할지로 둘 파일을 고르고, /config 메뉴나 파일 편집으로 바꾼 뒤, /status의 Setting sources 줄로 어떤 설정 파일이 로드됐는지 본다.
Claude Code 세션·체크포인트 다루기
Claude Code로 일하는 중에 멈추고, 방향을 고치고, 되돌리고, 이전 대화를 이어 가거나 갈라 보는 방법이다. Claude는 파일을 고치기 전에 저장본(체크포인트)을 만들어 두므로 Esc를 두 번 눌러 되감을 수 있다.
Claude Code 셋업 점진적으로 키우기
Claude Code의 확장 기능을 처음부터 다 설정하지 않고, 불편이 생길 때마다 그 불편에 맞는 기능을 하나씩 더하는 방법이다. 시작은 프로젝트 관례를 적은 CLAUDE.md이고, 예컨대 Claude가 같은 관례나 명령을 두 번 틀리면 CLAUDE.md에 적는 식으로 계기마다 더할 기능이 정해져 있다.
Claude Code 자동 모드 설정하기
자동 모드에서는 사람 대신 분류기(동작을 실행 전에 검토하는 자동 검사기)가 Claude의 동작을 판정하는데, 기본으로 작업 폴더와 현재 저장소만 믿어서 회사 저장소로 push하기 같은 일상 작업도 막힐 수 있다.
Claude Code 차단 훅 단단하게 만들기
'이 명령은 막는다' 같은 약속을 훅으로 걸 때, 훅이 조용히 새는 경우를 하나씩 막는 점검 순서다. 막으려면 종료 코드 2(또는 거부 결정)를 쓰고, 경로를 잘못 써서 훅이 한 번도 안 도는 일이 없게 첫 실행을 눈으로 확인하고, PowerShell·@ 참조…
Claude Code 출력 스타일 설정·만들기
Claude의 말투·길이·형식을 세션 전체에 걸어 두는 출력 스타일을 내장 네 가지(Proactive, Concise, Explanatory, Learning) 중에서 고르거나 직접 만드는 절차다.
Claude Code 확장 기능 고르기
CLAUDE.md, 스킬, 서브에이전트, MCP, 훅, 출력 스타일처럼 Claude Code에 붙이는 확장 기능 가운데 내 목적에 맞는 것을 고르는 기준이다. 원본의 기본 구분은, Claude가 항상 알아야 하면 CLAUDE.md, 가끔 필요한 참고 자료나 이름으로 부르는 절차면 스킬, Claude의 판단 없이 같은…
Claude Code 훅 문제 해결
훅이 아예 안 돌거나, 'hook error'가 뜨거나, 결과를 냈는데 효과가 없을 때 증상별로 먼저 볼 곳을 모은 점검표다. 첫 점검은 /hooks 명령으로 훅이 맞는 이벤트 아래 등록됐는지와, 대상을 거르는 조건(matcher)의 대소문자가 맞는지 보는 것이다.
Claude Code 훅 설정 레시피
훅을 어디에 둘지 고르고, 데스크톱 알림 같은 첫 훅을 만든 뒤, 편집한 파일 자동 포맷·보호 파일 편집 막기 같은 공식 예시를 그대로 가져다 쓰는 레시피 모음이다.
Claude Code managed settings 배포·점검
관리자가 조직 설정(managed settings)을 직원 기기에 배포하고, 실제로 걸렸는지 확인하고, '정책이 안 먹는다'를 진단하는 절차다. 가장 빠른 길은 managed-settings.json 파일 하나를 운영체제별 시스템 폴더에 두고, 한 대에서 /status의 Setting sources 줄로 확인한 뒤…
Claude Cowork 시작 세팅
Cowork를 처음 쓰는 날 한 번 해 두는 준비다. 데스크톱 앱과 유료 플랜을 확인하고, 자주 쓰는 업무 앱을 연결하고, Claude가 얼마나 자주 확인을 받을지 고르고, 필요하면 폴더를 연결하고, 늘 지킬 지시(말투·결과 형식·내 역할)를 넣는다.
Claude Cowork 첫 업무 위임
Cowork를 세팅한 뒤 처음 10분에, 연습용 질문 대신 오늘 직접 하려던 실제 업무 하나를 맡겨 보는 방법이다. 원본이 드는 예는 PDF 묶음으로 한 쪽 요약 만들기, Slack 채널 하나의 지난주 대화로 상태 보고 초안 쓰기, 지저분한 표를 정리해 차트 만들기다.
CLAUDE.md 문제 해결
CLAUDE.md에 적은 지시를 Claude가 따르지 않거나, AGENTS.md가 안 읽히거나, /compact 뒤 지시가 사라진 것 같을 때 증상별로 볼 순서다.
CLAUDE.md 작성·구성
CLAUDE.md를 처음 만들고, 길어지면 나누고, 주기적으로 점검하는 절차다. Claude에게 초안을 만들게 한 뒤 Claude가 스스로 알아낼 수 없는 지시를 더하고, '테스트하라' 대신 '커밋 전에 npm test를 돌려라'처럼 확인할 수 있게, 파일당 200줄 이하를 목표로 쓴다.
Gemini CLI에서 Antigravity CLI로 옮기기
Gemini CLI에서 쓰던 지시 파일, 확장 기능, 스킬, 바깥 서비스 연결 설정을 Antigravity CLI로 옮기는 순서다. 먼저 내가 옮겨야 하는 사람인지…
index·log 운영
위키가 커질 때 LLM과 사람이 길을 찾게 해 주는 두 파일이다. index.md는 모든 페이지를 카테고리별로 '링크 — 한 줄 요약'으로 적은 목록이라 질문할 때 LLM이 먼저 읽고, log.md는 언제 무엇을 수집·질의·점검했는지 맨 아래에 추가만 하는 시간순 기록이다.
LLM Wiki 수집(Ingest)
새 자료를 위키에 넣는 작업으로, 찾아보기용 색인만 하는 것이 아니라 관련된 기존 페이지 곳곳에 그 내용을 녹여 넣는 것이 핵심이다. 자료를 raw 폴더에 넣고 수집을 요청하면 LLM이 읽고, 핵심을 사용자와 이야기하고, 요약 페이지를 쓰고, index와 관련 페이지를 고치고, log에 기록한다.
LLM Wiki 점검(Lint)
위키가 커져도 건강하게 유지되도록 LLM에게 주기적으로 위키 상태를 점검하게 하는 작업이다. 페이지끼리 말이 다른 곳, 더 새 자료가 대체한 낡은 주장, 들어오는 링크가 없는 페이지, 자기 페이지가 없는 중요한 개념, 빠진 교차 참조, 웹 검색으로 채울 빈 곳 여섯 가지를 찾게 한다.
LLM Wiki 질의(Query)
위키에 질문하면 LLM이 목록 파일(index)을 먼저 읽고 관련 페이지를 찾아 인용을 달아 답하는 작업이다. 핵심은 비교·분석·새로 찾은 연결처럼 가치 있는 답을 대화 기록 속에 사라지게 두지 않고 새 위키 페이지로 저장하는 것이다. 그래야 질문하며 탐색한 것도 넣은 자료처럼 위키에 쌓인다.
Obsidian 웹 자료 수집 세팅
웹 글을 이미지까지 내 컴퓨터에 받아 raw 폴더에 넣고 LLM이 읽게 하는 세팅으로, 수집 작업의 앞단이다. 브라우저 확장 Obsidian Web Clipper로 글을 마크다운으로 가져오고, 첨부파일 폴더를 고정한 뒤, 'Download attachments for current file'에 단축키를 걸어 이미지를 한…