Google Jules 종료: 데이터 내보내기와 에이전트 이전

Google Jules 데이터를 지금 내보내고, 마지막 코딩 세션을 마친 뒤 다시 내보냅니다. 2026-11-01 기준 Google은 2026년 11월 11일까지 세션을 마무리할 수 있으며, 이후에는 연말까지 읽기 전용으로 제공한다고 안내합니다. 공식 종료 공지에 따르면 Jules는 2026년 12월 31일에 종료됩니다.

이전은 두 단계로 진행합니다. 먼저 Jules에 저장된 데이터를 보관하고, 새 도구에서 실제 작업 하나를 다시 수행할 수 있도록 준비합니다. 저장소만으로는 두 번째 단계에 필요한 메모리, 환경 설정, 세션 기록을 모두 확보할 수 없습니다. 여기서 메모리는 Jules가 저장한 프로젝트 지식입니다. 코드와 함께 옮길 빌드 방법이나 작업 규칙을 검토하는 데 사용합니다.

읽기 전용으로 바뀌기 전에 무엇을 마쳐야 하나요?

진행 중인 작업을 마무리하고 유용한 변경 사항을 11월 11일 전에 보관합니다. Google 공지는 해당 날짜 이후 Jules가 읽기 전용으로 바뀐다고 설명합니다. 정확한 전환 시각이나 시간대는 명시하지 않습니다.

공지에는 읽기 전용 기간 내내 내보내기 엔드포인트를 사용할 수 있다는 보장도 없습니다. 따라서 11월 11일 전에 내보내기를 권하는 것은 여유를 두고 데이터를 보관하기 위한 판단입니다. Google이 별도의 내보내기 마감일을 발표한 것은 아닙니다.

이미 GitHub에 있는 코드, 브랜치, 풀 리퀘스트는 그대로 남습니다. 미완료 세션을 검토하고 필요한 변경 사항은 적절한 위치에 반영합니다. 아직 브랜치에 반영하지 않은 작업은 내보낸 패치로 보관합니다.

Google은 Jules에서 얻은 경험을 Antigravity 개발에 활용한다고 설명합니다. 이 설명에는 구체적인 이전 절차가 없으며, Jules 설정의 자동 이전도 보장하지 않습니다.

Jules 데이터는 어떻게 내보내나요?

로컬 CLI 코딩 에이전트에 Google의 전체 내보내기 프롬프트를 전달합니다. 이 프롬프트에는 계정 설정, 저장소 정보, 세션 기록을 가져오는 Python 스크립트가 포함되어 있습니다.

CLI와 비공개 저장 위치 준비

아래 명령은 macOS 또는 Linux의 Bash에서 실행합니다. Node.js와 npm, Python, 설치된 CLI 코딩 에이전트가 필요합니다.

먼저 필요한 도구의 버전을 확인합니다.

node --version
npm --version
python3 --version

공개된 스크립트에는 Python 3.9 이상을 사용합니다. 스크립트에서 str.removeprefix를 사용하기 때문입니다. Python 문서에 따르면 이 메서드는 Python 3.9에 추가되었습니다. 이는 스크립트에서 사용하는 기능을 기준으로 판단한 조건이며, Jules CLI 자체의 최소 버전을 뜻하지 않습니다.

Jules Tools를 설치하고 로그인한 뒤 저장소 목록을 확인합니다.

npm install -g @google/jules
jules login
jules remote list --repo

브라우저 로그인은 직접 완료합니다. 내보낼 Jules 데이터가 있는 Google 계정을 사용합니다. 마지막 명령을 실행하면 해당 계정에 연결된 저장소가 나와야 합니다.

필요한 저장소가 없다면 내보내기 전에 연결 문제부터 해결합니다. GitHub의 Google Labs Jules 설치 페이지에서 연결 상태와 저장소 접근 권한을 확인합니다.

홈 디렉터리로 이동한 뒤 접근을 제한한 내보내기 디렉터리를 만듭니다.

cd "$HOME"
umask 077
mkdir -m 700 "$HOME/jules-export"

