문서

설치, 연결, 마을 사용법

문서›에이전트별

Devalley에서 클로드 코드(Claude Code) 쓰기

클로드 코드(Claude Code) 세션은 Devalley에서 주민 한 명이 돼요. 권한 요청과 질문을 주민이 들고 오고, 마을에서 답하고, 답을 읽고, 다음 지시를 보내요. 클로드코드로 Devalley에서 되는 것이 가장 많아요.

주민

실행 중인 클로드 코드 세션마다 마을 주민이 한 명씩 생겨요. 같은 프로젝트의 같은 에이전트는 언제나 같은 주민이라 이름과 모습이 그대로이고, 같은 프로젝트에서 세션을 하나 더 돌리면 동료가 한 명 더 와요. 세션이 일하는 동안 주민은 일터에 가 있고, 한 차례 일을 마치면 「완료!」 하고 기뻐하고, 할 일이 없으면 쉬어요. 주민을 누르면 카드가 열려요. 지금 상태(「작업 중」, 「확인 필요」, 「답변 도착」, 「쉬는 중」, 「꺼짐」, 「오류」)와 프로젝트, 마지막으로 시킨 일이 보이고, 「대화 열기」를 누르면 마지막 답을 읽을 수 있어요.

처음 실행하면 Devalley가 Claude Code 연결을 물어요. 이미 돌고 있던 세션은 다시 시작하지 않아도 다음 프롬프트를 보낼 때 마을에 들어와요. Claude Code 2.1.139 이상이 필요하고, 더 오래된 버전이면 연결 창이 업데이트를 안내해요.

알림

「걷는 주민」을 켜 두면 주민이 화면 아래를 걸어 다니고, 발밑에 이름과 프로젝트가 보여요. 클로드 코드가 무언가 물으면 주민이 화면 가운데로 달려와 「?」 말풍선을 띄우고 답할 때까지 뛰어요(마을에서 답할 수 있는 승인 요청은 「허락해 주세요」). 한 차례 일을 마치면 뛰면서 「완료!」 하고 알려요. Mac에서는 「노치에」를 켜면 화면 위 노치 옆에도 같은 모습이 나와요. 에이전트의 상태를 소리나 시스템 알림, 휴대폰 알림으로 알리지는 않아요.

마을에서 답하기

클로드 코드가 권한을 물으면 주민이 「허락해 주세요」 말풍선으로 요청을 들고 와요. 말풍선을 누르면 대화창이 열리고, 무엇을 하려는지(명령이나 파일, 긴 명령은 전체를 펴서)와 함께 「허용」, 「거부」, 「항상 허용」, 「터미널에서 답하기」가 나와요. 객관식 질문도 거기서 보기를 눌러 답해요. 주민이 여럿이면 대화창 목록 맨 위 「나를 기다려요」에서 대화를 열지 않고 바로 허용하거나 거부해요. 누르지 않은 것은 아무것도 허용되지 않아요.

대화창에서는 마지막 답을 읽고, 다음 지시를 보내고, 진행 중인 턴을 멈춰요. 터미널을 닫았거나 컴퓨터를 다시 켜서 꺼진 세션은 주민이 「꺼짐」으로 잠들어 있다가, 메시지를 보내면 같은 대화를 이어서 터미널 창 없이 깨어나요. Mac이나 WSL에서 마을이 창 없이 시작한 세션은 /usage, /model 같은 클로드 코드의 슬래시 명령도 입력창에서 보내고, 파일도 프롬프트와 함께 보내요.

사용량 카드

사용량 카드에 클로드 코드 줄이 있어요. 한도를 얼마나 썼는지와 초기화까지 남은 시간이 나오고, 누르면 한도별 사용률과 초기화 시각, 오늘과 최근 7일 동안 쓴 토큰(프로젝트별)이 보여요. Mac에서는 한도가 가장 빠듯한 에이전트가 메뉴 막대에 「Claude 48%」처럼 뜨고, Windows에서는 트레이 메뉴의 「마을 창 > 사용량만」으로 작은 카드를 화면에 띄워 둬요. Claude Code의 로그인이 만료되면 카드에 로그인 버튼이 나와요.

Windows와 macOS

Windows macOS
주민과 상태 돼요 돼요
화면 아래를 걷는 주민 돼요(작업 표시줄 위) 돼요(Dock 옆)
노치에 보이기 없어요 돼요
승인 요청과 객관식 질문에 답하기 돼요 돼요
사용량 트레이의 「사용량만」 카드 메뉴 막대
꺼진 세션을 창 없이 깨우기 돼요 돼요
WSL 안의 세션 함께 연결돼요 해당 없음

안 되는 것

  • 직접 연 터미널에서 도는 세션 가운데에는 마을에서 글을 보낼 수 없는 것이 있어요. 그런 세션도 주민으로 보이고 답을 읽을 수 있지만, 대화창이 보낼 수 없다고 알려 줘요. 마을에서 이야기하려면 「주민 초대」로 시작하세요.
  • Claude Code 2.1.139보다 오래된 버전은 업데이트해야 해요.
  • 사용량 카드는 달러 비용을 보여 주지 않아요.
  • 소리, 시스템 알림, 휴대폰 알림은 없어요. 휴대폰에서는 답할 수 없어요.
  • Linux용 설치 파일은 아직 없어요.