OpenClaw의 기억과 Claude Code 실행을 결합하여 개발을 자율화하는 실천 기록
요약
본 기사는 AI 개발 시대에 인간의 품질 제어와 통제권을 확보하는 아키텍처를 제시합니다. '사고/기억/지시' 레이어(OpenClaw)와 '개발/실행' 레이어(Claude Code)를 분리하여, 영구적인 규칙과 과거 경험을 코드베이스에 축적하고 이를 실행 도구가 참조하도록 설계하는 것이 핵심입니다.
핵심 포인트
- 사고/기억 레이어와 개발/실행 레이어를 명확히 분리해야 합니다.
- 영구 규칙은 채팅 컨텍스트가 아닌 파일(CLAUDE.md)에 기록하여 지속성을 확보합니다.
- 과거의 실패 패턴이나 프로젝트 철칙을 '기억'으로 축적하는 것이 중요합니다.
- 단순한 지시를 넘어, 이유와 맥락을 제공하여 AI의 판단 자료로 활용해야 합니다.
2026년 10월, Zenn의 일일 트렌드를 보면 개발 도구 주변의 화제가 눈에 띕니다. CodeRabbit이나 Claude Code용 Skill로 공개된 일본어 가독성을 구조 레벨에서 개선하는 'yomiyasu', AI 개발 시대에 테스트의 역할을 재정의하는 논의, 15년간 사용해 온 Git에서 Jujutsu로 전환한 경험담 등 모두 'AI가 코드를 작성하게 하는 시대에 인간은 어디서 품질과 제어를 잡을 것인가'라는 같은 질문에 직면하고 있습니다.
필자는 SES(System Engineering Service)에 상주하며 개인 개발 및 자동화 기반 구축을 계속해 온 엔지니어이지만, 이 반년 동안 워크플로우를 크게 바꾼 것은 '사고/기억/지시를 담당하는 레이어 (OpenClaw적인 구성)'와 '개발/실행을 담당하는 레이어 (Claude Code)'를 명확히 분리하는 설계였습니다. 본 기사에서는 실제로 사용하고 있는 명령어와 설정 파일의 구성 예시를 보여주면서, 이 아키텍처가 왜 단가나 연봉에 직결되는 스킬이 될 수 있는지 데이터 분석적인 시점도 곁들여 설명합니다.
| 레이어 | 역할 | 담당 도구 | 영속화 위치 |
|---|---|---|---|
| 사고/기억 | 사용자의 취향, 과거 결정, 프로젝트 문맥 유지 | OpenClaw (기억/지시 오케스트레이션) | memory 디렉토리 · MEMORY.md |
| ... |
핵심은 '기억은 기억 레이어에 두고, 실행은 코드와 함께 검증 가능한 형태로 남기는' 분리입니다. AI 에이전트에게 무언가를 '기억하게 하고 싶다'고 생각할 때, 그것을 채팅의 컨텍스트에 의존하면 다음 세션에서 사라집니다. 그래서 OpenClaw 쪽에 영구적인 지시/프로젝트 배경/과거 실패 패턴을 축적하고, Claude Code 쪽은 그 지시를 읽어 실제로 코드를 다루는 역할 분담을 하고 있습니다.
처음에 손댄 것은 프로젝트 루트에 CLAUDE.md를 두고, Claude Code가 시작 시 반드시 읽게 하는 영구 규칙을 작성하는 것이었습니다.
## 배포 철칙
- 커밋하지 않은 WIP(Work In Progress) 상태로 빌드하지 않기
- push 전에 반드시 차분 검증 수행하기
...
이런 '과거에 저질렀던 사고의 재발 방지 규칙'을 자연문으로 적어두면, Claude Code는 매번 태스크에서 그것을 전제 조건으로 다룹니다. 이는 OpenClaw적인 '기억'을 코드베이스에 스며들게 하는 가장 원시적이고 확실한 방법이며, 채팅 컨텍스트가 끊겨도 사라지지 않습니다.
CLAUDE.md는 '프로젝트 전체의 영구 규칙'용이지만, '이 사용자는 무엇을 선호하는지, 과거에 어떻게 수정되었는지'와 같은 세밀한 정보는 다른 memory 파일 그룹에서 관리합니다.
memory/
feedback_testing_approach.md
feedback_commit_style.md
...
예를 들어 '모크가 아닌 실제 데이터로 테스트한다'는 지적을 한 번 받았다면, 그것을 feedback_testing_approach.md에 다음과 같이 남깁니다.
---
name: feedback-testing-approach
description: 통합 테스트는 실데이터로 진행하는 방침
...
여기서 중요한 것은 AI 개발 시대의 테스트 역할에 대해 논한 Zenn 기사가 지적했던 것과 같은 문제의식, 즉 'AI가 작성한 테스트가 통과하더라도 그것이 정말 품질을 보장하고 있는가'라는 점입니다. 기억 레이어에 '왜 그 규칙이 필요한지'를 적어둠으로써, Claude Code는 단순히 규칙을 지키는 것을 넘어 엣지 케이스에서의 판단 자료로 이유를 참조할 수 있습니다.
일회성 지시로 끝내지 않고 반복적으로 사용하는 작업은 Skill로 분리합니다. 예를 들어 코드 리뷰 절차를 이렇게 정의해 두면, /code-review와 같은 명령어 한 번으로 저부하 리뷰부터 여러 에이전트에 의한 철저한 리뷰까지 전환할 수 있습니다.
# 최근 차분을 표준 리뷰
claude -p "/code-review"
# PR을 고노력으로 다각적으로 검증
...
이 '빈번한 태스크를 Skill로 고정화하여 사고 비용을 제로에 가깝게 만드는' 발상이 바로 OpenClaw적인 레이어가 Claude Code에게 전달하는 '지시의 재활용 자산'입니다. 매번 처음부터 프롬프트를 다시 작성하는 엔지니어와, 자산화된 Skill 그룹을 호출만 하는 엔지니어는 같은 시간 동안 내놓을 수 있는 결과물의 양이 달라집니다.
인간이 깨닫지 못하는 사이에 열화되는 영역—의존 패키지의 업데이트, CI의 적신호, 로그의 이상—을 Claude Code에게 주기적으로 확인시키는 구성도 갖추고 있습니다.
매일 아침 CI 실패 로그를 확인하고, 수정 가능한 것은 수정하기
claude -p "최근 CI 실패를 조사하고, 원인이 명확하면 수정 PR을 생성해"
--allowedTools "Bash,Edit,Read"
이것을 cron으로 돌릴 때는 '운영 환경의 우선순위를 빼앗지 않는 것'이 중요하며, 무거운 처리는 전용 래퍼(wrapper)를 거쳐 우선순위를 낮춰서 실행하는 설계로 하고 있다. 비무인 실행 시 비용 사고나 오작동이 발생하지 않도록, 실행 전 체크와 차분 검증을 반드시 거치는 것은 기억층에 기록된 철칙을 그대로 코드로 구현한 형태다.
오늘의 트렌드에서도 눈에 띄는 것이 'Git에서 Jujutsu로 마이그레이션했다'라는 글이다. Jujutsu의 매력은 브랜치를 신경 쓰지 않고 커밋을 자유롭게 재배열할 수 있다는 점에 있는데, Claude Code에서도 비슷한 경험은 git worktree를 사용한 병렬 개발로 근사하게 구현할 수 있다.
# 여러 에이전트 태스크를 별 워크트리에서 병렬 실행
git worktree add ../repo-feature-a feature-a
git worktree add ../repo-feature-b feature-b
여러 Claude Code 에이전트가 같은 리포지토리의 다른 브랜치를 동시에 건드려도, worktree로 물리적으로 분리해 놓으면 충돌하지 않는다. 이는 '사고/기억' 측에서 '이 태스크는 병렬 실행해도 좋다'라는 판단을 하고, '실행' 측이 worktree라는 구체적인 격리 메커니즘으로 응답하는 역할 분담의 한 예시다.
여기서는 조금 비즈니스 이야기를 하겠다(전체 기사 비중으로는 작지만, SES로 일하는 엔지니어에게 무시할 수 없는 논점이다).
SES 현장에서는 상주지의 업무 범위 내에서만 스킬이 평가되는 경우가 많다. 반면, 기억 레이어와 실행 레이어를 분리한 AI 구동 개발 기반을 개인적으로 구축하고 운영할 수 있는 엔지니어는 다음 측면에서 시장 가치 데이터 분석상으로도 차별화 요인이 되기 쉽다.
- 재현 가능한 생산성: 스킬화/메모리화된 자산은 프로젝트가 바뀌어도 가지고 다닐 수 있다. 프리랜서 건을 찾는 방법을 생각할 때, '이 사람은 과거의 성과를 재현할 수 있는 시스템을 가지고 있다'는 것은 제안서나 포트폴리오에서 설득력을 갖는다.
- 운영 비용 설명력: cron이나 worktree에서의 자율 운영을 자신의 언어로 설명할 수 있다면, 클라이언트에게 단가 근거(얼마만큼의 작업을 자동화로 대신하고 있는지)를 구체적으로 제시할 수 있다.
- 독립 준비로서의 실험장: SES 업무에서는 다루기 어려운 '에이전트 운영', '비무인 실행의 안전책', '기억 설계' 등을 개인 리포지토리에서 실습해 두는 것이 엔지니어 독립 준비 그 자체가 된다. 독립 후 건 단가를 협상할 때, 이러한 구현 경험은 'AI 시대의 개발 체제를 구축할 수 있는 인재'라는 평가로 이어지기 쉽다.
단, 여기서 말하는 연봉/단가에 미치는 영향은 필자 개인의 운영 체감이며, 업계 전체의 시세를 보장하는 것은 아니다. 프리랜서나 독립을 고려할 때는 IPA(정보처리추진기구)의 'DX 백서'나 프리랜서 협회가 매년 공개하는 실태 조사 등 공적 기관/업계 단체의 조사 데이터를 반드시 확인한 후, 자신의 스킬셋과 시장의 매칭을 판단해 주었으면 한다.
실제로 이 구성을 만들 때, 최소한 지켜야 할 항목들을 정리했다.
- 영구 규칙은 CLAUDE.md로, 사용자 고유의 문맥은 memory 파일에 분리했는가
- memory 파일에는 '무엇'뿐만 아니라 '왜'를 적었는가(Why/How to apply 형식)
- 반복하는 작업은 Skill로 분리하고, 색인(MEMORY.md에 해당하는 것)을 업데이트했는가
- 비무인 실행(cron)에는 우선순위 제어와 차분 검증의 가드를 넣었는가
- 병렬 태스크는 worktree 등으로 물리적으로 격리하여 충돌을 피하고 있는가
- 통합 테스트나 CI는 'AI가 만들어서 통과했다'가 아니라, 실데이터/실환경에서의 검증이 되고 있는가
OpenClaw적인 기억/지시 레이어와 Claude Code의 실행 레이어를 분리하는 발상은, 특별한 제품을 도입하지 않아도, CLAUDE.md・memory 디렉토리・Skill・worktree・cron과 같은 기존 메커니즘 조합으로 오늘부터 재현할 수 있다. 중요한 것은 'AI에게 무엇을 기억하게 하고, 무엇을 매번의 컨텍스트에서 학습시킬지'를 의식적으로 설계하는 것이다.
SES 업무로 인해 매일의 업무에 치여 지내다 보면, 이러한 기반 구축 시간을 확보하기 어려울 수 있습니다. 하지만 프리랜서 프로젝트를 찾는 방법이나 단가 협상을 고려하는 단계가 되었을 때, '자신의 개발 체제를 데이터로 설명할 수 있다'는 것은 구두 실적 어필보다 더 강력한 무기가 됩니다. 우선 자신의 리포지토리에 CLAUDE.md 파일을 하나 두는 것부터 시작해 보시길 바랍니다.
- 【2026년 최신】 AI 코딩 툴 완벽 비교 | Claude Code, Copilot, Cursor, Windsurf, Codeium 선택 방법
- 월 매출 250만 엔, 직원 3명이 AI 경영 OS(CFO/COO/CMO)를 직접 구축한 이야기
- OpenClaw로 9개의 AI 에이전트 경영 OS를 구축한 실천 기록 [2026년 10월]
AI 구동 학원 — AI를 활용하여 스몰 비즈니스(SMB)를 만드는 법을 배웁니다
Claude Code, OpenClaw, AI 경영 OS의 실전 노하우를 매주 공개하고 있습니다.
월 4,980엔으로 과거 기사 전체 무제한 열람이 가능합니다.
SES 해체 신서 프리랜서 DB에서는 고단가 프로젝트가 다수 게재되고 있습니다.
- ✅ 마진율 공개로 투명한 거래
- ✅ AI/클라우드/웹 분야 엄선된 프로젝트
- ✅ 전담 코디네이터가 단가 협상을 지원
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기