같은 디렉터리가 이미 있으면 진행을 멈추고 기존 보관 폴더의 이름을 바꿉니다. 이전 백업도 비공개로 유지합니다. 마지막 내보내기에는 새 저장 위치를 사용합니다.

같은 셸에서 설치된 코딩 에이전트를 시작합니다. Claude Code를 사용한다면 claude를 실행합니다. 설치나 인증이 필요하면 빠른 시작 가이드를 따릅니다.

공식 프롬프트 전체 실행

종료 공지에서 Show the export prompt를 펼칩니다. Python 스크립트를 포함한 프롬프트 전체를 복사해 CLI 에이전트에 붙여 넣습니다.

Linux에서는 전달하기 전에 프롬프트의 별도 사전 점검 명령인 secret-tool lookup을 삭제합니다. 이 명령은 저장된 비밀 값을 표준 출력으로 내보냅니다. 해당 동작은 libsecret 구현에서 확인할 수 있습니다. 에이전트에는 Jules CLI 점검을 이미 완료했다고 알립니다.

인증 정보를 읽는 작업은 내보내기 스크립트 내부에 남겨 둡니다. 에이전트에게 접근 토큰이나 env-variables.json의 값을 화면에 표시하도록 요청하지 않습니다.

에이전트가 공식 스크립트를 저장하고 홈 디렉터리에서 실행하게 합니다. 완료되면 출력된 항목 수, 오류, 전체 저장 경로를 요청합니다. 문서에 나온 저장 위치는 ~/jules-export입니다.

보관 데이터를 사용하기 전에 확인

최종 성공 메시지만 보지 말고 error_count와 필요한 파일을 확인합니다. 스크립트의 sessions 값은 목록에 있는 세션 수입니다. 개별 다운로드에 실패한 세션도 이 합계에 포함됩니다. 따라서 세션 수가 예상과 같아도 모든 세션 파일이 저장되었다고 판단할 수는 없습니다.

내보내기는 다음 자료를 보관하도록 설계되어 있습니다.

자료	확인 위치	다음 작업
계정 설정, 환경 변수, 예약 작업	env-variables.json을 포함한 계정 JSON 파일	새 도구에서 필요한 설정과 비밀 값을 다시 구성합니다
연결된 저장소	sources.json	예상한 저장소 목록과 비교합니다
저장소 메모리, 환경 준비 스크립트, 테스트 명령	해당 기록이 있는 저장소별 폴더	사용 전에 검토하고 새 환경에 맞게 수정합니다
세션 프롬프트, 계획, 활동 기록, 패치	읽기 쉬운 summary.md를 포함한 세션별 폴더	기록을 보관하고 미완료 작업을 복구합니다

error_count가 0인지 확인한 뒤 오래된 세션과 최근 세션을 각각 골라 살펴봅니다. 가장 중요한 미완료 세션은 별도로 확인합니다. 해당 세션의 프롬프트, 계획, 활동 기록, 예상한 패치가 모두 있어야 합니다.

환경 준비 스크립트와 테스트 명령은 세션 출력의 메타데이터에서 복원됩니다. 필요한 setup.sh가 없다면 Jules에 접근할 수 있을 때 저장소 설정을 확인합니다.

내보낸 폴더는 설정과 작업 기록을 보관하는 자료로 취급합니다. GitHub 저장소는 별도로 보관합니다. env-variables.json에는 실제 환경 변수 값이 들어 있으므로 폴더 전체를 저장소 밖에 둡니다.

내보내기 오류는 어떻게 구분하나요?

모든 호출이 실패하면 Google 인증을 갱신합니다. 저장소 조회만 실패하면 GitHub 접근 권한을 확인합니다. Google의 문제 해결 안내에서도 두 경우를 구분합니다.

