AI 도구를 바꿔도 작업 위치는 그대로.
SpecWeave는 계획과 완료된 모든 작업을 git에 기록해서 Claude Code, Codex, 어떤 에이전트든 같은 작업을 이어받을 수 있어요. SpecWithCode("스펙 위드 코드"라고 읽어요)는 그 에이전트들의 네이티브 하네스를 하나로 묶는 인터페이스로, 내 머신과 내 구독에서 실행돼요.
둘 다 무료예요. 앱은 macOS 13 이상의 Apple silicon Mac, Windows 10 및 11, Linux에서 실행돼요: SpecWithCode 다운로드.
npm install -g specweave




스레드 창 · 2026년 10월 27일
병렬 워커 · 2026년 10월 15일
사용 한도 · 2026년 10월 10일함께 쓸 수 있는 도구Claude CodeCodexCursorGemini CLIGitHub Copilot CLIGrokOpenCodeMuse CodeAntigravityPi
git의 하나의 기록, 세 가지 활용 방법
SpecWeave는 계획과 증거를 저장소에 보관해요. SpecWithCode는 그 기록을 바탕으로 내 머신에서 에이전트를 실행해요. Verified Skill은 그 에이전트에게 미리 확인할 수 있는 스킬을 제공해요.
$ specweave pickup Picked up the handoff from claude@cloud (out of tokens): applied 7 uncommitted files. SpecWeave pickup · you are codex@laptop Increment 0001-resumable-checkout "Resumable checkout" (active) · tasks 1/2 done Next: T-02 Restore the draft on return AC-01: Returning within 24 hours restores the cart and shipping choice AC-02: A paid order is never restored
실제 출력 · specweave 3.1.0 SpecWeave CLI
npm의 오픈소스, MIT. 버전 3.1.0, 17 October 2026.
스펙, 작업 원장, 테스트 증거를 저장소에 기록하고
specweave handoff로 다음 도구에 작업을 넘겨요. 터미널에서 Claude Code, Codex, 파일을 읽는 모든 에이전트와 작업한다면 여기서 시작하세요.CLI 작동 방식그다음 프로젝트에서 specweave init을 실행하세요.npm install -g specweave

실제 캡처 · SpecWithCode 1.0.103, 2026년 10월 27일 SpecWithCode
Mac, Windows, Linux용 무료 앱. 버전 1.0.191.
프로젝트마다 코디네이터가 있어서, 이미 결제 중인 에이전트로 내 머신에서 워커 스레드를 시작해요. 각 스레드는 SpecWeave 인크리먼트와 작업 진행 상황을 보여 주고, 보고서는 인크리먼트 옆에 저장돼요. 여러 에이전트를 하나의 창에서 쓰고 싶다면 여기서 시작하세요.
에이전트는 내 Chrome 프로필에서 페이지를 열고, 읽고, 클릭하고, 스크린샷을 찍을 수도 있어요. 닫을 수 있는 탭 그룹 안에서 작동하며, 설정, Chrome에서 Chrome용 SpecWithCode Browser를 페어링하면 돼요.
일러스트 Verified Skill
verified-skill.com에서 무료로 둘러볼 수 있어요.
에이전트 스킬 레지스트리예요. 각 스킬에 소스, 보안 검사 결과, 있는 경우 평가가 표시되어서, 에이전트가 사용하기 전에 무엇을 설치하는지 알 수 있어요.
verified-skill.com에서 스킬 둘러보기모든 스킬 페이지에 표시되는 정보
- 소스
- 스킬이 나온 저장소예요. 설치 전에 직접 읽어 볼 수 있어요.
- 보안 검사
- 설치하기 전에 모든 파일을 검사해 발견한 내용이에요.
- 평가 (있는 경우)
- 실제 작업에서 스킬이 도움이 되었는지 보여 줘요. 아직 모든 스킬에 있는 것은 아니에요.
SpecWithCode · 무료, 얼리 액세스
SpecWithCode는 SpecWithCode로 만들어요
저희는 앱을 앱 안에서 만들어요. 코디네이터가 프로젝트별 브리프를 관리하고, Claude Code, Codex 등의 워커 스레드가 변경을 작성해 풀 리퀘스트를 열며, 작업은 SpecWithCode Connect로 연결된 Mac과 Linux 워커에 걸쳐 실행돼요.
- 367
- 워커 스레드가 열고 병합한 SpecWithCode 풀 리퀘스트, 2026년 10월 15일~29일
- 167
- 그 뒤의 워커 스레드: Claude Code 100개, Codex 65개, 나머지는 Gemini CLI와 Copilot
- 2,473
- 10월 9일 이후 메인테이너의 주 Mac에서 프로젝트 여섯 개에 걸쳐 진행된 스레드
2026년 10월 30일 앱의 스레드 기록을 기준으로 집계했어요.

