Claude 자체 호스팅 CI 테스트 — 30일마다 다시 로그인해야 합니다

사내 서버에서 AI 세션을 돌리고 있다면, 새 이미지를 올리기 전에 자동으로 한 판 돌려보고 싶어집니다. 세션을 하나 만들어 답을 받고, 이어서 한마디 더 보내 답을 또 받는 — 딱 그 모양의 점검이죠. 공식 문서에 이 절차가 통째로 나와 있는데, 읽어보면 API 키가 안 통하고, 권한 자체가 30일로 잘려 있어 한 달마다 사람이 다시 로그인해야 합니다. 자동화해 두면 딱 한 달 뒤에 깨지는 종류예요. 정리했습니다.

📌 30초 요약

• ★★권한이 30일로 잘려 있습니다 — 장기 토큰을 만들 방법이 없습니다.
• ★API 키는 안 받습니다 — 계정 로그인 토큰만 됩니다.
• ★답을 기다려주지 않습니다 — 번호만 찍고 바로 끝납니다.
• ⚠️ 세션 번호의 앞머리가 서로 다릅니다.
• 훅은 러너를 켜기 전에 깔아야 합니다.
• 이 훅을 운영 쪽에 두지 마세요 — 모든 답을 디스크에 적습니다.

답은 요청해서 받는 게 아닙니다

먼저 구조가 낯섭니다. 명령줄로 시험 환경에 세션을 하나 만들면 답을 기다리지 않고 바로 끝납니다. 세션 번호와 주소만 한 줄 찍고 종료예요. 그럼 답은 어디서 읽느냐 — 러너 쪽에 "차례가 끝날 때 도는 훅"을 깔아 두고, 그 훅이 마지막 답을 파일로 떨궈 놓게 합니다. 시험 스크립트는 그 파일이 생기기를 기다리고요.

덕분에 바깥으로 나가는 호출은 세션을 만들 때와 한마디 더 보낼 때, 딱 두 번뿐입니다. 답을 받아오느라 계속 물어볼 필요가 없어요. 러너가 시험 스크립트와 같은 기계에 있다면 파일을 그냥 같이 보면 되고, 러너가 다른 곳에 있다면 파일로 적는 대신 내가 띄운 주소로 쏘게 바꾸면 됩니다. 훅이 내 인프라에서 도니 그 주소는 바깥에 열려 있을 필요도 없습니다.

⚠️ 이 훅을 운영 쪽 이미지에 넣지 마세요

훅은 내보낼 폴더 값이 잡혀 있으면 무조건 동작합니다. 버려도 되는 시험용 기계에서는 무해하지만, 운영 러너 이미지에 딸려 들어간 채 그 값이 어쩌다 설정되면 모든 세션의 마지막 답이 디스크에 쌓입니다. 문서가 시험 환경 러너에만 깔라고 따로 못을 박는 이유예요.

30일마다 사람이 다시 로그인해야 합니다

여기가 제일 아픈 대목입니다. 세션을 만드는 호출과 한마디 더 보내는 호출은 둘 다 계정 로그인 토큰으로만 인증합니다. 흔히 갖고 있는 API 키는 아예 안 받아줘요. 그리고 이 권한은 서버 쪽에서 30일로 상한이 걸려 있습니다.

그래서 우회로가 죄다 막혀 있어요. 1년짜리 토큰을 만들어주는 명령이 따로 있지만 그건 모델을 부르는 용도라 원격 세션을 조종하는 권한은 못 덮습니다. 환경을 등록할 때 쓰는 비밀도 안 됩니다 — 그건 러너가 환경에 등록하는 것만 허락하지 세션을 만들 권한이 아니거든요. 결론은 단순합니다. 전용 계정 하나를 만들어 그 기계에서 한 번 직접 로그인하고, 30일마다 다시 로그인하는 것. 문서가 사람 계정에 묶이지 않는 길이 필요하면 담당 팀에 문의하라고 적어둔 것도 그래서입니다.

써보고 싶은 것	되나
API 키	안 됩니다 — 두 호출 모두 거절
1년짜리 토큰	권한이 안 맞습니다 — 모델 호출용
환경 등록 비밀	안 됩니다 — 러너 등록 전용
계정 로그인 후 저장된 값	됩니다 — 단 30일마다 갱신

매번 새로 만들어지는 일회용 기계에서 돌린다면 저장된 로그인을 환경 값으로 넘겨 창을 띄우지 않고 교환하게 할 수 있습니다. 다만 그쪽도 30일 상한은 똑같이 걸립니다. 새 모델이 나올 때마다 갈아타는 흐름에서는 이런 갱신 주기가 잘 안 보이는데, 자동 점검을 걸어두면 한 달 뒤에 정확히 드러납니다.

조용히 어긋나는 세 곳

문서의 예제가 유난히 방어적으로 짜여 있는데, 이유가 있습니다. 틀려도 오류가 안 나고 그냥 조용한 자리가 셋이거든요.

