탄생 비화

"터미널에서 Claude를 사용하여 이것저것 만져보기 시작했습니다. 첫 번째 버전은 아주 단순했습니다. 파일을 읽을 수도 없었고, bash를 사용할 수도 없었으며, 엔지니어링 관련 작업은 전혀 할 수 없었습니다. 하지만 컴퓨터와 상호작용할 수는 있었죠. 이 프로토타입을 AppleScript에 연결했습니다. 제가 일하는 동안 어떤 음악을 듣고 있는지 알려줄 수 있었죠. 그리고 제 입력에 따라 재생 중인 음악을 바꿀 수도 있었습니다. 멋진 데모였지만, 그렇게 흥미롭지는 않았습니다."

"파일 시스템 및 배치(Batch)와 상호작용할 수 있는 몇 가지 도구를 주었습니다. 파일을 읽고 쓰고 배치 명령을 실행할 수 있게 되었죠. 갑자기 이 에이전트가 정말 흥미로워졌습니다. 우리 코드베이스에서 실행해보고 질문을 던지기 시작했습니다. 그러자 Claude가 파일 시스템을 탐색하고 파일을 읽기 시작했습니다. 파일 하나를 읽고, 임포트(Imports)를 확인한 다음, 임포트에 정의된 파일들을 읽어 내려갔습니다! 답을 찾을 때까지 계속되었죠. Claude가 파일 시스템을 탐색하는 모습은 저에게 정말 충격적이었습니다. 이런 도구를 한 번도 써본 적이 없었거든요. AI 분야에서는 '제품 오버행(Product overhang)'이라는 말을 쓰는데, 이것이 바로 우리가 프로토타입을 통해 발견한 것입니다. 제품 오버행이란 모델이 특정 작업을 수행할 능력이 있음에도 불구하고, AI가 실행되는 제품이 그 능력을 포착할 수 있도록 구축되지 않은 상태를 의미합니다. Claude가 파일 시스템을 탐색하는 것을 보고 제가 발견한 것은 순수한 제품 오버행이었습니다. 모델은 이미 이 일을 할 수 있었지만, 이 능력을 중심으로 구축된 제품이 없었던 것이죠!"

"사실 우리는 Claude Code를 공개적으로 출시하고 싶은지조차 확신하지 못했습니다. 이것이 우리에게 '비밀 소스'와 같은 경쟁 우위가 될 수 있다고 생각했기 때문입니다. 우리에게 이점을 준다면 왜 출시해야 할까요? 결국 우리는 다음과 같은 결론에 도달했습니다: 따라서 이 도구를 출시함으로써 우리는 모델의 안전성과 능력에 대해 훨씬 더 많은 것을 배울 수 있습니다."

"우리가 한 일의 대부분은 정말 빠르게 프로토타입을 만들고 기본 모델이 얼마나 강력한지 보여주는 제품을 구축하는 것이었습니다. 팀 내부에 공식적인 프로세스는 없었습니다. 모든 것이 매우 유동적이었죠. 우리는 원하는 것은 무엇이든 작업할 수 있었고, 그래서 가장 유망한 아이디어를 계속 선택했습니다."

"사무실로 걸어 들어가다가 한 데이터 과학자의 화면을 슬쩍 보았습니다. Claude Code를 실행하고 있더군요. 저는 '잠깐만요, 왜 Claude Code를 쓰고 있나요?'라고 물었습니다. 그는 '이걸 실행해서 나 대신 쿼리를 작성하게 하는 방법을 알아냈어요'라고 답했습니다. 요즘 데이터 과학자들이 앉아 있는 줄을 지나갈 때면 모두가 Claude Code를 실행하고 있습니다. 많은 이들이 여러 개의 인스턴스를 띄워놓고 쿼리를 실행하고, 시각화 자료를 만들고, 다른 유용한 작업들을 수행하고 있죠."

기술 스택과 아키텍처





npm install -g @anthropic-ai/claude-code

"분포 외 스택이라도 모델이 배울 수는 있습니다. 하지만 요령을 가르쳐야 하고 노력을 들여야 하죠. 우리는 가르칠 필요가 없는 기술 스택을 원했습니다. Claude Code가 스스로를 구축할 수 있는 스택 말이죠. 그리고 그것은 아주 잘 작동하고 있습니다. Claude Code 코드의 약 90%가 Claude Code로 작성되었습니다."

