오픈코드 2.0, 코딩 에이전트를 상시 서버로

오픈코드(OpenCode) 2.0은 코딩 에이전트의 중심을 화면에서 상시 실행되는 서버로 옮겼다. 터미널·웹·데스크톱 앱이 같은 프로세스에 연결하고, 에이전트는 도구를 묶어 실행하거나 다른 에이전트에 일을 맡길 수 있다. 개발팀은 API와 플러그인 구조도 다시 만들었다. 이번 개편은 코딩 에이전트를 하나의 앱이 아니라 여러 화면과 자동화 작업이 공유하는 실행 환경으로 다루려는 시도다. 다만 편의성이 커진 만큼 자동 실행과 설정 변경을 어디까지 허용할지도 중요한 질문으로 떠올랐다.

핵심요약

  • 오픈코드 2.0은 로컬 서버를 백그라운드에서 자동 실행해 터미널·웹·데스크톱 앱과 스크립트가 같은 프로세스를 이용하게 했다.
  • 새 클라이언트와 서버 API는 세션 생성과 도구 연결 방식을 다시 짜, 오픈코드를 다른 프로그램에서 호출하기 쉽게 만들었다.
  • 코드모드는 여러 도구 호출을 하나의 스크립트로 묶어 실행해 에이전트의 왕복 호출과 도구 목록이 차지하는 문맥을 줄이려 한다.
  • 백그라운드 하위 에이전트와 셸 명령은 오래 걸리는 작업을 맡겨 두고 대화를 이어갈 수 있게 한다.
  • 플러그인 즉시 재적용과 SDK는 확장성을 높이지만, 기존 플러그인과 서버 API를 쓰던 이용자에게는 마이그레이션이 필요하다.

모든 화면이 연결되는 로컬 서버

오픈코드는 처음부터 클라이언트·서버 구조를 채택했지만, 기존에는 이를 주로 숙련 이용자가 활용했다. 2.0에서는 서버가 컴퓨터에서 하나의 백그라운드 프로세스로 자동 실행된다. 텍스트 기반 사용자 인터페이스(TUI), 웹 화면, 데스크톱 앱을 열어도 각각 별도의 중심을 만드는 대신 같은 프로세스와 통신한다. 개발팀이 강조하는 변화는 특정 화면의 기능 추가보다, 작업을 맡는 실행 주체가 화면과 분리됐다는 점이다.

직접 만든 스크립트에서 @opencode/client를 쓰면 로컬 서비스를 자동으로 찾아 연결한다. 정해진 시각에 실행하는 작업에도 유용한 방식이며, 명령줄에서는 opencode api 명령으로 서버를 호출할 수 있다. 서버를 다른 호스트에 노출하고 /pair 또는 opencode pair로 다른 애플리케이션과 연결하는 길도 마련했다. 개발팀은 이 연결 방식을 활용하는 네이티브 앱을 준비하고 있다고 밝혔다.

처음부터 다시 만든 서버 API

개발팀은 기존 API가 코딩 에이전트의 쓰임새를 알아가는 과정에서 일관성 없이 커졌다고 설명한다. 이에 2.0에서는 여러 이용 사례를 검토해 서버 API를 새로 설계했다. 오픈코드가 자신의 API를 알고 직접 호출할 수도 있다. 예를 들어 새 작업을 시작할 때 현재 세션을 깃 워크트리(git worktree·한 저장소의 작업 공간을 따로 두는 기능)로 옮기는 데 이를 쓴다.

새 @opencode/client 패키지에는 일반 자바스크립트(JavaScript)용 클라이언트와 이펙트(Effect)용 클라이언트가 들어 있다. 개발팀이 제시한 예시는 로컬 서비스를 확보하고, 현재 디렉터리에 세션을 만든 뒤, 변경 사항 검토를 요청하는 흐름이다. 앞서 나온 상시 서버가 접속할 대상을 제공한다면, 새 클라이언트는 그 서버에 작업을 맡기는 수단인 셈이다. 다만 서버 API 자체가 완전히 달라졌으므로 기존 연동 코드는 그대로 동작한다고 기대하기 어렵다.

도구 여러 개를 한 번에 다루는 코드모드

오픈코드 2.0은 모델이 코드를 잘 작성한다는 점을 도구 사용 방식에도 적용했다. 개발팀은 @opencode/codemode에 간단한 자바스크립트 인터프리터(코드를 읽고 실행하는 프로그램)를 만들었다. 이 패키지는 MCP(모델과 외부 도구를 연결하는 프로토콜) 서버나 오픈API(OpenAPI·API의 호출 방식을 기술하는 명세) 엔드포인트를 에이전트가 스크립트에서 부를 수 있는 함수로 바꾼다. 개발팀은 노드.js(Node.js) 가상머신이나 퀵JS(QuickJS) 같은 실행 환경을 넣지 않고도 스크립트를 실행하도록 설계했다고 설명한다.

