Devin

Devin (Cognition)

Devin은 Cognition(코그니션)이 개발한 자율 AI 소프트웨어 엔지니어예요. 코드를 작성하고, 실행하고, 테스트하는 일을 스스로 처리해요. 웹 앱(클라우드 세션), Devin CLI(터미널에서 로컬 코딩 에이전트), Devin API(프로그래밍 방식 통합) 등 다양한 방식으로 이용할 수 있어요. 일반적으로 3시간 안에 할 수 있는 작업이라면 Devin이 대부분 처리할 수 있다고 해요.

출처: 문서

본문

Devin이란?

Devin은 자율 AI 소프트웨어 엔지니어로, 코드를 작성·실행·테스트할 수 있어요. 극도로 어려운 작업을 제외한 대부분의 작업을 처리할 수 있는데, 주로 다음과 같은 작업에서 강점을 보여요.

Linear/Jira 티켓 처리, 백로그에 쌓이기 전에 많은 작업을 병렬로 처리
처음부터 완전한 기능 구현, 버그 리포트 대응, 앱 테스트
코드 마이그레이션·리팩터링·현대화 (예: JavaScript → TypeScript, Angular 16 → 18 업그레이드, 모노레포 → 서브모듈 변환)
PR 리뷰, 코드베이스 Q&A, 버그 재현 및 수정, 단위 테스트 작성
문서 유지보수, 내부 도구 구축, 새 API 통합 구축, 프로토타입 제작

Devin을 잘 활용하려면 명확한 완료 기준이 담긴 프롬프트를 작성하고, CI 통과나 배포 검증처럼 결과를 쉽게 확인할 수 있게 만드는 게 좋아요. 어려운 작업은 잘게 나누고 관련 컨텍스트나 예시를 제공하면 성공률이 높아져요.

세션과 Devin 인터페이스

Devin은 대화형 사용자 인터페이스로 설계됐으며, 내장 IDE에서 Devin의 개발 과정을 지켜보고 직접 이어받을 수 있어요. Devin API로도 사용할 수 있어요. Devin의 Workspace에는 작업을 완료하는 데 쓰는 개발 도구가 담겨 있어요.

Shell – Devin의 터미널로, 실행 중인 명령어와 출력 로그를 볼 수 있어요. 셸 출력을 복사해서 디버깅할 수도 있어요. 명령어를 직접 실행하려면 IDE의 셸을 사용해요.
IDE – Devin의 내장 코드 에디터로, 익숙한 IDE 도구와 단축키를 제공해요. Devin의 작업을 실시간으로 지켜보고, 명령어 실행이나 직접 코드 수정, 테스트를 위해 이어받을 수 있어요.
Browser – Devin이 문서를 탐색하거나, 빌드한 웹 앱을 테스트하고, 정보를 다운로드·업로드하는 과정을 지켜볼 수 있어요. Interactive Browser로 브라우징 작업 중 직접 도와줄 수도 있어요.

Devin의 도구는 사이드바나 세션의 진행 단계를 클릭해서 찾을 수 있어요.

Devin 접근하기

Devin에 접근하려면 app.devin.ai에서 가입하면 돼요. Individual 및 Teams 플랜이 있어요. 터미널에서 바로 사용하고 싶다면 Devin CLI를 설치할 수 있어요.

curl -fsSL https://cli.devin.ai/install.sh | bash

Slack이나 Teams 스레드에 Devin을 태그해서 동료와 논의 중인 버그를 맡기거나, 웹 앱에서 복잡한 작업을 위임하고 첫 초안이 나오면 Devin의 IDE에서 이어받을 수도 있어요. 로컬 환경에서 Devin CLI로 빠른 수정·코드 탐색·인터랙티브 코딩을 하다가 /handoff로 긴 작업을 클라우드 Devin에게 넘길 수도 있어요.

Devin CLI

Devin CLI는 터미널에서 바로 실행되는 로컬 코딩 에이전트예요. 로컬 파일과 환경을 직접 다루며, 코드를 작성하는 바로 그 자리에서 빠르고 인터랙티브한 도움을 얻을 수 있어요. 새 기능 구현, 버그 수정, 코드 리뷰, 질문 답변, 작업 자동화 등을 할 수 있어요.

설치 방법은 플랫폼별로 달라요.

macOS / Linux / WSL: curl -fsSL https://cli.devin.ai/install.sh | bash
Homebrew (macOS): brew install --cask devin-cli (업그레이드는 brew upgrade --cask devin-cli)

설치 후 터미널을 재시작하고 프로젝트 디렉터리에서 devin이라고 입력하면 Devin CLI가 시작돼요. 자동화를 위해 세션을 프롬프트와 함께 미리 로드할 수도 있어요.

devin -- check out this code and suggest a feasible, helpful feature

로컬 머신에서 감당하기 어려운 작업이 생기거나, 자리를 비워도 계속 작업하길 원한다면 /handoff 명령으로 클라우드 Devin 세션에 작업을 넘길 수 있어요.

/handoff fix the flaky integration tests in CI

Devin CLI는 대화 컨텍스트와 현재 git 브랜치를 패키징해 클라우드 Devin 세션을 만들고, 이어서 작업을 계속해요. 작업 설명 없이 /handoff를 실행하면 자동으로 중단된 지점에서 이어서 진행돼요. 참고로 Devin CLI는 아직 Devin 계정의 Knowledge, Playbooks, Secrets를 지원하지 않아요.

Devin API

Devin API는 애플리케이션에 Devin을 통합하고 워크플로를 자동화하며 강력한 도구를 만들 수 있게 해주는 REST API예요. **서비스 유저(service user)**와 역할 기반 접근 제어(RBAC)를 사용해 안전하고 감사 가능한 API 접근을 제공해요.

API는 두 가지 스코프로 구성돼요.

Organization API – Base URL: https://api.devin.ai/v3/organizations/* — 세션, 지식, 플레이북, 시크릿 등 단일 조직 내 리소스를 관리해요. 대부분의 통합이 여기서 시작돼요.
Enterprise API – Base URL: https://api.devin.ai/v3/enterprise/* — 분석, 감사 로그, 사용자 관리, 빌링, 인프라 등 조직 간 관리를 담당하며 엔터프라이즈 고객에게 제공돼요.

두 스코프 모두 cog_ 접두사를 가진 서비스 유저 자격증명을 사용해요.

서비스 유저는 사람 사용자와 분리된 정체성이지만, create_as_user_id 파라미터로 조직의 어떤 사용자 대신 세션을 생성할 수 있어요. 그러면 세션이 해당 사용자의 세션 목록에 나타나고 사용량으로 집계돼요.

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Fix the login bug in issue #42",
    "create_as_user_id": "user_abc123"
  }'

API는 표준 HTTP 상태 코드를 사용해요. 200 OK 성공, 201 Created 생성 성공, 400 Bad Request 잘못된 요청, 401 Unauthorized 키 누락·무효, 403 Forbidden 권한 부족, 404 Not Found 리소스 없음, 429 Too Many Requests 요청 한도 초과, 500 Internal Server Error 서버 오류예요.

API 관련 문의나 이슈는 [email protected]로 연락하면 돼요.

더 알아보기 (Learn more)

공식 문서