AI SDK를 사용하여 Claude Code, Codex, Pi 등 에이전트 하네스 프로그래밍하기

AI SDK 7은 HarnessAgent를 새롭게 도입하여 Claude Code, Codex, Pi와 같은 기존의 에이전트 하네스를 단일 API로 실행할 수 있도록 지원한다. 기존에는 모델을 교체할 때 에이전트 코드를 다시 작성해야 했으나, 이제는 하네스(Harness)까지 동일한 방식으로 손쉽게 교체할 수 있다.

Harness는 모델 호출 상위 계층에서 스킬, 샌드박스, 세션, 권한 흐름, 런타임 구성 및 서브 에이전트 등을 관리하는 역할을 수행한다. AI SDK는 이러한 기능들에 대한 접근을 통합된 하네스 추상화 계층을 통해 표준화한다.

주요 특징은 다음과 같다:

• 유연한 교체: claudeCode를 codex나 pi로 교체하더라도 동일한 HarnessAgent 흐름을 유지할 수 있다.
• 보안성: 모든 하네스는 에이전트를 샌드박스 워크스페이스에서 실행하여 호스트 환경을 안전하게 보호한다.
• 호환성: HarnessAgent.generate()와 HarnessAgent.stream()은 AI SDK와 호환되는 결과를 반환하므로, 기존 useChat 사용자도 UI 코드 수정 없이 바로 도입 가능하다.

현재 이 기능은 experimental(실험적) 단계로, AI SDK canary 릴리스에서 사용할 수 있으며 향후 API 변경이 있을 수 있다.