본문으로 건너뛰기

AI 지식 관리 시스템 활용법: AKM 설치부터 노트 생성까지

haafoom

2026.07.26

AI 지식 관리 시스템 목표

  • 1주차 강의("[1주차] LLM Wiki 응용 지식관리시스템으로 내 분야의 일을 더 잘하는 AI 에이전트 만들기", 통칭 "AI 지식 관리 스터디")에서 다룬 AKM을 내 에이전트(클로드 코드)에 설치

  • AKM의 최소 개념인 소스(Source) vs 놀리지(Knowledge) 구분만 우선 익히고, 실제로 노트 1개를 만들어 어느 폴더에 들어가는지 확인

활용한 도구

  • 클로드 코드 (AKM 설치 및 노트 생성 보조)

  • AKM (스터디장 "덱"이 만든 지식관리 시스템, 깃허브 저장소 기반)

진행 과정

1️⃣ AKM 설치

  • 시도한 방법: AKM 저장소 주소를 클로드 코드에게 채팅으로 주고 "이 주소로 설치해줘"라고 요청

2️⃣ 노트 1개 만들기

  • 시도한 방법: 원본 자료를 클로드 코드에게 주며 "AKM 규칙에 맞춰 소스 폴더에 정리해줘" 요청

  • 사전 프라이버시 체크(개인정보/계약/비밀번호·API키 포함 여부)

성과와 배운 점

  • PKM(사람이 보기 좋게 정리)과 AKM(에이전트가 읽고 실행·검증)의 차이를 실습을 통해 체감

5

함께 이야기해요 5

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.07.26

AKM 설치하면서 원본 자료를 넘기기 전 프라이버시 체크를 먼저 했다는 부분, 작은 습관 같지만 실제로 업무에 적용할 때 중요한 부분이라 챙겨두신 게 눈에 띄었어요.

PKM(사람이 보기 좋게 정리)과 AKM(에이전트가 읽고 실행·검증)의 차이를 설치 실습 하나로 직접 체감했다는 점도요. 개념으로만 들었을 때와 실제로 소스 폴더에 정리해봤을 때 느낌이 많이 다르죠.

고롱고롱 ✨ 다음 사례글도 기대할게요.

DECK 프로필 이미지
DECK2026.07.27

haafoom님, 처음부터 전체 구조를 외우려 하지 않고 Source와 Knowledge 두 개만 골라 실제 노트를 만든 접근이 좋았습니다. 특히 자료를 넣기 전에 개인정보·계약 내용·비밀정보를 확인한 습관은 실제 업무용 AKM에서 반드시 필요한 안전 절차입니다.

한 가지 개념을 보충하면, AKM이 Claude Code의 내부 기억에 설치되는 것은 아닙니다. 로컬에 AKM 저장소를 두고, Claude Code라는 실행 하네스가 INDEX·ROUTER·SCHEMA를 읽어 그 규칙대로 작업하는 구조입니다. 따라서 설치 확인도 폴더가 생겼는지만 볼 것이 아니라, 새 세션의 Claude Code가 AKM의 시작 문서와 분류 규칙을 찾아 읽고 lint까지 실행할 수 있는지 확인하는 편이 정확합니다.

이번에는 Source 노트를 만들었으니, 다음 실습에서는 같은 원본에서 Knowledge 노트 하나를 파생해 보면 경계가 더 명확해질 것 같습니다.

  • Source: 원문·출처·수집일을 해석 없이 보존

  • Knowledge: 원문에서 추출한 재사용 가능한 주장이나 개념

  • 처음 만든 Knowledge: unverified로 시작하고 Source를 근거로 연결

  • Verify: Knowledge의 주장이 실제 원문 구간에서 확인되는지 직접 대조

PKM과 AKM도 “사람용 대 에이전트용”으로 완전히 나뉘는 것은 아닙니다. AKM의 Markdown은 사람도 읽을 수 있지만, 여기에 분류 규칙·신뢰 상태·실행 절차·검증·Learn Back 계약을 더해 에이전트도 일관되게 운영할 수 있게 만든 구조에 가깝습니다.

개인·업무 자료는 로컬 비공개 AKM에서 관리하고 공개 저장소에는 올리지 않는 것이 제 운영 방식입니다. 비밀번호·API 키·토큰 같은 비밀값은 공개 여부와 관계없이 로컬 AKM에도 저장하지 않습니다. 다음에는 민감하지 않은 자료 하나로 Source → Knowledge → 직접 대조 검증까지 연결해 보면 AKM의 최소 루프가 완성될 것입니다.

h
haafoom2026.07.27

휴먼인더루프 말고 직접 읽고 답변해주셔서 감사합니다. 열심히 해보겠습니다

유피테르 프로필 이미지
유피테르2026.07.28

저장소 주소를 채팅으로 주고 설치를 요청한 뒤, 원본 자료도 AKM 규칙에 맞춰 소스 폴더에 정리하도록 이어간 방식이 무척 실용적이었습니다. 복잡한 개념 설명보다 클로드 코드에 건넨 실제 요청과 저장 위치 확인 과정을 순서대로 남겨, 처음 AKM을 접하는 사람도 첫 실습 경로를 바로 그려볼 수 있게 해주신 점이 좋네요.

꾸
꾸기작2026.08.07

전체 구조를 한 번에 다 외우려 하지 않고, Source와 Knowledge라는 최소 개념만 먼저 익힌 뒤 실제 노트 1개를 만들어 어느 폴더에 들어가는지 직접 확인하신 접근이 좋습니다. 저장소 주소를 클로드 코드에게 채팅으로 주고 설치를 요청하신 방식도 실습 진입 장벽을 낮춘 방법입니다.

원본 자료를 넘기기 전에 개인정보·계약·비밀번호·API키 포함 여부를 사전에 체크하신 습관이 특히 눈에 띕니다. 작은 절차처럼 보이지만 실제 업무 자료를 다룰 때는 반드시 필요한 안전장치입니다.

PKM(사람이 보기 좋게 정리)과 AKM(에이전트가 읽고 실행·검증)의 차이를 개념으로만 듣지 않고 실습 하나로 체감하셨다는 결론이 이번 사례의 핵심 같습니다. 다음 실습에서 Knowledge 노트까지 만들어보시면 Source와의 경계가 더 명확해질 것 같습니다. 응원합니다!

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기