"이상하게 들릴 수도 있겠지만, 우리가 이것을 만드는 방식은 사람들이 모델을 가능한 한 가공되지 않은(raw) 상태로 느끼길 원하기 때문입니다. 우리는 모델이 오늘날의 제품들이 허용하는 것보다 훨씬 더 많은 일을 할 수 있다고 믿습니다. 많은 코딩 제품을 보면 모델을 방해합니다. UI 요소와 다른 부분들을 추가하여 스캐폴딩(Scaffolding)을 만드는데, 이는 환경을 어수선하게 만들어 그 도구 안에서 실행되는 모델이 마치 한쪽 다리를 저는 것처럼 느껴지게 합니다. 사용자에게 도움이 되도록 의도된 기능들이 결국 모델을 제한하게 되는 것이죠. 그래서 우리는 UI를 가능한 한 최소한으로 유지하려고 노력합니다. 새로운 모델이 출시될 때마다 우리는 한 뭉치의 코드를 삭제합니다. 예를 들어, 4.0 모델이 나왔을 때 우리는 더 이상 필요하지 않게 된 시스템 프롬프트의 절반 정도를 삭제했습니다. 우리는 프롬프트를 최소화하고 도구의 수를 최소화하는 것을 포함하여, 모델 주변에 가능한 한 적은 코드를 두려고 노력합니다. 우리는 끊임없이 도구를 삭제하고 새로운 도구를 실험합니다."

"모든 설계 결정에서 우리는 거의 항상 가장 단순한 옵션을 선택합니다. '배치 명령을 어디서 실행할 것인가?'와 '파일 시스템에서 어디를 읽을 것인가?'라는 질문에 대한 가장 단순한 답은 무엇일까요? 바로 로컬에서 하는 것입니다. 그래서 우리는 로컬 방식을 택했습니다. Claude Code는 로컬에서 배치 명령을 실행하고 파일 시스템을 읽고 씁니다. 가상화는 없습니다."



"우리의 가장 중요한 원칙은 이것입니다. Claude Code를 실행하기 시작했을 때, 권한 없이 시스템의 설정을 변경해서는 안 된다는 것입니다. 그것은 위험할 수 있으니까요. 하지만 사람들이 '사실 내가 작업 중인 맥락에서는 매번 권한을 주고 싶지 않다'라고 말하며 거부할 수 있는 방법도 제공해야 합니다. 권한 시스템에는 많은 미묘한 차이가 있습니다. 예를 들어, 명령이 들어오면 정적 분석을 수행하여 이것이 설정 파일(settings.json 파일)에서 이미 허용된 것인지 확인합니다. 설정 시스템은 프로젝트별, 사용자별, 회사별로 구성할 수 있는 다계층 시스템입니다. 팀과 설정을 공유할 수도 있습니다. 우리는 팀들이 소스 제어 체크인과 같이 Claude Code가 권한을 묻지 않도록 명령을 화이트리스트에 추가한 설정 파일을 공유하는 것을 목격하고 있습니다."

개발 속도

할 일 목록 기능 프로토타이핑하기

할 일(todos)이 들어오는 대로 표시되는 대신, 할 일에 대한 도구 사용 및 결과를 숨기고 입력창 위에 고정된 할 일 목록을 렌더링하도록 해줘. 제목은 회색으로 "/todo (1 of 3)"라고 붙여줘.



사실 할 일 목록을 전혀 보여주지 말고, 대신 모델이 할 일을 시작할 때 사용된 도구를 굵은 제목으로 인라인 렌더링해줘. "step 2 of 4" 같은 건 유지하고, 뒤에 회색으로 가운뎃점과 /todo를 추가해서 볼 수 있게 해줘.



또한 백그라운드 작업과 비슷하게 텍스트 입력창 아래에 할 일 알약을 추가해줘. "todos: 1 of 3" 같은 식으로 렌더링해야 해.



알약을 백그라운드 작업 알약처럼 대화형으로 만들어줘.



사실 알약과 제목 둘 다 취소해줘. 대신 할 일 목록을 입력창 오른쪽에 회색 구분선과 함께 수직 중앙 정렬로 렌더링해줘. 할 일이 활성화되어 있을 때만 보여주고, 끝나면 숨겨줘.

약간 뚝뚝 끊기는데, 서랍처럼 애니메이션을 추가해줄 수 있어?

사실 할 일 목록을 입력창 위에 보여주면 어떨까?



5개에서 자르고 "... and 4 more" 같은 식으로 보여줘.



회색 텍스트로 "Todo:"라는 제목을 추가해줘.