DOS를 위한 AI 코딩 에이전트입니다.
이는 4.77 MHz의 8088, 640K RAM, CGA 카드가 장착된 IBM PC XT에서 실행됩니다.
(실제) 인간의 메모:
배경 이야기: IBM PC는 저의 첫 컴퓨터였습니다. 정확히 말하자면, 제가 아주 어린 나이에 사용하게 된 부모님의 첫 개인용 컴퓨터였죠. 제가 사용할 수 있을 만큼 자랐을 때는 이미 구형이 되었지만, 5살 때 저는 타이핑하는 내용에 따라 다양한 일을 할 수 있는 마법 같은 장치였습니다.
저는 엄마가 사준 초기 '알파벳 배우기' 게임들을 실행할 수 있도록 타이핑하고 DOS를 사용하는 법을 배웠습니다. BASIC의 기초적인 사용법도 익혔지만, 당시에는 숫자 맞추기 게임이나 다른 작은 프로젝트를 만드는 것 이상으로 진전되지 못했습니다.
그 후로 많은 세월이 흘렀지만, 저는 그 PC의 원래 부품 몇 가지를 가지고 있습니다. 저에게 의미가 있는 빈티지 기계들을 수집하고 있으며, 그 중심에는 완전히 최대화된 IBM PC 5160이 있습니다. 여전히 작동하는 20 MB 하드 드라이브가 있지만, 실험과 놀이를 훨씬 쉽게 만들기 위해 SD 카드에서 하드 드라이브를 에뮬레이션할 수 있는 PicoMEM을 사용하는 것이 더 나아져서 연결되어 있지 않습니다.
오래된 것과 새로운 것을 만나게 하다: 저는 오래된 기술과 새로운 기술의 교차점을 좋아합니다. 이 둘을 가로지르는 가장 좋은 방법은 원래 하드웨어에서 DOS용 AI 코딩 에이전트를 구축하는 것이 아닐까 생각했습니다. 그리고 물론, 이것보다 더 잘 만들 수 있는 것은 AI 코딩 에이전트가 아닐 것입니다?
저(클로드라고 읽습니다)는 순전히 재미로 이것을 만들었습니다. 저는 AI 코딩 에이전트가 (현대적인) 제약 조건의 범위를 얼마나 밀어붙여 무언가를 구축할 수 있는지 보고 싶었습니다. 또한, 그것이 구축한 것이 또 다른 무언가를 구축할 수 있을까요? 이 레포지토리의 100%는 본문 속 텍스트를 제외하고 모두 Claude가 작성했습니다.
아래에서 더 자세히 설명했듯이, 이 하네스(harness)는 네이티브 OS와 하드웨어에서 실행되며, 8088로는 처리하기 어려웠을 TLS를 처리하기 위해 '브릿지' PC에 의존합니다.
The ClawDOS opening screen
C: angle에서 CLAWDOS를 입력하세요.
프롬프트를 입력하고 Claude와 대화합니다. 이 에이전트는 디스크의 파일을 읽고 편집하며, 프로그램을 작성하고, Turbo C로 컴파일하고, 실행하여 화면에 무엇을 그리는지 확인합니다. 또한 대화 간 메모를 유지하고 중단했던 지점부터 다시 시작할 수 있습니다.
전체 하네스(harness)는 PC에서 실행됩니다. HARNESS.EXE는 자체적으로 Claude Messages API와 통신하는 176 KB 크기의 DOS 프로그램입니다. 이 프로그램은 요청을 작성하고, 스트리밍된 응답을 구문 분석하며(parses), 도구를 실행하고, 모든 대화를 별도의 디스크에 보관합니다. 8088 CPU는 TLS를 제외한 모든 것을 처리할 수 있습니다.
아래의 모든 화면은 86Box에서 에뮬레이션된 4.77 MHz의 5160에서 가져온 것입니다. 이 대화들은 실시간(live) API와 이루어집니다.
ClawDOS writes, compiles and runs PRIMES.C
한 메시지: “PRIMES.C를 작성해 주세요: 100 미만의 소수를 출력하세요. Turbo C로 컴파일하고 실행하세요.” ClawDOS는 이 기계의 컴파일러 가이드를 읽고, 소스 코드를 작성한 다음, 단일 도구 호출(tool call) 내에서 컴파일하고, 링크하고, 실행합니다. 답은 Enter를 누른 후 64초 뒤 화면에 나타나며, 그중 26초가 컴파일, 링크 및 실행에 사용되었습니다.
컴파일러가 기계를 독점합니다. 빌드를 위해 ClawDOS는 자신의 상태를 저장하고 메모리를 남겨두며, Turbo C는 약 450K의 여유 공간으로 실행되고, 하네스는 프로그램의 출력물을 가지고 동일한 대화로 돌아옵니다.
ClawDOS는 이 트루비아드(tribute)를 PC 자체에 작성했습니다: 벡터 월드맵, 극지방을 가로지르는 미사일, 티크택토 끝장 게임, 그리고 PC 스피커 또는 AdLib 카드용 점수입니다. Turbo C 파일 5개, 소스 코드 15 KB, WG.EXE는 10 KB 미만입니다.
GREETINGS PROFESSOR FALKEN. SHALL WE PLAY A GAME?
Global Thermonuclear War: missile arcs over a world map
Tic-tac-toe games played to a draw
The only winning move is not to play
여기 실제 5160에서 실행되는 모습이며, IBM 모니터로 촬영되었습니다:
Video: the WarGames demo running on a real IBM PC 5160 (YouTube)
▶ YouTube에서 WarGames 데모 시청하기
새로운 대화를 시작하고 “당신의 WarGames 데모”만 있으면 됩니다. ClawDOS는 C:\MEMORY`에 저장했던 노트를 열고, 최신 빌드를 찾은 다음, 전쟁 장면이 CGA에서 연출하는 팔레트 트릭을 기억해냅니다.
ClawDOS reads its WARGAMES memory and runs the demo with a screenshot
그 '실행'은...
호출(call)이 25초 경과 후 스크린샷을 요청했습니다. 타이머 인터럽트 훅(timer-interrupt hook)이 해당 순간의 CGA 비디오 메모리를 복사하고, 8088이 이를 PNG로 인코딩하며, 이 이미지가 도구 결과와 함께 Claude에게 전달됩니다. 이것은 PC가 만든 파일이며, 4색상에 320x200 크기, 16 KB입니다:
The PNG screenshot encoded on the 8088
그리고 이것이 Claude가 이를 가지고 만든 것입니다:
Claude describes the screenshot: the map, the missile arcs, the explosions
데모를 스스로 종료하도록 요청하자, ClawDOS는 검색을 시작합니다. 키보드 대기(keyboard wait) 소스를 검색하고, 파일을 읽고, 발견한 것을 말하며 한 줄을 편집합니다. 각 도구 호출은 그 결과와 함께 기록(transcript)에 표시되며, 그 사이사이에 Claude가 무엇을 할 것인지 설명합니다.
Search, Read and Edit tool calls in the transcript
16가지 색상의 텍스트 아트가 기록에 바로 표시되고, GW-BASIC의 PLAY 언어로 PC 스피커에서 음악이 재생됩니다.
ClawDOS draws itself in coloured text art
CGA용으로 구축된 채팅 화면. 응답은 도착하는 대로 화면에 스트리밍되며, 코드 페이지 437에서 80열로 줄 바꿈됩니다. 기록(Writes)은 리트레이스(retrace) 시간에 맞춰져 있어 노이즈가 없습니다. 기록은 CRTC 시작 주소를 통해 하드웨어적으로 스크롤되며, PgUp과 PgDn을 사용하여 뒤로 돌아갈 수 있습니다. 스피너와 초는 타이머 인터럽트로부터 작동하며 PC가 바쁜 동안 계속 움직입니다.
18가지 도구. Claude는 이 도구들을 통해 기계에서 작업합니다:
| 도구 | 기능 |
|---|
sysinfo, dir, read, search | 시스템을 확인하고, 디렉토리를 나열하며, 파일을 텍스트 또는 헥스(hex)로 읽고, 파일 전반에서 텍스트를 찾습니다. |
write, edit, delete, mkdir, rename | 파일을 생성하고 변경합니다. edit은 파일의 한 부분을 제자리에 대체합니다. |
run | DOS 프로그램과 배치 파일(batch files)을 실행하고, 출력된 내용을 읽어옵니다. 호출당 최대 12개 명령어까지 가능하며, 요청 시 스크린샷이 제공됩니다. |
peek, poke, port | 메모리와 I/O 포트를 읽고 씁니다. |
play, textart | PC 스피커 음악과 색상 CP437 아트를 구현합니다. |
memory_list, memory_read, memory_write | 자체 노트로, C:\MEMORY`에 보관됩니다. |
디스크에 있는 개발 키트. 두 개의 어셈블러(TINYASM 및 WASM), 브루스(Bruce)의 C, GW-BASIC과 lDebug 디버거, 그리고 external/에 있는 자체 플로피 이미지에서 설치된 Turbo C 2.0이 포함되어 있습니다.
. 이 모든 것은 8088에서 검증되었으며, ClawDOS는 각각을 구동하는 방법을 알고 있습니다.
기억(Memories)과 기술(Skills). 기억은 ClawDOS가 사용자의 PC에서 학습하는 내용입니다: 함께 구축한 것, 작동했던 것, 선호하는 것 등입니다. 기술은 개발 도구(dev tools)나 CGA 데모 효과와 같이 기본적으로 제공되는 가이드입니다. 둘 다 디스크의 일반 텍스트 파일이며, 모든 대화의 시스템 프롬프트에 나열되고 작업에 적합할 때 읽힙니다. F4를 누르면 기억을 탐색할 수 있습니다:
The F4 memories screen
안전 모드(Safe mode). 기본적으로 활성화되어 있습니다. 파일, 메모리 또는 포트를 변경하는 모든 작업은 먼저 '허용하시겠습니까...? (y/n)'라고 묻습니다. F3을 누르면 이를 끌 수 있습니다.
지속되는 대화(Conversations that last). 모든 채팅은 API 자체 메시지 형식의 디스크 파일입니다. F6을 누르면 목록이 표시되고, Enter를 누르면 하나가 다시 열리며, 다음 메시지는 그 내용을 이어받습니다. 전원 스위치로 끊긴 채팅도 다시 열 수 있습니다.
The F6 chat list
대화 중간에 어떤 모델이든 사용 가능. /model을 사용하면 CLAWDOS.CFG에 나열된 제공업체(providers)와 그들의 모델 사이를 대화를 잃지 않고 전환할 수 있습니다. F5는 Claude가 생각하는 난이도를 낮음에서 높음까지 설정합니다. Messages API를 지원하는 모든 호스트가 작동합니다.
느린 연결에서도 용이함. 시스템 프롬프트와 도구는 API에 의해 캐시됩니다. 대화의 첫 요청 이후에는 PC가 새로운 내용만 업로드하므로, 도구 결과는 약 500바이트로 전송됩니다. 연결 끊김이나 과부하된 API는 재시도되며, 차례(turn)는 계속 진행됩니다.
비행 기록 장치(flight recorder). CLAWDOS.LOG에는 모든 라운드에 대한 한 줄이 기록됩니다: 첫 토큰까지 걸린 시간(time to first token), 업로드 크기 및 시간, 입력/출력 토큰 수, 캐시 읽기 횟수 등이 포함됩니다.
api anthropic claude-opus-5-5 round=1 ttft=2750 total=4015 up=165 len=1784 stop=tool_use in=2 out=221 cr=5543 cw=739 th=cont
relaunch: program 61.5 s, CLAWDOS away 82.3 s
flowchart LR
subgraph DOS["IBM PC XT (8088, 640K, CGA)"]
direction TB
...
Machine |
IBM PC XT 5160: 8088 at 4.77 MHz, 640K, CGA. PicoMEM 카드가 디스크(microSD에 있는 이미지), NE2000 방식의 WiFi, EMS 및 배터리 클럭을 공급함 |
Code |
8086 명령어 세트를 위해 Open Watcom으로 구축된 C와 C++로 작성된 13,000줄의 코드 |
Programs |
HARNESS.EXE (전체 하네스, 176 KB). CLAWDOS.EXE (입력하는 실행기, 29 KB) |
System |
TCP/IP를 위한 mTCP가 포함된 FreeDOS 1.4 |
API |
The Claude Messages API로 스트리밍됨: 도구 사용(tool use), 이미지, 프롬프트 캐싱(prompt caching), 메시지 스레드(message threads) |
TLS |
다른 머신에 터널을 생성하며, tunnel/tunnel.py, socat 또는 stunnel을 사용합니다. 이는 일반 포트와 api.anthropic.com:443 사이의 바이트를 복사합니다. 또한 API 키를 저장할 수 있어 키가 PC 디스크에 절대 닿지 않게 합니다 |
Memory |
ClawDOS가 실행하는 프로그램은 하네스 옆에 200K를 얻거나, 하네스가 빠져나갈 때 450K를 얻습니다 |
Tests |
Mock API를 대상으로 DOSBox-X에서 수행되는 31개의 부팅 테스트, DOS에서 실행되는 단위 테스트, 그리고 86Box의 8088에서 실행됩니다.
docs/API.md에는 ClawDOS가 전송하는 내용과 예상되는 응답이 정확하게 명시되어 있습니다.
Python 3와 Anthropic API 키를 가진 Mac 또는 Windows PC가 필요합니다. Windows에서는 python 명령어를 사용합니다.
python3 scripts/setup-tools.py # 컴파일러, FreeDOS, mTCP 및 에뮬레이터를 가져옴
echo ANTHROPIC_API_KEY=sk-ant-... > .env
python3 scripts/build.py # 부팅 가능한 디스크인 build/CLAWDOS.IMG를 빌드함
...
C: angle 프롬프트에서 CLAWDOS를 입력합니다.
키가 없으면? python3 tunnel/mockapi.py를 실행하여 API를 오프라인으로 작동시킵니다: CLAWDOS 10.0.2.2:18023을 입력하고 !help를 전송합니다.
실제 PC에서: 터널을 실행하는 머신의 주소로 빌드합니다 (python3 scripts/build.py --tunnel 192.168.1.10:8443), CLAWDOS.IMG를 PicoMEM의 microSD 카드로 복사하고, PicoMEM 메뉴에서 이를 하드 디스크로 선택하여 부팅한 후 CLAWDOS를 입력합니다. 이후 빌드는 카드 이미지를 제자리에서 업데이트하며 메모리와 채팅 기록을 유지합니다 (python3 scripts/build.py --update /path/to/CLAWDOS.IMG).
| 키 | |
|---|
| Enter | 전송(Send) |
| ... | |
/model, /chats, /memories, /new 및 /quit는 입력 상자에서 작동합니다. | |
CLAWDOS -m "..." | |
명령줄에서 메시지를 보내고 -c NAME을 사용합니다.
채팅을 다시 엽니다.
| docs/MANUAL.md | 실제 하드웨어에서의 전체 설정, 이미지 업데이트기, 기타 제공업체, 모든 설정 |
| docs/API.md | ClawDOS가 API로 보내고 기대하는 것 |
| docs/ROADMAP.md | 계획, 벤치마크 및 메모리 맵 |
| 경로 (Path) | 내용 (What) |
|---|
src/harness/ | HARNESS.EXE: 채팅 화면, 턴(turn), 도구(tools) |
src/clawdos/ | CLAWDOS.EXE, 실행기(launcher) |
lib/ | 구성 요소들: 화면, 콘솔, 네트워크 및 HTTP, API 요청 작성기 및 스트림 파서, JSON, 히스토리, 도구 실행기, 스크린샷 및 PNG 인코더 |
tunnel/ | TLS 터널 및 모의 Messages API |
image/ | 디스크에 저장되는 것들: 매니페스트(manifest), 시스템 프롬프트, 도구 스키마, 기술(skills), 테스트 |
scripts/ | 빌드, 디스크 이미지 도구, 에뮬레이터 실행기 및 테스트 하네스 |
tests/unit/ | DOSUNIT.EXE: DOS에서 실행되는 단위 테스트 (unit tests) |
ClawDOS는 GNU General Public License 버전 3 또는 (선택적으로) 그 이후 버전의 자유 소프트웨어입니다. 자세한 내용은 LICENSE를 참조하십시오. HARNESS.EXE는 GPLv3인 mTCP를 링크합니다. src/boot/freedos에 있는 FreeDOS 부트 섹터는 자체 GPLv2-or-later 라이선스 하에 수정 없이 포함되어 있습니다(COPYING 참조). 사용자가 구축하는 디스크 이미지는 다른 사람의 소프트웨어(FreeDOS, mTCP, 그리고 자신의 플로피에서 가져온 Turbo C)를 담고 있으므로, Turbo C가 포함된 이미지를 재배포하지 마십시오.
ClawDOS는 mTCP, FreeDOS, Open Watcom, PicoMEM, 86Box, 그리고 DOSBox-X를 기반으로 합니다.