Claude Code 상세 사용법 09: 웹/클라우드 세션으로 긴 작업 맡기기 | DAKER 커뮤니티

Claude Code 상세 사용법 09: 웹/클라우드 세션으로 긴 작업 맡기기

Claude Code는 터미널뿐 아니라 웹의 클라우드 세션에서도 작업을 실행할 수 있다. 공식 문서 기준 Claude Code on the web은 Pro, Max, Team, 일부 Enterprise 좌석에서 research preview로 제공된다. 이 글의 목표는 "브라우저에서 코딩한다"가 아니라, 오래 걸리는 AI 코딩 작업을 격리된 실행 환경에 맡기고 로컬로 다시 회수하는 운영법이다.

1. 먼저 GitHub 연결 방식을 정한다

클라우드 세션은 저장소를 clone하고 branch를 만들 수 있어야 한다. 공식 문서에는 두 흐름이 나온다. 팀 운영은 GitHub App이 관리와 Auto-fix에 유리하고, 개인 개발자는 터미널에서 /web-setup으로 로컬 gh 토큰을 동기화하는 방식이 빠르다.

claude
/web-setup

팀에서는 이 단계가 권한 설계다. Claude가 접근할 수 있는 범위는 연결 계정이 GitHub에서 볼 수 있는 저장소에 의해 결정되므로, 실험용 계정이나 팀 권한을 먼저 정리한다.

2. 로컬에서 바로 원격 작업을 시작한다

작업 설명이 명확하면 터미널에서 새 웹 세션을 만들 수 있다.

claude --remote "Fix the failing checkout tests, run the test suite, and open a PR"

좋은 프롬프트는 세 부분을 포함한다. 첫째, 건드릴 영역. 둘째, 완료 증거. 셋째, PR이나 branch 같은 산출물. 예를 들면 "결제 모듈만 수정, pnpm test:checkout 통과, PR 본문에 원인과 검증 기록 작성"처럼 쓴다.

3. 클라우드에 올라가는 것과 안 올라가는 것을 구분한다

클라우드 세션은 fresh clone에서 시작한다. repo에 commit된 CLAUDE.md, .claude/settings.json, .mcp.json, .claude/skills, .claude/agents, .claude/commands는 사용할 수 있다. 반대로 내 노트북의 ~/.claude/CLAUDE.md, 유저 설정에만 넣은 plugin, 로컬에만 추가한 MCP 서버, 개인 credential은 자동으로 가지 않는다.

4. 환경은 setup script와 hook으로 나눈다

웹 환경에는 setup script가 있다. missing package나 gh 같은 도구 설치에 쓴다. 공식 문서는 setup script가 Ubuntu 환경에서 실행되고, 변경 후 캐시될 수 있으며, 너무 오래 걸리면 세션 시작을 막을 수 있다고 설명한다.

#!/bin/bash
apt update && apt install -y gh

프로젝트별 설치는 SessionStart hook으로 빼는 편이 낫다. 단, 클라우드와 로컬이 모두 읽을 수 있으니 cloud 전용이면 환경 변수를 확인한다.

if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
  exit 0
fi
pnpm install

5. 다시 로컬로 가져올 때는 teleport를 쓴다

웹에서 만든 session을 터미널로 가져올 때는 --teleport나 /teleport를 쓴다. 이 기능은 로컬 history를 여는 --resume과 다르다. 클라우드 session의 branch와 대화 이력을 가져오는 흐름이다.

claude --teleport

실패하면 먼저 네 가지를 본다. 현재 git 상태가 깨끗한가, 같은 저장소인가, 클라우드 branch가 remote에 push됐는가, 같은 claude.ai 계정으로 로그인했는가. API key, Bedrock, Vertex 같은 인증만 쓰는 환경에서는 claude.ai 로그인과 조직 설정도 확인해야 한다.

Senior takeaway: 클라우드 Claude Code는 빠른 데모보다 "긴 작업의 실행 격리"에 가치가 있다. repo에 규칙과 검증 명령을 남기고, secret과 네트워크는 최소 권한으로 열고, 완료 조건을 PR과 테스트 증거로 닫으면 바이브코딩이 개인 장난감이 아니라 팀의 LLM 개발 워크플로우가 된다.

Redirecting to Claude Code 상세 사용법 09: 웹/클라우드 세션으로 긴 작업 맡기기 | DAKER 커뮤니티...