CONCEPT
개념
에이전트를 다룰 때 알아야 할 개념
페이지 29개 · 가나다순
권한 모드
권한 모드는 에이전트가 무엇을 묻지 않고 바로 하고, 무엇 앞에서 멈춰 내 허락을 받을지 정하는 설정으로, Claude Code에서는 읽기만 알아서 하는 모드부터 거의 모든 것을 묻지 않는 모드까지 고른다. 설정에 적은 금지 규칙은 모든 모드에 기본으로 걸리지만, 명령을 글자 그대로 맞춰 보는 한계가 있다.
메모리(CLAUDE.md)
CLAUDE.md는 Claude Code가 세션을 시작할 때 읽는 메모 파일이다. 새 세션은 이전 대화를 모른 채 시작하므로, 안 적어 두면 매번 다시 설명하게 될 빌드 방법·규칙·프로젝트 구조를 여기에 적는다.
샌드박스
샌드박스는 Claude가 내 컴퓨터에서 실행하는 명령이 닿을 수 있는 파일과 인터넷 주소를 운영체제가 제한하는 장치다(비유로 말하면 명령 둘레의 울타리). 켜 두면 모델이 무엇을 실행하기로 했든 그 명령에 경계가 유지되지만, 기본으로 꺼져 있고 Claude가 실행하는 명령만 감싼다(파일 편집 기능 등은 밖에서 돈다).
서브에이전트
서브에이전트는 메인 대화와 떨어진 자기 작업 공간에서 곁가지 일(넓은 검색, 많은 파일 읽기 등)을 하고 결과 요약만 돌려주는 보조 작업자다. 메인 대화가 다시 볼 일 없는 검색 결과나 파일 내용으로 가득 차지 않게 하는 것이 핵심 이점이다. 다만 보조 작업자가 쓰는 양도 메인 대화와 같은 사용량 한도에 잡힌다.
서브에이전트 정의 파일 레퍼런스
서브에이전트(메인 대화가 일을 떼어 맡기는 별도 AI 작업자)를 정의하는 마크다운 파일의 형식을 찾아보는 페이지로, 꼭 필요한 항목은 이름(name)과 설명(description) 둘뿐이고 쓸 도구·모델·권한 모드 같은 나머지는 선택이다.
스키마 파일
스키마 파일은 AI 에이전트에게 '이 위키(또는 프로젝트)는 이렇게 구성돼 있고, 이런 규칙과 순서로 일한다'를 알려 주는 문서로, Claude Code에서는 CLAUDE.md, Codex에서는 AGENTS.md가 그 역할을 한다.
스킬
스킬은 Claude에게 특정 일을 하는 방법이나 참고 지식을 적어 두는 문서 파일이다. 필요할 때만 읽어 들이므로, 같은 지시나 체크리스트를 채팅에 계속 붙여 넣고 있다면 스킬로 만들 때라고 원본은 말한다. 이름으로 직접 부를 수도 있고, 관련 있다고 판단하면 Claude가 알아서 불러 쓰기도 한다.
에이전트 루프
에이전트 루프는 AI 에이전트가 일을 끝낼 때까지 '맥락을 모으고, 행동하고, 결과를 확인하는' 세 단계를 되풀이하는 구조다. Claude Code에서는 파일 검색·편집·테스트 실행 같은 도구 사용이 이 반복을 움직이고, 사용자는 어느 시점에든 끼어들어 방향을 바꿀 수 있다.
용어 사전
이 위키에 자주 나오는 영어·기술 용어를 한두 문장으로 풀어 둔 페이지다. 모르는 말이 나오면 여기서 찾고, "자세히"에 있는 페이지로 넘어가 읽는다. 풀이는 이 위키와 원본이 말한 범위만 쓰므로, 원본이 따로 정의하지 않은 일반 용어(JSON, git 같은 것)는 이 위키에서 어떤 자리에 나오는지만 적었다.
워크플로와 에이전트
Anthropic은 AI로 일을 처리하는 시스템을 둘로 나눈다: 미리 정한 순서대로 AI와 도구가 도는 워크플로, 그리고 AI가 스스로 과정과 도구 사용을 정하는 에이전트다(2024년 글). 워크플로는 잘 정해진 일에서 예측 가능하고 일관되며, 에이전트는 유연성과 모델의 판단이 규모 있게 필요할 때 낫다.
자동 메모리(Auto memory)
자동 메모리는 내가 따로 적지 않아도 Claude Code가 일하면서 내 교정과 선호를 스스로 노트로 남겨, 다음 세션에서 이어 쓰게 하는 장치다. 노트는 내 컴퓨터의 프로젝트별 폴더에 저장되고 다른 기계와 공유되지 않으며, 색인 파일 MEMORY.md의 앞부분(200줄 또는 25KB 중 먼저 닿는 쪽)만 세션 시작 때…
작업 공간 신뢰
처음 여는 폴더(저장소)에 들어 있는 설정 가운데 Claude에게 권한을 넓혀 주는 것은, 내가 그 폴더를 믿는다고 확인한 뒤에만 적용하는 단계다. 남이 만든 폴더를 받아 열었다는 것만으로 그 폴더가 스스로 권한을 갖지 못하게 하는 장치로 볼 수 있다(편집자 해석).
출력 스타일
출력 스타일은 세션의 모든 응답에 Claude의 역할·말투·답의 형식을 걸어 두는 지시 묶음이다(예: 결과부터 짧게 답하는 Concise, 작성한 코드의 이유를 덧붙이는 Explanatory). 매번 '더 짧게', '더 설명해서'라고 요청하고 있다면 쓸 때다.
컨텍스트 비용
Claude가 한 번에 볼 수 있는 정보의 양(컨텍스트 창)은 정해져 있는데, CLAUDE.md·스킬·MCP 같은 확장 기능도 이 공간을 언제, 얼마나 차지하는지가 서로 다르다는 이야기다. 원본은 너무 많이 붙이면 공간이 차고, 잡음이 늘어 스킬이 제대로 불리지 않거나 Claude가 관례를 놓칠 수 있다고 말한다.
컨텍스트 엔지니어링
컨텍스트 엔지니어링은 AI가 답을 만들 때 보는 정보 전체(지시, 도구, 바깥 자료, 지금까지의 대화)를 무엇으로 채울지 고르고 관리하는 일이다. 정보가 많아질수록 AI가 그 안의 내용을 정확히 떠올리는 능력이 떨어지므로, 원하는 결과를 낼 가능성이 가장 높은 가장 작은 핵심 정보를 찾는 것이 원칙이다…
프롬프트 캐싱
Claude Code는 메시지를 보낼 때마다 지금까지의 대화 전체를 다시 보낸다. 프롬프트 캐싱은 앞부분이 직전과 똑같으면 그 부분을 다시 처리하지 않고 싸게 재사용하는 장치다.
플러그인
플러그인은 스킬, 바깥 서비스 연결, 자동 실행 동작, 보조 에이전트 같은 확장 기능을 한 묶음으로 포장해 설치하고 나눠 주는 단위다. 잘 돌아가는 셋업을 팀원이나 여러 프로젝트에 똑같이 나눌 때 쓴다.
훅
훅은 Claude Code가 정해진 순간(도구를 쓰기 직전·직후, 세션 시작 등)에 이르면 Claude의 판단과 상관없이 자동으로 실행되는 동작이다. CLAUDE.md에 적은 '하지 마라'는 요청일 뿐이라, 매번 반드시 지켜져야 하는 규칙은 훅으로 만들라고 원본은 말한다.
훅 이벤트 레퍼런스
훅이 걸릴 수 있는 순간(세션 시작, 도구를 쓰기 직전·직후, 응답 종료 등)을 이벤트 하나씩 찾아보는 페이지로, 각 이벤트가 언제 돌고 무엇을 받고 무엇을 막을 수 있는지를 적었다.
훅 입출력 규칙
훅이 Claude Code에게서 무엇을 받고, 무엇을 돌려주면 어떻게 되는지를 이벤트와 상관없이 공통 규칙으로 모은 페이지다. 핵심은 훅이 끝날 때 돌려주는 숫자(종료 코드)로, 0은 성공, 2는 (막을 수 있는 이벤트에서) 막기이고, 그 밖의 숫자(관례상 실패를 뜻하는 1 포함)는 올바른 JSON 결정을 함께 내지…
Claude Code 권한 규칙 문법
권한 규칙은 'Claude가 이 도구를 이렇게 쓸 때는 묻지 않는다(allow)·매번 묻는다(ask)·막는다(deny)'를 설정 파일에 적는 짧은 문장이다. 막기(deny)가 먼저 검사되고 처음 맞는 규칙이 결과를 정하므로, 허용 규칙으로 막기 규칙에 예외를 낼 수 없다.
Claude Code 내장 도구
Claude Code는 "파일 읽기(Read)", "파일 고치기(Edit)", "명령 실행(Bash)", "웹 페이지 가져오기(WebFetch)" 같은 이름 붙은 도구로 일한다.
Claude Code 설정 키 레퍼런스
Claude Code 설정 파일에 넣는 키(설정 항목) 가운데 권한·샌드박스·훅·플러그인·모델·조직 관리에 쓰는 것을 주제별 표로 모은 찾아보기 페이지다. 키마다 어느 파일에 두면 먹는지(Scope)가 달라서, 팀 저장소 파일에 두면 무시되거나 조직이 배포한 managed 설정에서만 통하는 키가 있다.
Claude Code 설정 파일
설정은 Claude Code가 어떤 모델로 시작할지, 무엇을 묻지 않고 실행할지 같은 동작을 정하는 값이고, 어느 파일에 두느냐에 따라 나에게만, 한 프로젝트에만, 팀 전체에, 또는 조직 전체에 적용된다.
Claude Code 슬래시 명령
슬래시 명령은 Claude Code 입력창에 /로 시작해 치는 짧은 명령이다. 대부분은 Claude Code 자체를 조작하고(모델 바꾸기, 권한 규칙 보기, 대화 비우기), 일부는 정해 둔 작업 지시를 Claude에게 넘긴다(바뀐 내용 리뷰 같은 번들 스킬).
Claude Code CLI 플래그
CLI 플래그는 터미널에서 claude를 시작할 때 뒤에 붙여 그 실행의 동작을 바꾸는 옵션이다(예: -p로 대화 화면 없이 한 번 실행하고 끝내기, --permission-mode로 시작 권한 모드 정하기).
LLM Wiki
LLM Wiki는 LLM 에이전트가 내가 고른 자료를 읽고 정리해, 서로 링크된 마크다운 페이지 묶음(위키)을 조금씩 쌓고 계속 고쳐 가는 개인 지식 베이스 방식이다.
managed settings
managed settings는 회사 관리자가 모든 직원 기기에 배포하는 Claude Code 설정으로, 개인 설정 파일·프로젝트 파일·한 세션용 --settings 값으로 덮어쓸 수 없다. 그래서 조직 전체에 거는 금지 규칙이나 모드 잠금을 두는 자리로 쓴다.
MCP
MCP는 Claude를 Slack·Google Drive·데이터베이스 같은 바깥 서비스와 도구에 연결하는 공통 연결 규약이다. 연결해 두면 Claude가 작업 중에 그 서비스의 데이터를 가져오거나 동작(예: Slack에 글 올리기)을 할 수 있고, Cowork에서 앱을 연결하는 커넥터도 이 방식이다.