breakinglog
오픈소스 AI 코딩 도구 OpenCode가 10월 11일(현지 날짜) v1.19.0을 공개하면서, 기존 1.x 사용자에게 OpenCode 2로 옮기는 공식 명령을 추가했습니다. 동시에 터미널 인터페이스(TUI)에서 업데이트가 더 이상 자동으로 설치되지 않으며, 사용자가 직접 /update를 실행하도록 안내합니다. 기존 환경을 유지하고 싶은 사람과 2로 전환하려는 사람 모두 업데이트 방식을 확인할 필요가 있습니다.
이번 변경은 v1.19.0 공식 릴리스와 변경 기록에 명시됐습니다. 여기서 중요한 점은 OpenCode 2 자체가 10월 11일 처음 출시됐다는 뜻이 아니라, 1.x에서 2로 이동하는 경로가 이번 버전에 추가됐다는 사실입니다.
OpenCode 1 사용자에게 달라진 점
| 확인할 항목 | v1.19.0에서 확인된 내용 |
|---|---|
| OpenCode 2 전환 | opencode upgrade --major 명령으로 메이저 버전 업그레이드를 시작할 수 있습니다. |
| 터미널 업데이트 | TUI에서 /update를 실행해 업데이트를 설치합니다. 자동 설치는 더 이상 이뤄지지 않습니다. |
| OpenAI 연결 | OpenAI의 ultrafast 서비스 티어를 허용하도록 수정됐습니다. |
| PTY 연결 | PTY 존재 여부를 확인하기 전에 연결 출처와 티켓을 검증하도록 수정됐습니다. |
특히 업데이트를 자동으로 설치해 주던 흐름에 의존했다면 설치 버전이 예상보다 오래 유지될 수 있습니다. 다만 이번 안내는 공식 릴리스에 적힌 동작 변경이며, 모든 사용자의 기존 설치 방식과 관리자 정책까지 동일하게 바뀐다는 의미는 아닙니다.
지금 OpenCode 2로 올리려면
OpenCode 1.x 사용자는 먼저 현재 설치 버전과 사용 중인 플러그인과 외부 연동을 확인하는 것이 좋습니다. v1.19.0을 설치한 뒤 터미널에서 다음 명령으로 메이저 업그레이드를 시작할 수 있습니다. 아래 명령은 사용할 입력 예시이며, 이 기사에서 실제 사용자 PC에 설치해 실행한 결과는 아닙니다.
opencode --version
opencode upgrade --major이미 터미널의 OpenCode 화면을 열어 두었다면 명령 입력창에서 /update를 이용할 수 있습니다. 공식 변경 기록은 이 명령이 일반 업데이트와 OpenCode 2 전환 모두에 사용된다고 설명합니다. 업그레이드를 시작하기 전에는 프로젝트 설정 파일 및 플러그인을 백업하고, 설치 완료 후 버전과 사용하던 연결을 직접 확인해야 합니다.
2로 올리기 전에 확인할 세 가지 호환성
OpenCode 2 공식 마이그레이션 문서는 호환성이 달라지는 영역을 플러그인 API, 서버 API와 클라이언트, 터미널 클라이언트 설정으로 구분합니다. 기존 1.x 플러그인은 파일만 옮겨서는 2에서 실행되지 않으므로, 플러그인 제작자가 2용 버전을 제공하는지 확인해야 합니다. 자체 도구가 예전 OpenCode 서버 API를 호출한다면 해당 연동도 수정해야 합니다.
터미널 클라이언트 설정도 여러 위치의 tui.json 계열 파일에서 전역 ~/.config/opencode/cli.json으로 이동합니다. 공식 문서는 첫 실행 시 지원되는 설정을 자동으로 이전한다고 설명하지만, 프로젝트별 터미널 설정을 그대로 옮기는 것은 아닙니다.
반면 기존 opencode.json 설정과 .opencode/의 에이전트, 명령, 스킬 정의는 지원되는 범위에서 계속 읽을 수 있도록 설계됐습니다. 즉 모든 설정을 처음부터 다시 만들 필요는 없습니다. 다만 문서에서 호환을 의도했다고 밝힌 범위와, 개별 사용자 환경에서 실제 작동한다는 것은 구분해야 합니다.
누가 지금 업데이트해야 할까
기본 AI 코딩 작업만 수행하며 별도의 플러그인이나 자동화 연동이 없는 사용자는 버전을 확인하고 공식 안내에 따라 전환할 수 있습니다. 반대로 플러그인, MCP 서버, 자체 API 도구, 프로젝트별 TUI 설정을 쓰는 팀은 먼저 개발용 프로젝트에서 모델 로그인, 에이전트, 권한, MCP 연결, 플러그인 동작을 점검하는 편이 안전합니다.
이번 릴리스에는 OpenAI ultrafast 티어 지원과 PTY 연결 검증 개선도 포함됐습니다. 다만 ultrafast 사용 가능 여부나 비용이 모든 계정에 똑같이 적용된다는 발표는 아니므로, 실제 이용 조건은 연결한 모델 및 제공업체의 설정에서 따로 확인해야 합니다.
핵심은 OpenCode 2 전환 선택지가 명확해졌고, 1.x의 업데이트 설치는 이제 사용자가 직접 확인해야 한다는 점입니다. 당장 메이저 업그레이드가 필요하지 않더라도 현재 버전과 플러그인 호환 상태부터 확인해 두면 불필요한 작업 중단을 줄일 수 있습니다.
