클로드 코드 클라우드 세션 — 끌어오기만 되고 밀어 올리기는 안 됨

노트북을 닫아도 계속 도는 자리에 일을 맡겨 두고, 폰으로 진행 상황을 보는 방식이 자리를 잡았습니다. 문서에서도 「웹에서 쓰는 것」이라는 표현을 걷어내고 「구름 위에서 도는 세션」으로 이름을 바꿨습니다 — 들어가는 문이 브라우저와 폰만이 아니라 데스크탑 앱과 터미널까지 넷으로 늘었기 때문입니다.

그런데 넷 사이를 자유롭게 오갈 수 있는 건 아닙니다. 터미널에서는 한 방향으로만 움직이고, 클라우드가 실제로 복제하는 것도 내 화면에 보이는 폴더가 아닙니다. 게다가 열쇠 파일을 빼 주는 보호 장치가 저장소 배치에 따라 작동하지 않는 경우도 있습니다. 하나씩 짚어 보겠습니다.

📌 30초 요약

• 터미널에서는 끌어오기만 되고 밀어 올리기는 안 됩니다.
• 클라우드는 내 폴더가 아니라 깃허브 원격을 복제합니다.
• 원격이 없으면 로컬 저장소를 통째로 묶어 올립니다.
• 열쇠 파일 보호가 배치에 따라 안 될 수 있습니다.

1. 이동은 한 방향뿐입니다

가장 먼저 알아 둘 게 이겁니다. 명령줄에서는 구름 위 세션을 내 터미널로 끌어올 수는 있지만, 지금 돌고 있는 터미널 세션을 구름 위로 밀어 올릴 수는 없습니다. 「하던 걸 그대로 클라우드에 넘기고 퇴근해야지」가 명령줄에서는 안 된다는 뜻입니다. 그걸 하려면 데스크탑 앱의 「다른 곳에서 이어가기」 메뉴를 써야 합니다. 같은 제품인데 들어가는 문에 따라 되는 일이 다릅니다.

플래그	하는 일
클라우드	작업 설명을 주면 새 클라우드 세션 생성
끌어오기	구름 위 세션을 내 터미널로 가져와 이어감
원격 조종	완전히 다른 기능 — 로컬 세션을 밖에서 들여다보고 지시

표의 마지막 줄이 특히 헷갈리는 자리입니다. 이름이 비슷해 보이지만 원격 조종은 클라우드 세션과 아무 관련이 없습니다. 이건 내 컴퓨터에서 도는 세션을 밖에서 보고 지시하는 기능이라 방향이 정반대죠. 폰에서 내 로컬 세션을 이어 쓰는 방식은 원격 제어 정리에 따로 적어 뒀습니다. 참고로 클라우드 플래그의 옛 이름도 아직 동작하지만 폐기된 별칭입니다.

같은 플래그가 다른 값과 함께 오면 동작이 달라진다는 것도 알아 두셔야 합니다. 작업 설명을 주면 새 세션을 만들지만, 한 번에 돌리는 방식과 세션 번호나 주소를 함께 주면 그 기존 세션에 메시지를 대기열로 넣습니다. 새로 만드는 게 아니라 이어 붙이는 거죠. 자동화 스크립트에서 이 둘을 헷갈리면 세션이 계속 새로 생기니 값 구성을 한 번 확인해 두세요.

2. 복제하는 건 내 폴더가 아닙니다

두 번째로 자주 걸리는 자리입니다. 클라우드 세션을 만들면 그쪽 가상 기계가 내 현재 폴더의 깃허브 원격을, 지금 가지 기준으로 복제합니다. 내 컴퓨터에 있는 작업본을 그대로 옮기는 게 아니라는 뜻이죠. 그래서 커밋만 하고 아직 밀지 않은 변경이 있으면 클라우드는 그걸 모릅니다. 「분명히 고쳐 뒀는데 왜 옛날 코드로 작업하지」의 답이 대개 여기 있습니다.

컨테이너가 준비되는 동안에는 손을 놓고 기다리지 않아도 됩니다. 명령줄이 저장소 복제나 준비 스크립트 실행 같은 단계를 실시간 목록으로 보여 주고, 그사이 내가 친 메시지는 대기열에 넣었다가 세션이 준비되면 한꺼번에 보냅니다. 그리고 클로드가 뭔가 물어봤는데 자리를 비워 세션이 놀고 있어도, 환경이 만료되기 전이라면 돌아와서 답하면 거기서부터 이어집니다.