최근 스레드에서 병합된 것
- #961사용자 목표를 완료된 소스 마일스톤 이후에도 열어 두기Codex 스레드병합됨
- #954컴포저의 세션 팝오버에 스킬 표시Gemini CLI 스레드병합됨
- #927Connect 플릿 경로를 우선하고 무제한 계정 용량 지원Codex 스레드병합됨
- #880스레드 머신 칩이 Hand off to를 가리키도록 변경Claude Code 스레드병합됨
- #873복귀 시 묻기를 기본값으로, 유휴 압축은 선택 사항으로Claude Code 스레드병합됨
- #837PPTX 산출물을 슬라이드 미리보기로 열기Claude Code 스레드병합됨
스레드 기록 기준: 각 풀 리퀘스트는 옆에 표시된 워커 스레드가 열고 연결했어요. 개발 저장소에 반영되며, 공개 소스 저장소에는 정기적으로 스냅샷이 올라가요.
Claude Code가 한도에 닿으면 Codex가 같은 작업을 이어받아요
핸드오프에는 스펙, 담당 기록, 증거가 담겨요. 채팅 창에만 남는 정보는 없어요.
스펙
에이전트가 시작하기 전에 한 번 적어 두는 완료의 의미.
spec.md## Acceptance Criteria - [ ] AC-01: Returning within 24 hours restores the cart and shipping choice - [ ] AC-02: A paid order is never restored ### T-01 Save the cart as a draft - AC: AC-01 | Files: src/draft.js | Test: npm test ### T-02 Restore the draft on return - AC: AC-01, AC-02 | Files: src/restore.js | Test: npm test
에이전트
파일을 읽을 수 있는 도구라면 무엇이든 작업을 맡고, 증명하고, 다음으로 넘어가요.
specweave task claim T-01Claude Code가 첫 번째 열린 작업을 맡아요. 담당은 원장의 한 줄이라서 다른 에이전트가 같은 작업을 가져가지 못해요.
specweave task done T-01 --run "npm test"작업의 테스트를 실행해요. 종료 코드 0이 증거이며, 전체 출력은
reports/task-T-01.txt에 저장돼요.specweave task claim T-02Claude Code가 T-02를 맡았다가 작업 도중 사용 한도에 닿아요.
사용 한도
git의 원장
모든 담당, 완료, 해제가 한 줄이며 코드와 함께 커밋돼요.
ledger.jsonl{"t":"T-01","e":"claim","by":"claude@cloud","at":"2026-10-15T14:02:11Z"} {"t":"T-01","e":"done","by":"claude@cloud","at":"2026-10-15T14:31:40Z","evidence":"a41c9e2"} {"t":"T-02","e":"claim","by":"claude@cloud","at":"2026-10-15T14:32:05Z"} {"t":"T-02","e":"release","by":"claude@cloud","at":"2026-10-15T14:58:47Z","note":"handoff"} {"t":"*","e":"handoff","by":"claude@cloud","at":"2026-10-15T14:58:47Z","note":"usage limit"} {"t":"T-02","e":"claim","by":"codex@laptop","at":"2026-10-15T15:04:19Z"} {"t":"T-02","e":"done","by":"codex@laptop","at":"2026-10-15T15:22:51Z","evidence":"npm test → exit 0\nlog: .specweave/increments/0001-resumable-checkout/reports/task-T-02.txt\nHEAD 7d03b1f"}
핸드오프
다른 도구가 채팅 창이 아니라 같은 파일에서 이어가요.
claude@cloud T-02를 넘김: codex@laptop
specweave handoff담당을 해제하고, 다음에 할 일을 담은
handoff.md을 작성하고, 스냅샷을specweave-handoff와wip/<branch>에 푸시해요.specweave pickupCodex에서: 핸드오프를 가져오고, 수정 사항을 적용하고, T-02와 두 가지 기준을 출력해요.
specweave task done T-02 --run "npm test"Codex가 같은 기준으로 T-02를 마무리하고, 원장이 테스트 출력을 인용해요.
specweave verify테스트, 린트, 빌드를 실행하고 모든 기준을 확인한 뒤
통과reports/verify.json을 작성해요.
인크리먼트 예시, specweave 3.1.0이 읽는 형식으로 작성: 기준은 - [ ] AC-01: 줄, 원장은 한 줄에 JSON 객체 하나. 실제 이어받기는 SpecWeave 작동 방식에서 확인하세요.
증거 없이는 아무것도 닫히지 않아요
인크리먼트 폴더를 열면 무엇을 계획했고, 누가 했고, 무엇이 증명했는지 볼 수 있어요.
.specweave/ increments/0001-resumable-checkout/ spec.md계획과 인수 기준 ledger.jsonl누가 어떤 작업을 맡고 끝냈는지 handoff.md마지막 에이전트가 멈춘 지점 reports/ task-T-02.txt원장이 인용하는 테스트 출력 verify.md테스트, 린트, 빌드, 기준 verify.json종료 게이트 review-codex.md다른 모델의 리뷰 memory/MEMORY.md이어받을 때 모든 도구가 읽는 사실
specweave verify통과테스트, 린트, 빌드 명령을 실행하고,spec.md의 모든 기준에 체크가 되었는지 확인한 뒤reports/verify.json를 작성해요.specweave review종료 코드 3, 먼저 수정다른 모델 계열의 리뷰어에게 diff를 넘겨요. Codex는 Claude가 작성한 코드를, Claude는 Codex가 작성한 코드를 리뷰해요. 보고서는reports/review-codex.md에 저장되며, 종료 코드 0이면 출시해도 좋아요.specweave complete차단됨통과한verify.json없이는 인크리먼트를 닫지 않아요. 그래도 닫으려면--reason가 필요하고, 그 사유는 인크리먼트와 함께 저장돼요.
17 October 2026에 출시된 specweave 3.1.0의 동작.
저희 작업으로 측정했어요
도움이 될 때 계획하고, 아닐 때는 건너뛰세요
저희는 SpecWeave로 이 제품들을 만들어서 스펙이 어디서 값을 하는지 살펴봤어요. 작은 변경은 어느 쪽이든 거의 같았어요. 큰 인크리먼트 기반 작업은 메시지가 더 많이 필요했기 때문에, 인크리먼트는 Codex나 다른 계정, 다른 머신이 이어받을 작업에만 써요.
- 1,476
- 4주 동안 측정한 병합된 풀 리퀘스트, 작업을 수행한 에이전트 스레드 1,142개와 함께
- 35%
- 는 인크리먼트와 연결돼 있었고, 나머지는 바로 작업했어요
- ≈ 1x
- 변경 300줄 미만에서 열려 있던 시간과 출력 토큰, 인크리먼트가 있든 없든
- ≈ 2x
- 변경 1,000줄이 넘는 풀 리퀘스트 하나를 출시한 인크리먼트 기반 스레드의 메시지와 출력 토큰 (17개 대 11개 스레드)
인크리먼트 건너뛰기
- 변경 약 300줄 미만의 풀 리퀘스트 하나
- 후속 수정이나 UI 조정
- 조사
specweave small-fix "<why>" 후 바로 출시하세요.
인크리먼트 계획하기
- 여러 날에 걸친 작업, 풀 리퀘스트마다 인크리먼트 하나
- 크로스 플랫폼, 인증, 결제, 마이그레이션
- 다른 도구나 머신이 이어받을 작업
specweave create-increment "<title>". 규모보다 이 기준이 우선해요.
병합된 풀 리퀘스트, SpecWithCode 스레드 기록, Claude Code 세션, 2026년 10월 6일~11월 3일. 측정 방법 읽기
같은 작업을 데스크톱 앱에서 실행하세요
SpecWithCode는 이 인크리먼트를 내 머신과 구독 위에서 스레드로 실행해요. 프로젝트마다 코디네이터가 하나 있고, 로그인한 어떤 제공업체의 워커든 쓸 수 있어요.