첫째, 같은 세션인데 번호의 앞머리가 다릅니다. 훅 안에서 보이는 표기와 명령줄이 찍어주는 표기가 달라서, 그대로 파일 이름에 쓰면 시험 스크립트가 영영 못 찾습니다. 예제가 앞머리를 바꿔치기하는 한 줄을 굳이 넣어둔 건 이 때문이에요. 둘째, 내보낼 폴더 값이 없거나 그 폴더가 없으면 훅이 아무 일도 안 하고 통과합니다 — 실패가 아니라 조용한 무동작이라 "왜 파일이 안 생기지"로 헤매기 좋아요.

✅ 셋째 — '없음'이라는 글자가 적히는 경우

마지막 차례가 도구만 부르고 글은 한 줄도 안 남기고 끝나는 경우가 있습니다. 그럼 가져올 답 자체가 없는데, 빈 값을 걸러주는 필터를 안 넣으면 '없음'이라는 글자가 그대로 파일에 적힙니다. 그러면 파일은 멀쩡히 생겼는데 내용이 엉뚱하죠. 예제는 비었으면 아예 아무것도 안 쓰도록 걸러 둡니다. 그리고 훅은 어떤 경우에도 차례를 실패시키지 않게 짜여 있어요 — 점검 장치가 본 작업을 망치면 안 되니까요. 세션 준비 스크립트 쪽에서도 같은 함정이 나왔었죠.

하나 더. 훅은 러너를 켜기 전에 깔아야 합니다. 러너가 시작할 때 설정을 한 번 떠놓고 그걸 세션마다 나눠주기 때문에, 돌고 있는 러너에 훅을 넣어봐야 다시 켜기 전까지는 안 먹습니다. 그리고 세션을 만드는 명령은 이어하기·붙기·미리 설정하기 계열과 섞을 수 없고, 흐르듯 내보내는 출력 형식도 지원하지 않습니다.

시험용 환경은 만들고 지웁니다

점검할 때마다 깨끗한 환경을 쓰고 싶다면, 환경을 만들었다가 끝나면 지우는 방식이 정석입니다. 관리 화면이 쓰는 것과 같은 창구를 그대로 부르면 되고, 실험 단계 표시를 붙여야 합니다. 조직에서 자체 호스팅을 아직 안 켰다면 "정책으로 막혀 있다"는 거절이 돌아와요.

여기서 특히 조심할 게 둘입니다. 하나는 만들 때 돌려주는 비밀을 절대 화면에 찍지 말 것 — 그 값이면 누구든 그 환경에 러너를 등록할 수 있는, 오래 사는 자격이거든요. 가려진 비밀로 저장하고 화면에는 환경 번호만 남기라고 합니다. 다른 하나가 더 얄궂은데, 인증 값을 눈에 안 띄게 넘기는 표기법이 오래된 도구에서는 통하지 않습니다. 옛 버전은 그 표기를 글자 그대로 헤더 이름으로 취급해서, 인증 없이 요청을 그냥 보내버려요. 실패가 아니라 잘못된 성공처럼 보이는 종류라 더 위험합니다. 두 도구를 실제로 돌려 비교하던 방식처럼, 여기서도 결국 직접 한 판 굴려봐야 알 수 있습니다.

자주 묻는 질문 (FAQ)

Q. 어디서 돌리라는 건가요, 이 스크립트를?

기본 전제는 러너와 같은 기계입니다. 그래야 훅이 떨군 파일을 그냥 읽을 수 있어요. 그리고 저장소를 받아둔 폴더 안에서 돌려야 어느 저장소로 작업할지 자동으로 잡힙니다.

Q. 특정 가지를 기준으로 시험하고 싶으면요?

세션을 만들 때 기준 가지를 따로 지정할 수 있습니다. 지금 내 폴더가 어디를 보고 있든 상관없이 그 지점으로 받아옵니다.

Q. 얼마나 기다리게 잡아야 하나요?

예제는 넉넉히 잡아두고 "환경이 차갑게 식었다 뜨는 시간에 맞춰 조정하라"고 안내합니다. 실패하면 폴더 목록과 파일 내용을 같이 찍어주게 짜여 있어서, 왜 못 받았는지 바로 보입니다.

Q. 무엇을 확인하게 만드는 게 좋나요?

예제는 정해둔 문장을 그대로 말하게 시키고 그 문장이 왔는지만 봅니다. 여기에 사내 도구를 하나 불러보게 하고 그 결과를 확인하도록 바꾸면, 이미지·저장소 접근·사내 연동이 한 번에 검증됩니다.

✨ 정리하면

자동 점검 자체는 어렵지 않습니다. 세션 하나 만들고, 훅이 떨군 답을 기다리고, 한마디 더 보내고, 또 기다리면 끝이에요. 진짜 걸림돌은 인증 쪽입니다 — API 키는 안 받고, 권한은 30일에서 잘립니다. 자동화를 걸어둘 거라면 한 달마다 사람이 다시 로그인하는 일정을 아예 캘린더에 박아두세요. 비용과 권한을 함께 설계하는 흐름은 AI 지출 관리 허브에 단계별로 정리해 두었습니다.

출처: Claude Code 공식 문서 「자체 호스팅 환경 전 구간 시험」 (2026-08-31 열람). 자체 호스팅 환경은 공개 베타 단계이며 팀·기업 요금제에서 관리자가 켜야 씁니다. 일부 동작은 도구 버전에 따라 다르고, 세부 절차는 변경될 수 있습니다.