문서가 권하는 쓰임새도 둘 있습니다. 하나는 로컬에서 계획하고 클라우드에서 실행하는 방식인데, 계획 모드로 방향을 잡은 뒤 계획을 파일로 저장·커밋·푸시해야 클라우드가 그걸 볼 수 있습니다. 앞서 말한 복제 규칙 때문이죠. 다른 하나는 병렬 실행입니다 — 클라우드 플래그를 여러 번 부르면 각각 독립된 세션으로 동시에 돕니다. 끝난 세션은 끌어와서 이어 작업하거나 바로 끌어올림 요청을 만들면 됩니다.

3. 깃허브 없이 보낼 때

원격이 아예 없는 저장소거나, 깃허브 저장소인데 연동 앱이 안 깔려 있다면 어떻게 될까요. 이때는 복제 대신 내 로컬 저장소를 통째로 묶어 클라우드로 올립니다. 묶음에는 모든 가지의 전체 이력과, 추적 중인 파일의 커밋 안 한 변경까지 들어갑니다. 웹 설정 명령으로 깃허브를 연결해 뒀더라도 조건이 맞으면 이 경로를 탑니다. 환경 변수 하나를 켜면 복제할 수 있는 상황에서도 강제로 묶어 올릴 수 있고요.

묶음 조건	내용
크기	100MB 미만 — 넘으면 현재 가지만, 그다음 단일 스냅숏, 그래도 크면 실패
추적 안 된 파일	미포함 — 보여 주려면 먼저 추적에 올려야 함
되밀기	연결된 계정에 푸시 권한이 있을 때만 가능

표의 둘째 줄이 실무에서 자주 걸립니다. 새로 만들어 아직 추적에 안 올린 파일은 묶음에 안 들어갑니다. 방금 만든 설정 파일이나 스크립트를 클라우드가 못 보는 이유가 이것이죠. 보여 주고 싶다면 커밋까지 하지 않더라도 추적에는 올려 두셔야 합니다. 그리고 저장소는 커밋이 최소 하나는 있어야 묶을 수 있습니다.

세션을 남에게 보여 줄 때도 주의할 게 있습니다. 공개 범위 선택지가 계정 종류에 따라 다릅니다. 기업·팀 계정은 「비공개」와 「팀」 둘이고 받는 사람의 저장소 접근 확인이 기본으로 켜져 있습니다. 반면 개인 유료 계정은 「비공개」와 「전체 공개」인데, 전체 공개로 두면 로그인한 아무나 볼 수 있고 저장소 접근 확인도 기본으로 꺼져 있습니다. 세션에는 비공개 저장소의 코드와 자격증명이 담길 수 있으니, 링크를 넘기기 전에 내용을 한 번 훑어보시고 필요하면 설정에서 접근 확인을 켜 두세요.

미리 알아 둘 제약도 셋 있습니다. 첫째, 요금 한도는 다른 사용과 함께 쓰는 하나라서 여러 작업을 동시에 돌리면 그만큼 빨리 닳습니다. 다만 클라우드 기계 자체에 대한 계산 요금은 따로 받지 않습니다. 둘째, 저장소 복제와 끌어올림 요청 생성은 깃허브가 있어야 하고, 깃랩이나 비트버킷은 묶음으로 보낼 수는 있어도 결과를 그쪽으로 되밀 수는 없습니다. 셋째가 가장 걸리기 쉬운데, 조직이 접속 주소 허용 목록을 켜 뒀다면 클라우드 세션이 전부 인증 오류로 실패합니다 — 앤스로픽 쪽 기반에서 부르기 때문입니다.

4. 열쇠 파일이 빠지는 조건

⚠️ 보호 장치가 저장소 배치에 따라 작동하지 않습니다

