1. 문제 인식 — "좋은 아티클이 계속 사라진다"
AI 엔지니어로 일하다 보면 하루에도 수십 개의 기술 아티클을 접한다.
출퇴근 지하철에서 X(트위터) 피드를 보다가 흥미로운 OpenAI 블로그 링크를 발견
점심시간에 레딧에서 새로운 LLMOps 패턴 글을 봄
저녁에 유튜브 알고리즘이 AI 에이전트 아키텍처 영상을 추천
문제: 아이폰으로 보는 순간에는 "나중에 제대로 읽어야지"라고 생각하지만, 링크를 저장해도 어디에 저장했는지 모르고, 저장하더라도 맥락 없이 URL만 쌓인다.
기존 시도와 한계
방법
문제점
Safari 즐겨찾기
분류 없이 쌓여서 결국 안 봄
메모 앱에 URL 복사
맥락이 없어서 나중에 무슨 글인지 모름
노션 Web Clipper
노션과 Obsidian 두 곳으로 분산, 지식 연결 안 됨
나중에 맥북에서 다시 찾기
기억이 안 나거나 다시 찾는 시간 낭비
핵심 니즈: 아이폰에서 URL만 공유하면 → 맥북의 Obsidian vault에 자동으로 핵심 요약 + 기술 추출 + CMDS 포맷 노트가 생성되어야 한다.
2. 해결 아키텍처 — 3가지 핵심 구성 요소
[아이폰에서 URL 발견]
↓
[Claude 앱에서 Remote Control 세션 접속]
↓
[/clip [URL] 입력]
↓
[맥북의 Claude Code가 로컬에서 작업]
1. WebFetch로 URL 내용 수집
2. 403 실패 시 WebSearch로 폴백
3. 핵심 기술 / 요약 / 인사이트 추출
4. CMDS 포맷 MD 파일 생성
↓
[Obsidian vault 00. Inbox/02. Clippings/ 에 저장]
↓
[Obsidian Sync로 아이폰에도 즉시 동기화]
3. 구현 Step 1 — /clip 커스텀 스킬 만들기
Claude Code 커스텀 슬래시 커맨드란?
Claude Code는 .claude/commands/ 폴더에 .md 파일을 만들면, 해당 파일명이 슬래시 커맨드로 등록된다.
vault/
└── .claude/
└── commands/
└── clip.md ← 이 파일이 /clip 커맨드가 됨
clip.md 구성
웹 URL에서 핵심 기술을 추출하고 CMDS 포맷의 클리핑 노트를 생성해서 볼트에 저장한다.
## 입력
URL: $ARGUMENTS
## 실행 절차
### 1단계: 콘텐츠 수집
WebFetch로 URL 내용을 가져온다.
실패(403, 접근 불가 등)하면 WebSearch로 핵심 내용을 보완한다.
### 2단계: 기술 분석
- 핵심 요약: 3~5문장
- 핵심 기술/개념: 기술 스택, 방법론, 아키텍처 목록 (각 1~2줄 설명)
- 주요 인사이트: 실무 적용 가능한 아이디어 3개 이상
### 3단계: 저장
파일명: 📎 YYYY-MM-DD-[영문-슬러그].md
저장 위치: 00. Inbox/02. Clippings/
CMDS frontmatter: type: note, CMDS: "[[📚 701 Content Clips]]"
사용법
/clip https://openai.com/index/harness-engineering/
Claude Code가 자동으로 전체 프로세스를 실행하고 vault에 저장한다.
4. 구현 Step 2 — Remote Control 설정
Remote Control이란?
Claude Code의 Remote Control은 맥북에서 실행 중인 Claude Code 세션을 아이폰, 태블릿, 다른 브라우저에서 원격으로 조작할 수 있는 기능이다. 세션은 항상 맥북 로컬에서 실행되며, 아이폰은 창(window) 역할만 한다. 로컬 파일 시스템, MCP 서버, 프로젝트 설정이 모두 그대로 유지된다.
Remote Control vs Remote Trigger 차이
Remote Control: 사용자가 아이폰에서 직접 대화하며 맥북 Claude Code 조작 (인터랙티브)
Remote Trigger: API 호출로 Claude Code를 자동 실행 (자동화, 현재 별도 설정 필요)
아이폰 → 맥북 vault 저장 워크플로우의 핵심은 Remote Control이다.
설정 방법
Step 1: 맥북에서 Remote Control 서버 시작
# vault 디렉토리로 이동 후
claude remote-control --name "PKM Vault"
터미널에 세션 URL과 QR 코드가 표시된다.
Step 2: 아이폰 Claude 앱에서 연결
방법 A: 터미널의 QR 코드를 아이폰 카메라로 스캔
방법 B: Claude 앱 실행 → 세션 목록에서 "PKM Vault" 선택
방법 C: 세션 URL을 아이폰 브라우저에서 열기
Step 3: 모든 세션에서 자동 활성화 (선택)
Claude Code에서 /config 실행
→ "모든 세션에 대해 Remote Control 활성화" → true
이후 claude 실행 시마다 자동으로 원격 접속 가능 상태가 된다.
Remote Control 활용 시나리오
시나리오
방법
즉시 클리핑
아이폰 Claude 앱 → /clip [URL] 입력
진행 중 작업 이어받기
맥북에서 시작한 세션을 아이폰에서 계속
이동 중 확인
맥북에서 실행 중인 긴 작업 진행 상황 모니터링
요구사항
Claude Pro / Max 이상 구독 (API 키 불가, claude.ai OAuth 필수)
Claude Code v2.1.51 이상 (
claude --version확인)맥북 터미널이 열려 있는 상태 유지
5. 실제 데모 — OpenAI Harness Engineering 아티클 클리핑
테스트 URL
https://openai.com/ko-KR/index/harness-engineering/
실행 과정
① WebFetch 시도 → 403 차단
OpenAI 페이지는 봇 접근을 차단한다. Claude Code가 자동으로 WebSearch 폴백을 실행.
② WebSearch + 외부 리포팅 사이트 크롤링
InfoQ, VibeParking 등 해당 아티클을 분석한 사이트에서 핵심 내용을 수집.
③ 생성된 노트 결과
---
type: note
aliases:
- "Harness Engineering"
- "하네스 엔지니어링"
author:
- "[[송세현]]"
date created: 2026-03-29
tags:
- web-clip
- AI-agent
- LLMOps
- codex
CMDS: "[[📚 701 Content Clips]]"
source: "https://openai.com/ko-KR/index/harness-engineering/"
status: unread
---
# Harness Engineering — AI 에이전트 시대의 소프트웨어 개발 패러다임
## 핵심 요약
OpenAI는 Codex 에이전트를 활용해 5개월 만에 수동 작성 코드 0줄로
100만 줄 규모의 프로덕션 시스템을 구축했다...
## 핵심 기술 / 개념
- **Harness Engineering**: 에이전트 환경 설계 방법론
- **Codex Agent**: PR/테스트/CI 자동화 코딩 에이전트
- **Context Engineering**: 에이전트에 올바른 컨텍스트 제공 기술
- **Layered Architecture**: Types→Config→Repo→Service→Runtime→UI
## 주요 인사이트
1. 엔지니어 역할의 전환: 코드 작성 → 에이전트 환경 설계
2. 아키텍처 제약이 에이전트 품질을 결정
3. 소규모 팀(3→7명)이 엔지니어 1인당 하루 평균 3.5 PR 처리
소요 시간: 약 30초 (수동 요약 대비 95% 시간 절약)
6. 전체 워크플로우 요약
💻 맥북에서 사전 준비 (1회만)
claude remote-control --name "PKM Vault"
→ 터미널에 QR 코드 + 세션 URL 표시
↓
📱 아이폰 Claude 앱에서 QR 코드 스캔 → 세션 연결
↓
아이폰으로 흥미로운 기술 아티클 발견
↓
Claude 앱에서 /clip [URL] 입력
↓
💻 맥북 Claude Code가 로컬에서 실행
- WebFetch / WebSearch로 콘텐츠 수집
- 핵심 기술 + 요약 + 인사이트 추출
- CMDS 포맷 MD 파일 생성
↓
📂 vault/00. Inbox/02. Clippings/ 에 저장
↓
☁️ Obsidian Sync로 아이폰에 즉시 동기화
↓
📱 아이폰 Obsidian에서 요약본 확인 가능
7. 업무 생산성 관점에서의 의미
Before vs After
항목
이전 방식
이 워크플로우
아티클 저장
URL만 북마크
핵심 기술 + 요약 + 인사이트 자동 생성
분류
수동 또는 미분류
CMDS 카테고리 자동 태깅
활용
나중에 다시 찾아봐야 함
즉시 검색 가능한 구조화된 노트
소요 시간
URL 저장 10초 + 나중에 읽기 20분
트리거 실행 5초 + 요약 확인 2분
지식 연결
없음
관련 CMDS 노트로 wikilink 연결
핵심 인사이트
1. 정보 수집과 지식화 사이의 마찰을 없앤다
기존에는 "나중에 읽어야지"가 곧 "안 읽는다"와 동의어였다. 이 워크플로우는 아티클을 발견하는 순간 자동으로 핵심이 추출되어 vault에 쌓인다. 읽는 행위와 지식화 행위가 동시에 일어난다.
2. Claude Code 커스텀 스킬은 나만의 AI 에이전트 도구다
.claude/commands/ 에 md 파일 하나를 추가하는 것만으로 복잡한 멀티스텝 워크플로우를 슬래시 커맨드 하나로 실행할 수 있다. n8n 워크플로우를 짜는 것과 유사하지만, Claude Code는 추론과 맥락 이해가 가능하다는 점이 다르다.
3. Remote Control = AI 에이전트의 진입점 분리
"어디서 조작할 것인가"와 "무엇을 실행할 것인가"를 분리한다. 맥북 터미널, 아이폰 Claude 앱, 브라우저 등 다양한 진입점에서 동일한 Claude Code 세션과 /clip 스킬을 실행할 수 있다. 이는 AI 에이전트 설계의 핵심 패턴인 입력 채널 분리와 동일한 개념이다.
8. 확장 가능성
이 패턴을 응용하면 다음 워크플로우도 구현 가능하다.
/summarize [유튜브 URL]— 유튜브 자막 추출 후 요약 노트 생성/idea [아이디어 텍스트]— 아이디어를 CMDS 비즈니스 아이디어 포맷으로 저장/stock [종목명]— 주식 정보 검색 후 투자 분석 노트 생성Channels 기능으로 Telegram 봇 연동 → 채널에 URL 공유하면 자동 클리핑 (완전 자동화)