클라우드 컨테이너가 아닌 내 머신
- 코드, 스킬, 로그인이 이미 있는 곳에서 실행돼요.
- 노트북이 잠자기 상태여도 워커는 실행 중인 머신에서 계속 작동해요.
- 각 에이전트는 제공업체 자체의 로그인과 승인을 사용해요. 저희 쪽 계정은 없어요.
- SpecWithCode Connect로 Mac mini나 Linux 머신을 추가하세요. 그 머신에서 내 계정으로 Connect를 연결하고, 설정에서 이 머신 초대를 선택하거나
specwithcode fleet invite를 실행한 다음, 메인 Mac의 설정, 연결에 있는 머신 추가에 그 줄을 붙여 넣으면 돼요.
구독 하나에 머신 하나. 각 머신은 제공업체별로 계정 하나에만 로그인해 두세요. 예를 들어 한 머신에는 Claude Code 계정, 다른 머신에는 Codex 계정을 두는 식이에요. 같은 머신에서 구독을 수동으로 바꾸면 혼란이 생겨요. 용량이 더 필요하면 머신을 추가하세요.
몇 분이면 익힐 수 있어요
실제 앱을 자막과 챕터가 있는 내레이션 영상으로 녹화했어요.
- SpecWithCodeSee how SpecWithCode runs your agents2분 54초, 챕터 12개, 12 October 2026 게시
2분 54초 - SpecWithCodeStart SpecWithCode with a coordinator and two workers1분 49초, 챕터 8개, 18 October 2026 게시
1분 49초 - SpecWithCodeContinue a thread on Codex at a usage limit1분 1초, 챕터 7개, 10 October 2026 게시
1분 1초
- SpecWithCode 앱
- 무료
- SpecWeave CLI
- 무료, MIT 라이선스
- 좌석당 요금
- 없음
- Connect 머신
- 무료 3대, 선착순 300명의 파운더는 10대, Pro는 무제한
- AI 구독에 붙는 마진
- 없음
SpecWeave로 만든 프로젝트
- SpecWithCodeSpecWeave 인크리먼트로 계획한 앱 자체: 2026년 10월에 자체 워커 스레드에서 병합된 풀 리퀘스트 367건.
- EasyChampClaude Code 스레드, 구독 두 개, Codex로 만든 리그 및 클럽 도구.
- JobWeave구직, 맞춤 이력서, 면접 준비.
- Verified Skill스킬 탐색, 소스 검사, 로컬 평가.