rdev에는 준비된 AI 에이전트 프로필이 포함되어 있어, 에이전트가 첫날부터 환경이 어떻게 동작하는지 알고 있습니다.
지원하는 에이전트
| 에이전트 | 지원 수준 |
|---|---|
| Claude Code | 전체 |
| Codex | 전체 |
| opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI | 전체 |
| Cursor CLI, Antigravity CLI | 표준 |
AGENTS.md를 읽고 MCP를 사용하는 다른 에이전트 |
표준, 직접 설치 |
전체 지원은 설치 프로그램, 프로필, 관리형 설정, 알림, 세션 상태, 업데이트가 해당 에이전트에 적용된다는 뜻입니다. 표준 지원은 에이전트 전용 부가 기능 없이 공통 규칙과 MCP 접근이 제공된다는 뜻입니다. 패널의 에이전트 탭에서 각 에이전트 옆에 지원 수준을 확인할 수 있습니다.
에이전트 설치
사이드바의 서버에서 서버를 열고 에이전트를 선택하세요. AI 에이전트 카드에는 rdev가 알고 있는 모든 에이전트와 설치 여부, 버전, 시작 명령어가 표시됩니다(옆의 버튼으로 복사). 설치는 에이전트를 추가하고, ⋯ 메뉴는 에이전트를 업데이트하거나 제거합니다. Codex는 환경 이미지의 일부이므로 제거할 수 없습니다. 변경 사항은 서버에서 실행되며 몇 초에서 1분 정도 걸리고, 완료되면 카드에 결과가 표시됩니다.
에이전트는 환경별로 관리됩니다. Team 요금제에서는 멤버가 각자의 환경에 쓸 에이전트를 직접 선택하며, 하나를 설치해도 다른 사람의 환경은 바뀌지 않습니다. 이 기능에는 rdev 0.2.0-beta.36 이상이 필요하며, 서버가 해당 버전을 실행할 때까지 카드에서 업데이트하라고 안내합니다.
에이전트 업데이트
에이전트는 서버에서 스스로 업데이트하지 않으며, 에이전트 안에서 "업데이트가 설치되었습니다. 다시 시작하세요" 알림을 볼 일도 없습니다. ⋯ 메뉴나 rdev agents update(에이전트 하나: rdev agents update claude)로 업데이트하세요. 버전이 바뀌면 rdev가 그 에이전트의 유휴 세션을 모두 새 버전으로 다시 엽니다. 같은 터미널 창, 같은 대화에서 기록도 그대로입니다. 에이전트가 작업 중이거나 답변을 기다리는 세션은 절대 중단되지 않으며, 다시 시작할 때까지 이전 버전을 유지합니다. Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI 세션은 다시 열리고, Cursor CLI와 Antigravity CLI 세션은 다시 시작할 때까지 이전 버전으로 계속 실행됩니다. rdev 1.1.5 이상이 필요합니다.
다른 모델: 제공업체 키와 바로가기
에이전트는 다른 제공업체의 모델로도 실행할 수 있습니다. 같은 탭의 모델 제공업체 키에서 키 추가는 Anthropic, OpenAI, Google Gemini, DeepSeek, Kimi (Moonshot), GLM (Z.ai), MiniMax, Qwen (Alibaba), OpenRouter, Groq, xAI, Mistral의 API 키를 저장합니다. Ollama는 키 대신 Ollama 서버의 주소(http://… 또는 https://…)를 입력합니다. 키는 브라우저에서 이 서버용으로 암호화됩니다. 패널은 키를 볼 수 없고 다시 표시할 수도 없으며, 어떤 제공업체에 키가 있는지만 알고 있습니다. 이미 키가 있는 제공업체의 키를 추가하면 기존 키가 교체됩니다.
키를 설정하면 준비된 바로가기로 프로젝트에서 해당 제공업체의 모델로 에이전트를 시작할 수 있습니다.
| 바로가기 | 제공업체 |
|---|---|
claude-deepseek, claude-kimi, claude-glm, claude-minimax, claude-qwen |
DeepSeek, Kimi, GLM, MiniMax, Qwen 모델 기반 Claude Code |
codex-deepseek, codex-openrouter, codex-groq, codex-xai, codex-ollama |
DeepSeek, OpenRouter, Groq, xAI, Ollama 모델 기반 Codex |
qwen-<provider> (예: qwen-openrouter) |
다른 제공업체의 모델 기반 Qwen Code |
카드에는 키로 사용 가능해진 바로가기가 표시됩니다. Claude 이외의 모델과 함께 쓰는 Claude Code는 Anthropic에서 공식 지원하지 않습니다. 대부분의 작업에는 동작하지만 일부 기능이 다르게 동작할 수 있습니다.
공통 규칙
모든 에이전트가 따르는 규칙은 AGENTS.md 한 곳에 있습니다. Codex, Gemini CLI, opencode는 이 파일을 직접 읽고, Claude Code는 자체 CLAUDE.md에서 포함합니다. Claude Code 스킬과 훅 같은 에이전트별 부분은 이 공통 규칙 위에 얹힙니다.
프로필을 얼마나 받는지는 요금제에 따라 다릅니다.
- Single: 기본 규칙
- Pro: 스킬, 에이전트, 모델 라우팅이 포함된 전체 프로필
- Team: 전체 프로필과 팀 공통 규칙
전체 프로필에는 이 환경에서의 Laravel, WordPress, 디버깅, 배포를 위한 Claude Code 스킬, 메인 세션이 어려운 부분을 맡는 동안 더 빠르고 저렴한 모델로 시각 작업을 처리하는 frontend 서브에이전트(이것이 모델 라우팅입니다), 변경을 마치기 전에 독립적인 리뷰를 하는 reviewer 서브에이전트가 추가됩니다. 팀 규칙은 팀 페이지에서 작성합니다. Single로 옮기면 직접 변경하지 않은 경우 전체 프로필의 파일이 제거됩니다.
rdev 명령 가이드
모든 요금제는 사용하는 각 코딩 에이전트용으로 rdev 스킬을 설치합니다. 어떤 rdev 명령이나 rdev MCP 도구가 어떤 작업을 처리하는지 에이전트에게 알려 주는 짧은 가이드입니다. 프로젝트 추가와 실행, 언어·PHP·Node 버전 설치, 데이터베이스와 서비스, 워커와 예약 작업 유지, 미리보기, 체크포인트, Git 접근, 백업, 배포, 오류 추적, 알림, 라이선스를 다룹니다. 에이전트는 작업에 필요할 때 스스로 불러오므로 "shop에 Postgres 데이터베이스를 추가해" 또는 "blog의 큐 워커를 실행해"처럼 바로 요청하면 됩니다.
~/.claude/skills/rdev(Claude Code)와 ~/.agents/skills/rdev(Codex, opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI, Cursor)에 설치되며, Antigravity가 설치되어 있으면 ~/.gemini/config/skills/rdev에도 설치됩니다. rdev가 이 파일들을 최신 상태로 유지하므로, 직접 만든 스킬은 다른 폴더에 두세요.
MCP 접근
에이전트는 사이트와 데이터베이스에 대한 MCP 접근 권한을 가집니다. 덕분에 에이전트가 사이트를 만들고, 프로젝트에 Redis, 데이터베이스, 검색, S3 스토리지를 추가하고, composer가 요구할 때 mongodb 같은 PHP 확장을 설치하고, 데이터베이스를 조회하거나 캡처된 이메일을 직접 읽을 수 있어, 사용자에게 요청할 필요가 없습니다.
rdev 0.2.0-beta.34부터 에이전트는 각 프로젝트의 프로세스와 예약 작업도 관리합니다. 큐 작업을 작성한 뒤 에이전트가 큐 워커나 Laravel 스케줄러를 직접 설정하고, 코드를 변경한 뒤 워커를 재시작하고, 프로세스의 출력을 읽습니다. 요청이 실패하면 Laravel 로그의 끝부분이나 마지막 오류를 읽고, 체크포인트(아래 참고)를 조회, 생성, 복원하며, 요청하면 사이트를 미리보기로 공유하고 야간 백업이 실행되었는지 알려줍니다. Claude Code는 다른 MCP 도구와 마찬가지로 도구를 처음 사용하기 전에 사용자에게 확인합니다.
내 계정
Anthropic 또는 OpenAI 계정이나 위의 제공업체 키를 직접 연결합니다. 에이전트 사용량은 해당 제공업체가 청구하며 rdev 구독에 포함되지 않습니다. 저희는 프롬프트나 사용량을 볼 수 없습니다.
에이전트를 24시간 실행
에이전트에게 프롬프트를 맡기고 서버에서 돌아가게 두세요. 노트북은 덮고 하루를 즐기세요. 에이전트는 노트북이 아니라 서버에서 실행되므로, 몇 시간 걸리는 작업도 자리를 떠난 뒤에 계속됩니다.
서버에 SSH로 로그인할 때마다 main이라는 같은 지속 세션이 열립니다. 노트북 앱의 Terminal on the server, ssh rdev, 또는 휴대폰이나 태블릿의 SSH 앱 모두 마찬가지입니다. 직접 시작할 필요는 없습니다(rdev 1.0.1 이상).
랩톱 앱에서 프로젝트의 Open in Terminal과 rdev open <프로젝트>는 대신 그 프로젝트만의 지속 세션을 엽니다. 세션 이름은 프로젝트 이름이며 프로젝트 폴더에서 시작됩니다. 그래서 각 프로젝트가 자신의 창과 에이전트를 유지하고, 서로 다른 프로젝트를 연 두 기기가 서로의 화면을 바꾸지 않습니다(rdev 1.3.1 이상).
- 그 터미널에서 에이전트를 시작하고 작업을 맡깁니다.
- 덮개를 닫거나, 앱을 닫거나, 연결이 끊겨도 에이전트는 서버에서 계속 작업합니다. 일부러 나가려면 Ctrl-b를 누른 다음 d를 누르세요.
- 어떤 기기에서든 돌아오세요. 다시 로그인하면 떠났던 바로 그 세션에 있습니다. 패널의 에이전트 세션와 알림이 작업이 끝났는지, 또는 사용자를 기다리는지 알려 줍니다.
키 몇 가지가 도움이 됩니다. Ctrl-b c는 새 창을 열고(두 번째 에이전트용), Ctrl-b n과 Ctrl-b p는 창 사이를 이동하며, 마우스나 트랙패드로 스크롤할 수 있습니다. 지속 세션을 끄려면 서버에서 rdev session persist off를 실행하세요(on으로 다시 켤 수 있으며 rdev 1.0.5 이상). 편집기의 원격 터미널(VS Code, Cursor)과 파일 동기화는 지속 세션을 사용하지 않습니다.
세션이 끝났다면 claude --continue(선택하려면 claude --resume)나 codex resume처럼 에이전트 자체 명령으로 같은 대화를 이어 가세요. 대화는 서버의 홈 폴더에 남아 업데이트와 재시작 후에도 유지됩니다.
rdev host update는 환경을 다시 시작하므로 모든 에이전트와 지속 세션이 중지됩니다. 에이전트가 작업 중이거나 사용자를 기다리는 동안에는 대기하며 그 사실을 알려 줍니다. rdev host update --force는 그래도 업데이트합니다.
패널의 에이전트 세션
패널의 에이전트 세션에는 서버의 Claude Code와 Codex 세션이 나열되고 각각 무엇을 하고 있는지 표시됩니다: 작업 중, 사용자 응답 대기 중(권한 요청이나 질문), 완료, 오류로 중단됨. 몇 초마다 새로고침되고 휴대폰에서도 동작하므로 어디서든 긴 작업을 확인할 수 있습니다. 사용자를 기다리는 세션이 맨 위에 표시됩니다.
패널에는 에이전트, 세션, 프로젝트 폴더 이름, 상태만 전달되며 프롬프트, 에이전트의 답변, 코드는 전달되지 않습니다. 세션은 일주일 동안 보관됩니다. Codex는 작업 중과 완료만 보고하며, 승인 요청은 아직 표시되지 않습니다.
세션의 ⋯ 메뉴는 실행 중인 세션을 중지합니다. 서버가 몇 초 안에 에이전트의 프로세스를 종료합니다(이미 변경한 파일은 그대로 남으며 세션 시작 시점의 체크포인트로 되돌릴 수 있습니다. 이 기능에는 rdev 0.2.0-beta.36 이상이 필요합니다). 지속 터미널에서 실행되는 세션에는 지속 배지가 표시되며, 메뉴의 터미널 창 닫기는 에이전트가 아직 작업 중이면 중지하고 서버의 터미널 창을 닫습니다. 에이전트가 끝난 뒤에도 사용할 수 있습니다(rdev 1.0.1 이상). 목록에서 제거는 세션 하나를 숨기고, 완료된 세션 지우기는 완료, 실패, 비활성 세션을 한꺼번에 제거합니다. 다시 보고하는 세션은 목록에 돌아옵니다. 웹 터미널에서 열기는 tailnet의 기기에서 서버의 웹 터미널로 해당 터미널 창을 엽니다(본인 서버만, rdev 1.4.5 이상). 창이 이미 닫혔다면 평소의 영구 세션이 열립니다.
체크포인트: 에이전트가 한 작업 되돌리기
git 프로젝트에서 에이전트 턴이 시작되면 rdev가 먼저 프로젝트 파일의 체크포인트를 저장합니다. 추적 중인 파일과 새 파일이 대상이며 무시된 파일은 제외됩니다. 이는 브랜치 밖의 커밋이므로 git status, 기록, stash는 그대로입니다. 프로젝트마다 최근 20개의 체크포인트를 유지하며, 아무것도 변경하지 않은 턴은 체크포인트를 추가하지 않습니다.
각 턴 전의 자동 체크포인트는 에이전트의 훅에서 만들어지므로 Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI는 자동으로 받습니다. Cursor CLI와 Antigravity CLI에는 이런 훅이 없어서 rdev로 시작할 때 체크포인트를 받으며, 이때 세션이 패널에도 표시되고 끝나면 알림이 옵니다.
rdev agents run cursor
Antigravity CLI는 rdev agents run antigravity를 사용하세요.
되돌리려면 패널에서 서버를 열어 되돌리고 복원에서 체크포인트를 선택하거나 서버에서 진행하세요. 프로젝트의 체크포인트를 나열합니다.
rdev checkpoint list
그런 다음 ID로 하나를 복원합니다.
rdev checkpoint restore 1793603600
복원하면 파일이 이전 상태로 돌아가고 그 이후에 추가된 파일은 삭제됩니다. 현재 상태는 먼저 새 체크포인트로 저장되므로(이미 최신 체크포인트와 같은 경우는 제외) 복원도 되돌릴 수 있습니다. rdev checkpoint create는 직접 체크포인트를 저장합니다. 체크포인트에는 rdev 0.2.0-beta.16 이상이 필요합니다.