Devin AI 소프트웨어 엔지니어 설치 및 설정 가이드 (2026) - 워크스페이스부터 GitHub 연동까지
Devin AI 소프트웨어 엔지니어 완벽 설정 가이드
Devin은 Cognition AI가 개발한 세계 최초의 자율형 AI 소프트웨어 엔지니어입니다. 코드 작성, 디버깅, 배포까지 전체 소프트웨어 개발 워크플로우를 독립적으로 수행할 수 있습니다. 이 가이드에서는 팀 워크스페이스 생성부터 첫 번째 코딩 태스크 할당까지 전 과정을 단계별로 안내합니다.
사전 요구사항
- Cognition AI 계정 (Teams 또는 Enterprise 플랜)- GitHub 또는 GitLab 조직 관리자 권한- Slack 워크스페이스 관리자 권한 (선택사항)- Node.js 18+ 또는 Python 3.10+ 개발 환경
1단계: 팀 워크스페이스 생성
Devin 대시보드에 로그인한 후 팀 워크스페이스를 생성합니다.
- app.devin.ai에 접속하여 로그인합니다.- 좌측 사이드바에서 Settings → Workspace를 클릭합니다.- Create New Workspace를 선택하고 워크스페이스 이름을 입력합니다.- 팀 멤버를 이메일로 초대합니다.
# Devin CLI 설치 npm install -g @cognition-ai/devin-cli
인증 설정
devin auth login —token YOUR_API_KEY
워크스페이스 생성 (CLI)
devin workspace create —name “my-dev-team” —plan teams
팀 멤버 초대
devin workspace invite —email teammate@company.com —role developer
2단계: GitHub 리포지토리 연동
Devin이 코드를 읽고, 브랜치를 생성하고, PR을 작성하려면 GitHub 연동이 필수입니다.
- Devin 대시보드에서 **Settings → Integrations → GitHub**로 이동합니다.- **Connect GitHub** 버튼을 클릭하여 OAuth 인증을 완료합니다.- Devin이 접근할 리포지토리를 선택합니다.- 권한 범위를 설정합니다 (읽기/쓰기, PR 생성, 이슈 관리).# GitHub 연동 (CLI 방식)
devin integration add github \
--org your-github-org \
--token ghp_YOUR_GITHUB_TOKEN \
--repos "repo-a,repo-b,repo-c"
연동 상태 확인
devin integration status github
특정 리포지토리 접근 권한 확인
devin integration verify —provider github —repo your-github-org/repo-a
GitHub App 설치 (권장)
개인 토큰 대신 GitHub App을 사용하면 보다 세밀한 권한 관리가 가능합니다.
# GitHub App 방식 연동
devin integration add github-app \
--installation-id YOUR_INSTALLATION_ID \
--app-id YOUR_APP_ID \
--private-key-path ./devin-github-app.pem
## 3단계: Slack 알림 설정
Devin의 작업 진행 상황을 Slack으로 실시간 알림 받을 수 있습니다.
- **Settings → Integrations → Slack**에서 **Add to Slack**을 클릭합니다.- 알림을 받을 Slack 채널을 선택합니다.- 알림 유형을 설정합니다 (태스크 시작, 완료, PR 생성, 오류 발생 등).# Slack Webhook 연동
devin integration add slack \
--webhook-url https://hooks.slack.com/services/YOUR/WEBHOOK/URL \
--channel "#devin-notifications"
알림 규칙 설정
devin notification create
—event task.completed
—channel “#devin-notifications”
—mention “@dev-team”
devin notification create
—event task.failed
—channel “#devin-alerts”
—mention “@oncall”
4단계: 환경 설정 및 시크릿 관리
Devin이 프로젝트를 빌드하고 테스트하려면 환경 변수와 시크릿이 필요합니다.
# 환경 변수 등록
devin secrets set --name DATABASE_URL --value "postgresql://user:pass@host:5432/db"
devin secrets set --name REDIS_URL --value "redis://localhost:6379"
.env 파일에서 일괄 등록
devin secrets import —file .env —workspace my-dev-team
등록된 시크릿 목록 확인 (값은 마스킹됨)
devin secrets list
5단계: 첫 번째 코딩 태스크 할당
모든 설정이 완료되면 Devin에게 첫 번째 태스크를 할당할 수 있습니다.
대시보드에서 태스크 생성
- Devin 대시보드에서 New Session을 클릭합니다.- 연동된 리포지토리를 선택합니다.- 태스크 설명을 자연어로 입력합니다.- Devin이 계획을 수립하면 검토 후 승인합니다.
CLI로 태스크 생성
# 기본 태스크 생성
devin task create
—repo your-github-org/repo-a
—description “users 테이블에 email_verified 칼럼을 추가하고 마이그레이션을 작성해주세요.
기존 사용자는 모두 email_verified=true로 설정합니다.”
—branch feature/add-email-verified
태스크 진행 상황 모니터링
devin task watch —id task_abc123
GitHub 이슈 기반 태스크 할당
devin task create
—from-issue your-github-org/repo-a#42
—auto-pr true
Slack에서 직접 태스크 할당
# Slack 채널에서 Devin 멘션
@Devin repo-a에서 /api/users 엔드포인트의 응답 시간이 느립니다.
N+1 쿼리 문제를 찾아서 수정해주세요.워크플로우 설정 파일
프로젝트 루트에 devin.config.json 파일을 생성하면 Devin의 동작을 세밀하게 제어할 수 있습니다.
{
"version": "1.0",
"repository": {
"defaultBranch": "main",
"branchPrefix": "devin/",
"autoCreatePR": true,
"requireReview": true
},
"environment": {
"language": "python",
"setupCommands": [
"pip install -r requirements.txt",
"python manage.py migrate"
],
"testCommand": "pytest --tb=short"
},
"constraints": {
"maxFilesChanged": 15,
"forbiddenPaths": ["config/production.yml", ".env"],
"requiredTests": true
}
}
## Pro Tips: 파워 유저를 위한 고급 팁
| 팁 | 설명 |
|---|---|
| **Knowledge Base 활용** | devin knowledge add --file ARCHITECTURE.md로 프로젝트 아키텍처 문서를 등록하면 Devin이 코드 컨텍스트를 더 정확하게 이해합니다. |
| **Playbook 작성** | 반복적인 태스크 패턴을 Playbook으로 저장하면 매번 상세한 설명 없이도 일관된 결과물을 얻을 수 있습니다. |
| **스냅샷 리뷰** | Devin의 작업 중간에 스냅샷을 확인하여 방향이 맞는지 조기에 피드백할 수 있습니다. devin task snapshot --id task_abc123 |
| **병렬 세션** | Teams 플랜에서는 최대 5개 세션을 동시에 실행할 수 있습니다. 독립적인 태스크를 병렬로 처리하세요. |
| **CI 연동** | Devin이 생성한 PR에 대해 기존 CI 파이프라인이 자동 실행되도록 설정하면 품질을 보장할 수 있습니다. |
| 문제 | 원인 | 해결 방법 |
|---|---|---|
Authentication failed | API 토큰 만료 또는 잘못된 토큰 | devin auth refresh 실행 또는 대시보드에서 새 토큰 발급 |
Repository access denied | GitHub 연동 권한 부족 | GitHub App 설치 확인 또는 devin integration verify --provider github 실행 |
Task stuck in planning | 태스크 설명이 모호하거나 리포지토리 접근 실패 | 태스크 설명을 구체적으로 수정하고 devin task retry --id task_abc123 실행 |
Build environment error | 의존성 설치 실패 | devin.config.json의 setupCommands를 확인하고 시크릿 변수 누락 여부 점검 |
Slack notifications not arriving | Webhook URL 오류 또는 채널 권한 | devin integration test slack으로 연결 테스트 후 Webhook URL 재설정 |
Q1: Devin AI는 무료로 사용할 수 있나요?
Devin은 제한된 무료 체험을 제공하며, 본격적인 팀 활용을 위해서는 Teams 플랜(월 $500부터) 이상의 구독이 필요합니다. Teams 플랜에서는 동시 세션 최대 5개, 무제한 태스크 생성, GitHub/GitLab/Slack 연동 등 핵심 기능을 모두 사용할 수 있습니다. Enterprise 플랜은 SSO, 감사 로그, 전용 인프라 등 추가 보안 기능을 포함합니다.
Q2: Devin이 기존 코드베이스를 손상시킬 위험은 없나요?
Devin은 항상 별도의 브랜치에서 작업하며, 직접 main 브랜치에 푸시하지 않습니다. devin.config.json에서 requireReview: true를 설정하면 모든 변경사항이 PR을 통해 팀 리뷰를 거치게 됩니다. 또한 forbiddenPaths로 민감한 설정 파일의 수정을 원천 차단하고, maxFilesChanged로 한 번에 변경하는 파일 수를 제한할 수 있습니다.
Q3: Devin에게 어떤 종류의 태스크를 맡기는 것이 가장 효과적인가요?
Devin은 명확한 요구사항이 있는 태스크에서 가장 뛰어난 성능을 보입니다. 버그 수정(이슈 번호와 재현 단계 제공), CRUD API 엔드포인트 추가, 데이터베이스 마이그레이션 작성, 테스트 코드 작성, 리팩토링, 의존성 업데이트 등이 적합합니다. 반면 아키텍처 설계 변경이나 모호한 제품 요구사항의 해석이 필요한 태스크는 사람이 방향을 먼저 정한 뒤 구현을 Devin에게 위임하는 것이 효과적입니다.