증상	가능한 원인 또는 문서에 명시된 조건	해결 및 확인
모든 내보내기 호출이 401을 반환합니다	접근 토큰이 만료되었을 수 있습니다. Google에 따르면 로그인 후 약 한 시간 동안 유효합니다.	Jules 명령을 실행하거나 jules login으로 다시 로그인합니다. 저장소 조회를 다시 확인한 뒤 내보내기를 재실행합니다.
ListSources가 401과 missing required authentication credential을 반환하지만 다른 호출은 작동합니다	Google은 이 조합을 GitHub 연결이 없는 경우로 설명합니다.	GitHub를 연결하고 저장소 접근 권한을 확인한 뒤 jules remote list --repo를 다시 실행합니다.
예상한 저장소가 없습니다	연결한 계정 또는 선택한 저장소의 접근 권한을 확인해야 합니다.	올바른 Google 계정과 GitHub 앱 설치를 확인합니다. 다시 내보낸 뒤 sources.json을 살펴봅니다.
내보내기 엔드포인트가 404 또는 400을 반환합니다	내보내기 스크립트는 문서화되지 않은 내부 엔드포인트를 사용합니다.	실패한 호출과 상태 코드를 기록합니다. 재시도 전에 현재 공식 프롬프트를 확인하며, 대체 엔드포인트를 추측하지 않습니다.

Jules에서 GitHub 저장소를 한 번도 사용하지 않았다면 Google 프롬프트에 따라 연결을 생략할 수 있습니다. 이 경우 내보낸 자료에 저장소 데이터가 포함되지 않습니다. 저장소 데이터가 필요하다면 연결을 완료하고 저장소 조회를 다시 확인한 뒤 내보냅니다.

메모리와 환경 준비 절차를 새 에이전트로 이전

오래 사용할 프로젝트 지식과 재현 가능한 환경 준비 절차부터 옮깁니다. 전체 세션 기록은 나중에 참고할 수 있도록 보관합니다.

유용한 메모리를 프로젝트 지침으로 정리

각 저장소의 메모리를 현재 코드와 대조합니다. 유효한 빌드 명령, 아키텍처 제약, 반복되는 문제의 해결책은 남깁니다. 오래된 조언, 중복 규칙, 비밀 값은 제거합니다.

공통 지침은 저장소 루트의 AGENTS.md에 넣습니다. Codex는 이 파일을 읽으며, OpenCode 2도 프로젝트 지침으로 사용합니다. OpenCode 2는 CLAUDE.md를 대체 파일로 사용하지 않습니다.

package-lock.json이 있고 npm test가 정상적으로 구현된 npm 프로젝트라면 다음과 같이 작성할 수 있습니다.

- Install dependencies with `npm ci`.
- Run `npm test` after code changes.
- Keep generated files out of manual edits.
- Report failing checks and unresolved setup requirements.

이 예시는 의존성 설치, 변경 후 테스트, 생성 파일의 수동 편집 제한, 실패한 검사와 미해결 환경 문제의 보고를 지시합니다. 검토한 지침은 기존 파일에 병합합니다. 기존 지침을 통째로 덮어쓰지 않습니다.

Claude Code에서는 저장소 루트의 CLAUDE.md에 다음 가져오기 구문을 추가합니다. 이미 있는 Claude 전용 지침은 유지합니다.

@AGENTS.md

이 구문은 공통 지침 파일을 가져옵니다. Claude의 메모리 문서에서 이 구성을 안내합니다. 새 세션에서 /context를 실행하고 Memory files 항목에 CLAUDE.md가 나타나는지 확인합니다.

파일 수정을 허용하기 전에 에이전트에게 필요한 환경 준비 명령과 테스트 명령을 찾아 설명하게 합니다. 이를 통해 이전한 지침을 실제로 활용하는지 확인합니다. 장기적인 관리 방식은 코딩 에이전트의 메모리 구성 안내를 참고합니다.

실행 환경 다시 구성

내보낸 환경 준비 스크립트를 새 도구의 런타임과 실행 단계에 맞게 수정합니다. 실행 전에 작업 디렉터리, 런타임 버전, 패키지 레지스트리, 비밀 값 접근 방식, 필요한 서비스를 검토합니다.