묶어 올릴 때 맥·리눅스·리눅스 계층에서는 자격증명이나 열쇠처럼 보이는 파일의 커밋 안 한 변경을 빼 주고, 뺀 파일 이름을 알려 줍니다. 환경 파일, 테라폼 변수 파일, 흔한 열쇠 파일 이름이 여기 듭니다. 그런데 연결된 작업 트리나 하위 모듈 같은 배치에서는 이 변경까지 그대로 올리고, 올린 파일 이름을 알려 줍니다. 즉 같은 파일이 저장소 구조에 따라 빠지기도 하고 올라가기도 합니다. 이런 배치를 쓰신다면 올리기 전에 알림 문구를 꼭 읽어 보세요.

빠지는 쪽으로 동작할 때도 알아 둘 게 있습니다. 커밋 안 한 변경만 제외되므로 이미 커밋해 둔 판이 있다면 그 커밋된 내용으로 세션이 시작됩니다. 커밋된 게 없으면 그 파일 없이 시작하고요. 실수로 열쇠를 커밋해 둔 저장소라면 이 보호가 아무 의미가 없다는 뜻이라, 애초에 그런 파일을 이력에서 걷어내는 게 순서입니다.

클라우드에서 열쇠가 필요한 작업을 돌려야 한다면 아직 마땅한 자리가 없다는 점도 함께 아셔야 합니다. 이 문제는 클라우드 환경에 열쇠 넣기에서 따로 다뤘고, 깃허브 연동 앱을 어디에 깔아야 어디까지 열리는지는 웹 세션 정리에 적어 뒀습니다. 전체 도입 순서는 AI 도입 한 바퀴에서 잡아 보세요.

자주 묻는 질문 (FAQ)

Q. 하던 작업을 클라우드로 넘기고 싶습니다

명령줄에서는 안 됩니다. 끌어오기는 되지만 밀어 올리기는 없습니다. 돌고 있는 세션을 넘기려면 데스크탑 앱의 「다른 곳에서 이어가기」 메뉴를 쓰셔야 합니다. 명령줄에서는 대신 새 클라우드 세션을 만들 수 있는데, 이때 지금까지의 대화는 안 따라가니 작업 설명을 다시 적어 주셔야 합니다.

Q. 클라우드가 옛날 코드로 작업합니다

클라우드는 내 작업본이 아니라 깃허브 원격을 현재 가지 기준으로 복제합니다. 그래서 아직 밀지 않은 커밋은 반영되지 않습니다. 보내기 전에 먼저 푸시하세요. 계획 모드로 방향을 잡고 넘기는 방식을 쓰신다면, 계획 파일도 커밋하고 밀어야 클라우드가 읽을 수 있습니다.

Q. 방금 만든 파일을 클라우드가 못 봅니다

원격 없이 묶어 올리는 경로를 탔다면 추적에 안 올라간 파일은 묶음에 포함되지 않습니다. 커밋까지는 아니어도 추적에는 올려 두세요. 묶음에는 모든 가지의 이력과 추적 중인 파일의 커밋 안 한 변경이 들어가고, 저장소가 100MB를 넘으면 현재 가지만, 그래도 크면 단일 스냅숏으로 줄어듭니다.

Q. 환경 파일이 클라우드로 올라갔습니다

저장소 배치를 보세요. 보통은 열쇠처럼 보이는 파일의 커밋 안 한 변경을 빼 주지만, 연결된 작업 트리나 하위 모듈 같은 배치에서는 그대로 올립니다. 어느 쪽이든 어떤 파일을 뺐는지 또는 올렸는지 이름을 알려 주니 그 문구를 확인하세요. 그리고 이미 커밋된 열쇠는 애초에 보호 대상이 아닙니다.

정리하면

• 명령줄에서는 끌어오기만 됩니다.
• 밀어 올리려면 데스크탑 앱 메뉴를 쓰세요.
• 복제 대상은 깃허브 원격의 현재 가지입니다.
• 추적 안 된 파일은 묶음에 안 들어갑니다.
• 열쇠 보호는 배치에 따라 갈립니다.

※ 공개된 클라우드 세션 문서를 읽고 정리했습니다. 플래그와 환경 변수 이름은 우리말로 풀어 적었으니 실제 입력값은 원문에서 확인하세요.

※ 문서의 이름이 「웹」에서 「클라우드」로 막 바뀐 참이라 화면 표기와 문서 용어가 한동안 어긋날 수 있습니다. 묶음 크기 제한과 제외 대상 파일 목록도 판올림에 따라 달라질 수 있으니 원문과 대조해 확인하세요.