에이전트는 도구 하나를 호출한 뒤 결과를 순회하고, 그 결과로 다른 도구를 호출하는 코드를 작성할 수 있다. 도구를 하나씩 왕복 호출하는 대신 일련의 작업을 한 번에 처리하는 방식이다. 2.0에서는 모든 MCP 서버가 기본적으로 코드모드를 사용한다. 개발팀은 도구를 많이 추가해도 모델에 전달되는 문맥이 크게 불어나지 않고, 에이전트가 필요한 함수를 찾아 조합할 수 있다고 주장한다.

기다리는 동안 계속되는 작업

이번 버전에는 백그라운드 하위 에이전트가 추가됐다. 주 에이전트가 다른 에이전트에 일을 맡긴 뒤에도 이용자와 대화를 이어갈 수 있고, 다른 모델을 지정해 수동으로 실행할 수도 있다. 개발팀은 코드를 검토하는 하위 에이전트를 뒤에서 돌리는 사례를 들었다. 하나의 요청이 끝날 때까지 대화를 멈추는 대신, 여러 작업의 진행을 조율하도록 한 것이다.

셸 명령도 비동기로 실행할 수 있어 오래 걸리는 명령이 주 에이전트를 막지 않는다. 작업이 끝나면 완료 사실을 알리며, 예상보다 길어지는 포그라운드 명령이나 하위 에이전트는 단축키로 백그라운드로 옮길 수 있다. 자동으로 맡기는 일과 이용자가 직접 뒤로 보내는 일을 모두 지원한다. 코딩 에이전트를 연속해서 지시할 때 대기 시간을 줄이는 데 초점을 맞춘 변화다.

내부 기능까지 플러그인으로

1.0에도 플러그인 체계는 있었지만, 개발팀은 충분히 관리하지 못했다고 인정했다. 2.0에서는 거의 모든 기능을 내부 플러그인으로 구현했고, 그 수가 80개를 넘는다. 제품 자체가 플러그인 API를 계속 사용하게 만들어 확장 인터페이스를 유지·관리하겠다는 접근이다. 실험 단계였던 TUI 플러그인도 안정 기능으로 올렸다.

오픈TUI(OpenTUI)를 바탕으로 화면을 확장할 수 있으며, 개발팀은 2.0의 구성 요소가 실행 중 다시 읽히도록 하는 데도 공을 들였다고 밝혔다. 이에 따라 오픈코드가 세션 도중 자신에게 필요한 플러그인을 작성하고 곧바로 사용할 수 있다. 이용자가 원하는 플러그인을 만들어 달라고 요청하는 흐름도 가능하다. 설정과 기능을 빠르게 바꿀 수 있다는 장점이 있지만, 커뮤니티에서는 에이전트가 수정한 플러그인을 즉시 적용하는 방식에 대한 경계도 나왔다.

CLI와 같은 코드를 쓰는 SDK

오픈코드는 이제 @opencode/sdk 패키지를 통해 라이브러리로도 사용할 수 있다. 이 패키지는 명령줄 인터페이스(CLI)를 구동하는 코드와 동일하다. 개발팀은 필요한 부분만 골라 서버나 듀러블 오브젝트(Durable Objects) 같은 특수한 실행 환경에 맞는 오픈코드를 만들 수 있다고 설명한다. 그렇게 만든 프로그램도 표준 오픈코드 서버 프로토콜을 사용하면 기존 클라이언트에서 연결할 수 있다.

선택적으로 쓸 수 있는 이펙트 기반 API도 있지만 아직 개발 중이다. SDK가 겨냥하는 대상은 기본 앱의 설정을 바꾸는 이용자보다, 오픈코드의 실행 기능을 다른 환경에 심으려는 개발자에 가깝다. 앞의 로컬 서버와 새 클라이언트가 접속 방식을 통일한다면, SDK는 서버 쪽 구현을 변형할 길을 연다. 개발팀은 이 구조를 통해 같은 클라이언트가 서로 다른 형태의 오픈코드 실행 환경에 연결되도록 했다.

업그레이드 전에 확인할 호환성

CLI를 올리려면 먼저 최신 1.x 버전을 설치한 뒤 opencode upgrade --major를 실행해야 한다. 데스크톱 앱은 새 버전을 내려받아 설치하는 방식이다. 개발팀은 다른 변경 사항 다수는 이전 버전과 호환되지만, 몇 가지는 기존 구성을 깨뜨린다고 안내했다. 기능 변화만 보고 곧바로 업그레이드하기보다 현재 연동 지점을 확인해야 하는 이유다.