Claude Code 클라우드 세션에서는 환경 편집기를 열고 Setup script를 선택합니다. Choose file로 검토한 스크립트를 불러옵니다. 클라우드 환경 가이드에 준비 단계가 설명되어 있습니다. 이 스크립트를 실행하는 동안에는 세션에 설정한 환경 변수가 아직 적용되지 않습니다. Jules와 같은 시점에 변수에 접근할 수 있다고 가정하지 않습니다.

Codex Cloud에서는 현재 클라우드 환경 가이드에 따라 GitHub 저장소용 환경을 만듭니다. 검토한 설치 명령과 테스트 명령을 지정합니다. 의존성에는 Install script, 서비스 시작에는 Start skill을 사용합니다. 준비된 환경을 검토하고 게시한 뒤 새 작업을 시작합니다.

로컬 Claude Code 또는 OpenCode에서는 필요한 환경을 로컬 시스템이나 개발용 컨테이너인 devcontainer에 다시 구성합니다. 검토한 설치 명령을 .devcontainer/setup.sh에 저장하는 방법이 있습니다. 기존 .devcontainer/devcontainer.json에서 postCreateCommand를 bash .devcontainer/setup.sh로 설정합니다. 이 명령이 실행되는 시점은 Development Containers 참조 문서에 정의되어 있습니다.

비밀 값은 새 환경의 비밀 값 설정 기능을 통해 옮깁니다. env-variables.json을 프로젝트 지침에 복사하거나 환경 준비 스크립트와 함께 커밋하지 않습니다.

마지막으로 새 환경에서 복원한 테스트 명령을 실행합니다. 환경 준비 오류를 먼저 해결한 뒤 에이전트에게 애플리케이션 코드 변경을 요청합니다.

예약 작업은 수동 실행을 확인한 뒤 다시 구성

내보낸 프롬프트와 일정을 바탕으로 반복 작업을 다시 만듭니다. 저장소, 대상 브랜치, 시간대, 환경 요구 사항, 예상 결과를 그대로 유지합니다.

Claude Code의 클라우드 예약 작업은 2026-11-01 기준 연구용 프리뷰인 research preview 상태입니다. Pro, Max, Ultra, Team, Enterprise 플랜에서 제공되며 조직의 관리 설정이 적용됩니다.

Claude 예약 작업 페이지에서 New task를 선택합니다. 일부 계정에서는 New routine으로 표시됩니다. 프롬프트를 입력하고 저장소와 클라우드 환경을 선택한 뒤 일정을 설정합니다. 예약 작업 가이드에 따라 Run now를 실행하고 History에서 결과를 확인합니다.

Codex 관련 로컬 작업에는 ChatGPT 데스크톱 앱의 Scheduled를 사용합니다. 현재 예약 기능 문서에 따르면 로컬 파일이 필요한 작업은 컴퓨터와 앱이 계속 실행 중이어야 합니다. Codex CLI에는 Scheduled 관리 인터페이스가 없습니다. 이 조건은 Codex Cloud의 호스팅 실행과 구분합니다. 로컬 파일을 사용하는 예약 작업에는 컴퓨터와 앱의 실행 상태도 필요합니다. 클라우드에서 독립적으로 계속되는 작업과 같은 방식으로 운영한다고 가정하지 않습니다.

OpenCode 2의 공식 CI 예제는 독립 실행 모드를 사용하며, 공급자 인증 정보를 CI 비밀 값으로 전달합니다. OpenCode 2와 사용할 공급자 및 모델을 설정한 뒤 다음 명령으로 먼저 확인할 수 있습니다.

opencode run --standalone "Read AGENTS.md and identify the setup and test commands. Do not edit files."

이 명령은 파일을 수정하지 않고 AGENTS.md를 읽어 환경 준비 명령과 테스트 명령을 찾도록 요청합니다. 응답은 워크플로 출력에서 확인합니다. GitHub Actions에서는 먼저 workflow_dispatch로 수동 실행한 뒤 schedule 트리거를 추가합니다. 두 이벤트는 GitHub 워크플로 이벤트 참조에 설명되어 있습니다. 예약 워크플로는 기본 브랜치에서 실행됩니다.

