이 글은 Claude Code, Codex, Obsidian을 함께 사용해서 자료를 수집하고, 정리하고, 검토하고, 다시 활용하는
LLM Wiki 기반 AI 세컨드 브레인구축 방법을 정리한 글이다. 다음에 다시 봐도 그대로 따라 할 수 있도록 설치, 폴더 구조, 프롬프트, 운영 루틴까지 한 번에 정리했다.
- 전체 개념: Claude, Codex, Obsidian의 역할
- Claude Code와 Codex 설치하기
- Obsidian LLM Wiki 폴더 구조 만들기
- CLAUDE.md와 AGENTS.md 세팅하기
- 자료 ingest 실전 워크플로우
- Codex로 리뷰하고 자동화하기
- 자주 쓰는 프롬프트 모음
- 운영 원칙과 주간 점검 루틴
1. 핵심 개념: LLM Wiki란?
일반적으로 AI에게 자료를 업로드하고 질문하면, AI는 매번 원본 자료에서 필요한 내용을 다시 찾아 답변한다. 하지만 LLM Wiki 방식은 다르다. 원본 자료를 그냥 검색용으로만 두는 것이 아니라, AI가 내용을 읽고 정리해서
지속적으로 업데이트되는 Markdown Wiki를 만든다.
이 방식의 장점은 지식이 채팅창에 흩어지지 않는다는 점이다. 한 번 정리된 내용은 wiki/ 폴더에 남고, 나중에 Claude나 Codex가 다시 읽어서 더 좋은 결과물로 발전시킬 수 있다.
2. 도구별 역할 정리
메인 작업자다. 자료를 읽고, 요약하고, Wiki 문서를 만들고, Obsidian 링크를 연결하는 역할을 맡긴다.
보조 작업자이자 리뷰어다. Claude가 만든 결과물을 검토하고, 누락·모순·링크 오류·자동화 스크립트를 맡긴다.
결과물을 보는 지식관리 화면이다. Markdown 파일, 내부 링크, 그래프 뷰, 백링크 확인에 좋다.
버전 관리와 복구용이다. AI가 파일을 잘못 수정했을 때 이전 상태로 되돌릴 수 있게 해준다.
| 도구 | 추천 역할 | 언제 쓰면 좋은가? |
|---|---|---|
| Claude Code | 작성, 정리, 연결 | 자료를 읽고 Wiki 문서로 바꿀 때 |
| Codex | 리뷰, 비판, 자동화 | Claude 결과물을 검증하거나 스크립트를 만들 때 |
| Obsidian | 탐색, 시각화, 읽기 | 정리된 지식을 다시 보고 연결 관계를 확인할 때 |
| Git | 백업, 히스토리, 복구 | AI가 수정한 내용을 안전하게 관리할 때 |
3. Claude Code 설치
Claude Code는 터미널에서 사용하는 Anthropic의 코딩 에이전트다. 프로젝트 폴더 안에서 실행하면 파일을 읽고, 수정하고, 명령어를 실행할 수 있다.
macOS, Linux, WSL
Windows PowerShell
Homebrew
npm 방식
설치 확인
프로젝트 폴더로 이동한 뒤 아래 명령어로 Claude Code를 실행한다.
Claude Code를 사용하려면 Claude Pro, Max, Team, Enterprise 또는 Console/API 계정이 필요하다.
4. Codex CLI 설치
Codex CLI는 OpenAI의 터미널 기반 코딩 에이전트다. Claude와 함께 쓰면 특히
코드 리뷰, 구조 검토, 자동화 스크립트 작성에 유용하다.
설치 후 실행한다.
처음 실행하면 ChatGPT 계정 또는 API Key로 로그인하라는 안내가 나온다.
Codex 업데이트
5. Claude Code 안에서 Codex 쓰기
Claude Code 안에서 Codex를 바로 호출하려면 Codex Plugin for Claude Code를 설치하면 된다. 이렇게 하면 Claude 작업 도중에 /codex:review, /codex:adversarial-review, /codex:rescue 같은 명령을 사용할 수 있다.
Codex 로그인이 필요하면 Claude Code 안에서 아래처럼 실행할 수 있다.
6. Obsidian LLM Wiki 폴더 구조 만들기
Obsidian Vault 하나를 만들고, 그 폴더를 Claude Code와 Codex가 함께 작업하는 프로젝트 루트로 사용한다.
최종 폴더 구조
raw/는 원본 보관소이고, wiki/는 AI가 정리한 결과물이다. 원본은 수정하지 않고, 정리본만 계속 발전시키는 구조로 운영한다.
7. 폴더별 역할
raw/
원본 자료를 넣는 곳이다. 웹 아티클, PDF, 유튜브 자막, 회의록, 강의 노트, 이미지, CSV 등을 넣는다. 이 폴더는
증거 자료이므로 Claude와 Codex가 함부로 수정하지 않게 해야 한다.
wiki/
AI가 정리한 문서가 들어가는 곳이다. Obsidian에서 실제로 읽고 탐색하는 핵심 폴더다.
wiki/index.md
전체 Wiki의 목차다. Claude가 자료를 정리할 때마다 새로 만든 문서와 핵심 설명을 여기에 추가하게 한다.
wiki/log.md
작업 기록이다. 어떤 자료를 언제 정리했고, 어떤 문서를 만들었고, 어떤 질문을 저장했는지 남긴다.
8. CLAUDE.md 세팅
CLAUDE.md 는 Claude Code에게 주는 프로젝트 운영 규칙이다. 이 파일을 프로젝트 루트에 만들어두면 Claude가 매번 이 프로젝트의 작업 방식, 폴더 규칙, Wiki 운영 원칙을 참고할 수 있다.
1. 프로젝트 루트에 CLAUDE.md 파일을 만든다.
2. 아래 내용을 그대로 복사해서 붙여넣는다.
3. Claude Code를 실행한 뒤, 이 파일을 기준으로 작업하라고 요청한다.
Claude Code를 실행한 뒤에는 “CLAUDE.md를 읽고 이 프로젝트 운영 규칙을 이해해줘. 아직 수정하지 말고 현재 구조를 점검해줘.”라고 요청하면 좋다.
9. AGENTS.md 세팅
AGENTS.md 는 Codex에게 주는 규칙이다. Claude가 메인 작성자라면, Codex는 리뷰어·검증자·자동화 담당자로 쓰는 것이 안정적이다.
1. 프로젝트 루트에 AGENTS.md 파일을 만든다.
2. 아래 내용을 그대로 복사해서 붙여넣는다.
3. Codex에게 리뷰, 검증, 자동화 작업을 맡길 때 이 규칙을 기준으로 작업하게 한다.
“AGENTS.md 기준으로 현재 Claude 변경사항을 리뷰해줘. 특히 근거 없는 주장, 링크 누락, index/log 누락, 중복 concept를 찾아줘.”라고 요청하면 좋다.
10. 실제 사용 흐름
- 자료 수집
웹 아티클, PDF, 유튜브 자막, 회의록 등을 raw/ 폴더에 넣는다. - Claude로 ingest
Claude에게 원본 자료를 읽고 wiki/에 정리하라고 요청한다. - Git diff 확인
어떤 파일이 바뀌었는지 확인한다. - Codex 리뷰
Claude가 만든 결과물에 누락, 모순, 링크 오류가 없는지 검토한다. - Claude로 수정 반영
Codex 리뷰 결과를 Claude에게 반영하게 한다. - Git commit
검토가 끝난 결과를 커밋한다.
11. 자료 ingest용 프롬프트
아래 프롬프트는 자료 하나를 Wiki로 정리할 때 그대로 사용하면 된다.
처음부터 raw/ 폴더 전체를 한 번에 정리시키지 않는 것이 좋다. 초반에는 자료 하나씩 ingest 하면서 구조를 잡는 편이 훨씬 안정적이다.
12. Codex 리뷰 명령어
Claude가 작업한 뒤에는 Codex에게 검토를 맡긴다.
일반 리뷰
main 브랜치 기준 리뷰
비판적 리뷰
Codex에게 작업 맡기기
Codex 작업 상태 확인
13. 질문하고 답변 저장하는 방법
LLM Wiki 방식에서는 질문도 중요한 자산이다. 좋은 답변이 나오면 채팅창에만 두지 말고 wiki/questions/에 저장해야 한다.
답변이 마음에 들면 아래처럼 저장시킨다.
14. 주간 점검 루틴
Wiki가 커지면 문서가 중복되거나, 링크가 깨지거나, 오래된 내용이 남을 수 있다. 그래서 일주일에 한 번 정도 Claude와 Codex에게 점검을 맡기면 좋다.
Claude에게 Wiki 점검 요청
Codex에게 확장성 리뷰 요청
15. Git으로 안전하게 관리하기
AI에게 파일 수정을 맡길 때는 Git을 꼭 쓰는 것이 좋다. 마음에 들지 않는 수정이 생기면 되돌릴 수 있기 때문이다.
Claude에게 커밋을 맡길 수도 있다.
16. Obsidian 추천 세팅
| 기능 또는 플러그인 | 용도 |
|---|---|
| Graph View | 노트 간 연결 관계를 시각적으로 확인한다. |
| Backlinks | 어떤 문서가 현재 문서를 참조하는지 확인한다. |
| Templates | 반복되는 문서 양식을 빠르게 만든다. |
| Dataview | YAML frontmatter 기반으로 문서 목록과 표를 자동 생성한다. |
| Obsidian Web Clipper | 웹 아티클을 Markdown으로 저장한다. |
| Omnisearch | Vault 내부 검색을 강화한다. |
17. 운영 원칙 요약
raw/는 증거 자료이고, wiki/는 AI가 정리한 해석본이다.
가장 안정적인 흐름은 Claude 작성 → Git diff 확인 → Codex 리뷰 → Claude 수정 → Git commit이다.
채팅창에서 끝내면 지식이 사라진다. 재사용 가치가 있는 답변은 wiki/questions/에 저장한다.
index.md는 지식 지도이고, log.md는 작업 히스토리다.
18. 처음 시작할 때 추천 순서
- Claude Code를 설치한다.
- Codex CLI를 설치한다.
- Claude Code에 Codex Plugin을 설치한다.
- Obsidian Vault를 만든다.
- LLM Wiki 폴더 구조를 만든다.
- CLAUDE.md와 AGENTS.md를 작성한다.
- Git을 초기화한다.
- 자료 하나만 raw/에 넣고 Claude에게 ingest를 맡긴다.
- Codex로 리뷰한다.
- Obsidian에서 결과를 확인하고 Git commit 한다.
19. 첫 실행용 프롬프트
프로젝트를 처음 만든 뒤 Claude Code에서 아래 프롬프트를 그대로 입력하면 된다.
리포트를 확인한 뒤에는 이렇게 요청한다.
20. 최종 요약
이 구조를 만들면 Claude와 Codex를 단순 코딩 도구로만 쓰는 것이 아니라, 내 자료와 업무 노하우를 계속 축적하고 재활용하는
AI 지식관리 시스템으로 사용할 수 있다.
핵심은 복잡한 도구를 많이 붙이는 것이 아니라, 자료를 raw에 넣고, Claude가 wiki로 정리하고, Codex가 검토하고, 좋은 결과를 다시 wiki에 저장하는 루틴을 반복하는 것이다.
참고 링크
Claude Code 공식 문서: https://code.claude.com/docs/en/quickstart
Codex CLI 공식 문서: https://developers.openai.com/codex/cli
Codex Plugin for Claude Code: https://github.com/openai/codex-plugin-cc
Karpathy LLM Wiki 아이디어: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
'AI > Claude' 카테고리의 다른 글
| Claude Code 신규 서버용 프롬프트 개선: 프로젝트 타입별 모듈 자동 선택과 C++/서버 프로젝트 최적화 가이드 (0) | 2026.05.01 |
|---|---|
| Claude Desktop + Figma Desktop양방향 디자인 워크플로우 (0) | 2026.04.25 |
| Claude Code 3대 프레임워크 완벽 가이드 — Superpowers vs GSD vs gstack, 설치부터 실전 워크플로우까지 (1) | 2026.04.24 |
| GStack + Superpowers 조합 세팅 가이드 (0) | 2026.04.16 |
| Claude Desktop 신규 업데이트 정리 (0) | 2026.04.16 |