가장 직접적인 변화는 1.0 플러그인이 2.0에서 작동하지 않는다는 점이다. 서버 API도 완전히 달라졌고, tui.json 설정은 json으로 옮겨졌다. 개발팀은 마이그레이션 문서를 오픈코드에 읽혀 이전 작업을 맡기는 방법을 제안했다. 자신을 수정할 수 있다는 새 버전의 특징이 업그레이드 과정에도 쓰이는 셈이다.

커뮤니티 의견

한 사용자는 2.0의 사용성과 클라이언트·서버 구조를 높이 평가하면서, 깃허브(GitHub) 이슈 처리도 인상적이라고 했다. 그의 설명에 따르면 연결된 앱이 버그 신고를 읽고 해당 버전과 최신 개발 브랜치에서 재현을 시험한 뒤 스크립트와 결과를 남기며, TUI 문제에는 영상까지 붙인다. 오픈터널(opentunnel)에서는 개인에게 고유하게 유지되는 하위 도메인과 로컬에서 생성하는 와일드카드 인증서를 눈여겨봤다.

다른 사용자는 1.0에서 번거로웠던 기능들이 2.0에 들어왔다고 평가했다. 스킬과 플러그인의 자동 재적용, 설정 편집 기능, 세션을 만든 폴더 기준의 설정 불러오기, 하위 세션과의 소통을 장점으로 들었다. 답글에서는 작업을 모델이 자동으로 백그라운드에 보낼 수 있다는 설명과, 반대로 플러그인을 에이전트가 고쳐 즉시 적용하는 것은 보안상 불편하다는 반론이 함께 나왔다.

한 사용자는 클로드 코드(Claude Code)의 자동 권한 모드와 비슷한 기능이 있는지 물었다. 모든 명령을 승인하면 작업 흐름이 끊기지만, 확인 없이 실행하는 방식도 위험하게 느껴진다는 이유다. 백그라운드 작업과 자동 도구 실행이 늘어날수록 이용자가 승인 범위를 어떻게 정할지가 중요해진다는 질문이다.

플러그인 중심 설계를 반기는 의견도 있었다. 한 사용자는 1.0에서 우회해 구현했던 기능 중 세션을 다른 폴더에 연결하는 작업이 2.0에서는 기본 기능이 됐다고 했다. 다만 플러그인이 이용자가 작성 중인 응답을 읽을 수 있는 기능은 여전히 필요하다고 덧붙였다.

또 다른 사용자는 발표 글에서 큰 변화의 목록을 파악하기 어려웠다며, 실행이 느린 문제와 오래된 채팅 데이터가 개선됐기를 바랐다. 이에 대한 답글은 서버가 계속 실행되는 구조 덕분에 프로그램이 훨씬 빨리 열린다고 전했다. 같은 상시 서버 변화가 설계상의 장점뿐 아니라 매일 체감하는 시작 속도로도 평가받은 것이다.

원격 호스트에서 작업하는 이용자는 네이티브 앱이 오픈코드 서버에 연결하는 구조를 반겼다. 그는 클로드 코드 데스크톱 앱의 연결 방식에서는 다시 접속할 때 별도 엔진이 재시작돼 오래 걸리는 세션에 지장을 준다고 비교했다. 다만 답글에서는 다른 에이전트에도 활용 가능한 프로토콜이 있다거나, 오픈코드 데스크톱 앱의 실제 연결 방식이 어떻게 바뀌었는지 확인이 필요하다는 의견이 나왔다.

코딩 에이전트를 고를 기준을 묻는 의견도 있었다. 한 사용자는 오픈코드 같은 도구와 코덱스(Codex)·클로드를 비교할 벤치마크가 있는지 질문했다. 답글은 같은 모델을 써도 도구가 테스트 통과까지 재시도를 지시하는 식으로 결과를 바꿀 수 있어, 벤치마크 점수만으로 실행 환경의 차이를 판단하기 어렵다고 지적했다.

설치 경험과 보안을 문제 삼는 목소리도 나왔다. 한 사용자는 설치 진행률 표시 때문에 작업이 매우 느려졌고, 출력을 파이프로 넘기자 해결됐다고 전했다. 답글에서는 터미널 환경 문제일 가능성을 묻는 한편, 설정을 불러오는 과정의 보안 문제를 제기하며 2.0의 방향을 신뢰하기 어렵다는 주장도 제시됐다.

핵심통찰

오픈코드 2.0은 코딩 에이전트를 명령을 받을 때마다 여는 도구에서, 여러 화면과 스크립트가 접속하는 상시 실행 환경으로 바꾼다. 코드모드와 백그라운드 작업, 플러그인은 그 환경 안에서 에이전트가 더 많은 일을 스스로 연결하도록 돕는다. 앞으로 확인할 지점은 기능의 수보다 통제 방식이다. 명령 승인, 설정 변경, 플러그인 즉시 적용의 경계를 이용자가 분명히 정할 수 있어야 편의성이 신뢰로 이어진다.


원본: OpenCode 2.0

토론: Hacker News