무인 편집을 허용하기 전에 OpenCode 2의 권한 변경 사항을 검토합니다. 필요한 작업이 예상치 못한 대화형 확인 요청으로 멈추지 않는지 확인합니다.

새 작업이 검사를 통과하면 이전 반복 작업을 비활성화합니다. 같은 작업에 두 일정을 동시에 적용하지 않습니다. 초기 몇 차례 실행에서 중복 변경, 반복 오류, 예상치 못한 사용량을 확인합니다.

Jules 대체 도구는 어떻게 선택하나요?

노트북을 닫은 뒤에도 작업을 계속해야 한다면 호스팅 에이전트부터 검토합니다. 관리형 인터페이스보다 실행 환경과 모델 공급자에 대한 통제가 중요하다면 CI 방식을 선택합니다.

다음 권장 사항은 2026-11-01 기준 문서에 나온 기능을 바탕으로 합니다.

필요한 기능	먼저 시도할 도구	선택을 바꿔야 할 조건
재사용 가능한 환경에서 실행하는 호스팅 저장소 작업	Codex Cloud	호스팅 환경이 필요한 서비스에 접근하지 못하거나 빌드를 재현하지 못하면 직접 관리하는 실행 머신을 검토합니다
서비스에서 관리하는 반복 코딩 작업	Claude Code 클라우드 세션과 클라우드 예약 작업	프리뷰 이용 조건이나 조직 정책 때문에 예약할 수 없다면 승인된 CI 방식을 사용합니다
모델 접근과 실행 방식에 대한 통제	직접 관리하는 CI 실행 머신의 OpenCode 2	워크플로 설정, 인증 정보, 권한을 유지 관리하고 싶지 않다면 호스팅 에이전트를 선택합니다
기존 Google 개발 환경 머신에 대한 원격 접근	Antigravity Remote Control	문서에 나온 백그라운드 프로세스는 호스트 머신이 켜져 있어야 합니다. 이 조건이 맞지 않으면 호스팅 실행을 선택합니다

문서에 나온 Antigravity Remote Control은 사용자의 머신에서 실행됩니다. Google의 제품 방향을 Jules 호스팅 환경의 대체 수단으로 받아들이기 전에 실제 실행 방식이 요구 사항에 맞는지 판단합니다.

CLI를 사용한다면 BetterToken의 Claude Code와 OpenCode API 연결 안내를 참고할 수 있습니다. 모델 API 접근은 각 도구의 계정, 호스팅 실행, 예약 기능에 필요한 조건과 별도로 판단합니다. API 연결이 해당 도구의 웹 계정이나 클라우드 예약 기능에 대한 이용 권한까지 제공한다는 의미는 아닙니다.

비용은 같은 시험 작업으로 비교합니다. 선택한 방식에 필요한 모델 사용료, 필수 구독료, 실행 머신 비용을 모두 포함합니다. 내보내기에 성공했다는 사실만으로 가장 저렴한 대체 도구를 정할 수는 없습니다.

이전을 마치기 전에 작업 하나를 검증

범위가 작고 예상 결과가 분명한 변경 작업을 선택합니다. 대체 도구를 평가할 때 저장소 리비전, 환경 준비 요구 사항, 테스트 명령을 동일하게 유지합니다.

에이전트가 지침을 읽고 환경을 준비하며 작업을 완료한 뒤 검토할 수 있는 결과를 남기는지 확인합니다. 호스팅 작업은 로컬 세션이 없어도 계속 실행되는지 확인합니다. 예약 작업은 수동 시험 이후 실제 예약 실행 결과도 살펴봅니다.

에이전트 작업 완료 점검표를 사용해 변경 사항과 테스트 결과를 원본 기록이 있는 시스템에서 검증합니다.

마지막 Jules 세션을 마친 뒤 새로 내보내고 다시 확인합니다. 비공개 보관 자료, 검토한 프로젝트 지침, 새 도구의 작업 검증 자료를 이전 기록으로 함께 보관합니다.