구글 Jules 사용법:
코딩 에이전트 방치하면 손해
구글 Jules는 GitHub 리포지토리와 직접 연동해 버그 수정·테스트 작성·기능 추가를 혼자서 처리하는 비동기 AI 코딩 에이전트입니다.
CLI 설치 3분이면 터미널에서 Jules를 부릴 수 있고, API로 Slack·CI/CD까지 연결됩니다.
지금 이 에이전트를 모르면 시간을 경쟁자에게 통째로 헌납하는 셈입니다.
🆓 무료 플랜 있음
⚡ CLI + API 지원
🔗 GitHub 직접 연동
🧠 메모리 기능 탑재
구글 Jules가 뭔지 모르면 벌어지는 일
2026년 현재 AI 코딩 에이전트 시장에는 Cursor, GitHub Copilot, Devin, OpenAI Codex 등 수십 개의 도구가 경쟁하고 있습니다.
그 가운데 구글 Jules는 2024년 12월 처음 공개된 이후 2025년 8월 정식 출시, 같은 해 10월 CLI·API 지원까지 추가하며 빠르게 성숙한 도구로 자리 잡았습니다.
Jules의 핵심 가치는 ‘비동기(asynchronous)’ 작동 방식에 있습니다.
사용자가 작업을 지시하면 Jules는 별도의 가상 머신(VM)을 띄워 리포지토리를 클론하고, 의존성을 설치하고, 코드를 수정한 뒤 Pull Request를 날려줍니다.
이 모든 과정이 개발자의 화면 밖에서 돌아갑니다.
즉, 여러분이 다른 기능을 개발하는 동안 Jules는 버그 10개를 동시에 처리하고 있을 수 있습니다.
한국어 콘텐츠 공백이 이토록 큰 이유가 있습니다. Jules는 현재 한국 IP에서 직접 접속이 제한된 상태입니다(jules.google.com은 일부 지역에서 “not available” 메시지를 표시합니다).
하지만 VPN이나 CLI를 통한 우회 접근은 가능하며, Jules API는 전 세계에서 사용 가능합니다.
이 사실을 아는 개발자가 거의 없다는 게 오히려 기회입니다.
Jules가 할 수 있는 것 vs 할 수 없는 것
구글 Jules 사용법을 제대로 익히려면 도구의 경계부터 명확히 이해해야 합니다.
많은 개발자들이 “AI 코딩 도구 = 코드 자동완성”이라는 선입견을 가지고 접근했다가 실망하거나, 반대로 과소평가해서 기회를 놓칩니다.
| 구분 | 가능한 작업 ✅ | 한계 ❌ |
|---|---|---|
| 코드 작업 | 버그 수정, 기능 추가, 리팩토링, 의존성 버전 업그레이드, 테스트 작성 | 실시간 인라인 자동완성 불가 (비동기 방식) |
| 깃 연동 | PR 자동 생성, 새 브랜치 생성, 커밋 메시지 제안 | 기존 PR 직접 머지 불가 (인간 검토 필요) |
| 환경 이해 | 리포지토리 전체 컨텍스트 파악, 파일 선택자로 특정 파일 집중 | 비공개 서버·데이터베이스 직접 접근 불가 |
| 메모리 | 사용자 선호도·교정 내용을 기억해 다음 세션에 자동 적용 | 메모리는 계정 단위, 팀 공유는 별도 설정 필요 |
| 통합 | Slack, Linear, CI/CD 파이프라인과 API로 연동 가능 | 현재 GitHub 외 GitLab·Bitbucket은 미지원 |
개인적으로 Jules가 특히 강력하다고 느끼는 상황은 “지루하지만 반드시 해야 하는 작업”입니다.
예를 들어 오래된 Node.js 프로젝트의 의존성을 전부 최신 버전으로 올리고 깨진 테스트를 고치는 일은 숙련된 개발자도 반나절을 써야 합니다.
Jules에게 맡기면 커피 한 잔 마시는 동안 PR이 올라와 있습니다.
Jules 시작하기: 계정 생성 & GitHub 연동
구글 Jules 사용법의 첫 단계는 웹 콘솔 설정입니다.
한국에서 접속이 막혀 있다면 VPN을 사용하거나, CLI로 바로 진입하는 방법을 사용하면 됩니다.
GitHub 앱 설치 — 콘솔 내 “Connect Repository” 버튼을 눌러 GitHub에 Jules 앱을 설치합니다. 특정 리포지토리만 허용하거나 전체 허용 중 선택 가능합니다.
첫 태스크 생성 — 연결된 리포지토리를 선택하고 자연어로 작업을 지시합니다. 예: “모든 단위 테스트를 Jest로 마이그레이션해 주세요.” Jules는 자동으로 계획(Plan)을 세우고 승인을 기다립니다.
플랜 승인 & PR 확인 — Jules가 생성한 실행 계획을 검토하고 승인하면 VM에서 작업이 시작됩니다. 완료되면 자동으로 Pull Request가 생성됩니다.
주의할 점은 automationMode 설정입니다. 기본값은 PR 자동 생성이 꺼진 상태입니다. 처음에는 기본값으로 시작해 Jules의 코드 품질을 검토한 뒤, 신뢰가 쌓이면 AUTO_CREATE_PR 모드로 전환하는 것을 권장합니다.
Jules CLI(Jules Tools) 설치 & 실전 명령어
2025년 10월 공개된 Jules Tools(Jules CLI)는 터미널에서 Jules를 직접 제어할 수 있는 경량 CLI입니다.
웹 콘솔을 열지 않아도 작업 생성·확인·중단이 모두 터미널 안에서 해결됩니다.
설치
npm install -g @google/jules
설치 후 jules를 실행하면 사용 가이드가 출력됩니다.
핵심 명령어 모음
# 연결된 리포지토리 목록 확인
jules remote list --repo
# 특정 리포지토리에 새 세션(작업) 생성
jules remote new --repo 사용자명/리포명 --session "단위 테스트 작성"
# 진행 중인 태스크 목록 조회
jules remote list --task
# 라이트 테마로 TUI 대시보드 실행
jules --theme light
스크립트 자동화 예시
Jules CLI는 쉘 스크립트와 조합하면 진짜 위력을 발휘합니다. 아래는 TODO.md 파일의 각 줄을 별도 Jules 세션으로 자동 생성하는 예시입니다.
# TODO.md 각 줄을 별도 태스크로 Jules에 할당
cat TODO.md | while IFS= read -r line; do
jules remote new --repo . --session "$line"
done
또한 GitHub CLI(gh)와 조합하면 이슈를 바로 Jules에게 넘길 수 있습니다.
# 내 담당 이슈 중 가장 오래된 것을 Jules에 할당
gh issue list --assignee @me --limit 1 --json title \
| jq -r '.[0].title' \
| jules remote new --repo .
Jules API로 Slack·CI/CD 파이프라인 연동
구글 Jules 사용법의 진짜 깊이는 Jules API에 있습니다.
API를 활용하면 Slack에 버그가 접수되는 순간 Jules가 자동으로 수정을 시작하고, CI/CD 파이프라인의 특정 단계에서 테스트 커버리지를 높이는 작업을 Jules에 위임하는 시나리오가 가능합니다.
인증: API 키 설정
# Jules API 호출 시 헤더에 API 키를 포함합니다
curl 'https://jules.googleapis.com/v1alpha/sources' \
-H 'X-Goog-Api-Key: YOUR_API_KEY'
세션(태스크) 생성
curl 'https://jules.googleapis.com/v1alpha/sessions' \
-X POST \
-H "Content-Type: application/json" \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-d '{
"prompt": "로그인 페이지 XSS 취약점을 수정해 주세요.",
"sourceContext": {
"source": "sources/github/myorg/myrepo",
"githubRepoContext": {
"startingBranch": "main"
}
},
"automationMode": "AUTO_CREATE_PR",
"title": "XSS 수정"
}'
핵심 API 개념 정리
| 리소스 | 설명 | 주요 엔드포인트 |
|---|---|---|
| Source | GitHub 리포지토리 등 입력 소스 | /v1alpha/sources |
| Session | 하나의 작업 단위 (프롬프트 + 소스) | /v1alpha/sessions |
| Activity | 세션 내 세부 작업 로그 | /v1alpha/sessions/{id}/activities |
requirePlanApproval: true 옵션을 설정하면 Jules가 계획을 먼저 제출하고 사람의 승인을 기다립니다.
중요한 프로덕션 환경에서는 이 옵션을 켜두는 것이 필수입니다.
반대로 테스트 환경이나 드래프트 브랜치에서는 완전 자동화 모드를 활용해 개발 속도를 극대화할 수 있습니다.
Gemini CLI + Jules 확장: 터미널 최강 조합
2025년 10월 29일, 구글은 Gemini CLI를 위한 Jules 확장(Extension)을 공개했습니다.
이 조합은 단순히 두 도구를 합친 것 이상입니다. 역할 분담이 명확합니다.
설치 조건 및 방법
# Gemini CLI v0.4.0 이상 설치 필요
# Jules 확장 설치 (--auto-update 옵션 권장)
실제 사용 방법
# Jules에 비동기 작업 지시
/jules CommonJS 모듈을 ES 모듈로 변환해 줘
# 진행 상태 확인
/jules 마지막 작업 상태가 어떻게 됐어?
이 조합의 가장 큰 장점은 멀티태스킹입니다.
두 도구가 서로의 역할을 명확히 나누기 때문에 충돌 없이 병렬로 동작합니다.
💡 Gemini CLI와 Jules CLI의 차이: Gemini CLI는 내가 직접 참여해 대화하며 작업하는 동기(synchronous) 도구입니다. Jules CLI/API는 작업을 던져두고 나는 다른 일을 하는 비동기(asynchronous) 도구입니다. 둘을 함께 쓰면 개발자 한 명이 두 명 분의 작업 처리량을 낼 수 있습니다.
Jules를 200% 쓰는 실무 팁 5가지
구글 Jules 사용법을 익혀도 막상 실무에서 어떻게 쓸지 막막한 경우가 많습니다.
아래 다섯 가지 팁은 실제 개발 현장에서 즉시 적용 가능한 패턴입니다.
파일 선택자(File Selector)로 컨텍스트 좁히기
Jules는 리포지토리 전체를 읽지만, 관련 파일만 명시적으로 지정하면 응답 품질이 올라가고 속도도 빨라집니다. 채팅창에서
@파일명으로 특정 파일을 콕 집어주세요.메모리 기능으로 코딩 스타일 등록하기
Jules는 사용자 교정 내용을 기억합니다. "우리 팀은 세미콜론 없는 스타일을 사용해", "타입스크립트 strict 모드 준수" 등 선호도를 한 번 알려주면 이후 모든 세션에 자동 적용됩니다.
환경 변수 관리 기능 활용
Jules는 태스크 실행 중 필요한 환경 변수를 안전하게 전달받을 수 있습니다. API 키나 데이터베이스 URL 같은 민감 정보를 콘솔의 Environment Variables 메뉴에서 설정하면 Jules가 VM 실행 시 자동 참조합니다.
의존성 업그레이드 배치 처리
TODO.md에 업그레이드할 패키지 목록을 작성하고 CLI 스크립트로 Jules에게 한꺼번에 던지세요. 각 패키지를 별도 브랜치+PR로 처리하므로 충돌 없이 검토할 수 있습니다.
PR 리뷰 댓글을 Jules에 다시 던지기
Jules는 Pull Request 댓글을 이해합니다. 리뷰어가 "이 함수는 순수 함수로 리팩토링해 주세요"라고 댓글을 달면, Jules에게 해당 PR 댓글을 프롬프트로 전달해 수정을 자동화할 수 있습니다.
솔직히 말해서, Jules는 "코딩을 대신해 주는 마법"이 아닙니다.
명확하지 않은 프롬프트를 주면 엉뚱한 PR이 올라오기도 합니다.
하지만 맥락을 명확히 주고 계획을 반드시 검토하는 습관만 들이면, 반복적이고 귀찮은 코딩 작업의 40~60%는 Jules에게 위임할 수 있다고 확신합니다.
Q&A — 자주 묻는 질문 5가지
Q1. 구글 Jules는 완전 무료인가요?
Q2. 한국에서 Jules 웹 콘솔 접속이 안 됩니다. 우회 방법이 있나요?
npm install -g @google/jules)나 Jules API는 지역 제한 없이 사용 가능한 경우가 많습니다. Google Labs Discord 채널에서 최신 지역 지원 현황을 확인할 수 있습니다.
Q3. Jules와 GitHub Copilot의 가장 큰 차이점은 무엇인가요?
Q4. Jules가 생성한 코드의 품질은 믿을 수 있나요?
requirePlanApproval: true 설정을 활용해 Jules의 실행 계획을 먼저 확인하는 습관을 들이는 것이 중요합니다. 특히 프로덕션 영향이 큰 작업은 드래프트 브랜치에서 먼저 테스트하세요.
Q5. GitLab이나 Bitbucket도 지원하나요?
마치며 — AI 코딩 에이전트 시대, 당신의 포지션은?
구글 Jules 사용법을 정리하다 보니 결국 하나의 질문으로 귀결됩니다. "AI 에이전트를 부리는 사람이 될 것인가, 아니면 AI 에이전트와 경쟁하는 사람이 될 것인가?"
Jules는 아직 완벽하지 않습니다. 한국 지역 접근 제한, GitHub 외 플랫폼 미지원, 복잡한 멀티 리포 프로젝트에서의 한계 등 분명한 약점이 있습니다. 그러나 비동기 에이전트라는 개념 자체가 개발자의 시간 활용 방식을 근본적으로 바꿉니다. "코딩하는 동안 다른 코딩도 동시에 진행된다"는 발상은 1년 전만 해도 SF였습니다.
지금 당장 npm install -g @google/jules 한 줄로 시작해 보세요. 처음엔 의존성 버전 업그레이드 같은 단순 반복 작업부터 맡겨보고, 신뢰가 쌓이면 점점 복잡한 작업을 위임하는 방식이 가장 안전합니다. Jules가 여러분의 두 번째 손이 되는 그 순간, 개발 속도가 확실히 달라질 것입니다.
※ 본 포스팅은 공개된 공식 문서와 개발자 블로그를 기반으로 작성되었으며, Google Jules의 요금·기능·지역 지원 현황은 서비스 정책에 따라 예고 없이 변경될 수 있습니다.
실제 도입 전 반드시 공식 문서를 최종 확인하세요.
이 글은 특정 서비스의 투자·구매를 권유하지 않습니다.

댓글 남기기