클로드 코드 PR 배지 — 초록의 뜻이 갈리고 이슈 링크는 내 호스트 기준

작업하던 가지에 열린 끌어올림 요청이 있으면 클로드 코드 화면 아래에 요청 번호가 적힌 작은 배지가 뜹니다. 눌러서 브라우저로 열 수 있고, 밑줄 색으로 지금 검토가 어디까지 왔는지를 알려 줍니다. 터미널을 떠나지 않고도 「승인됐나」를 흘끗 볼 수 있는 셈이죠.

편한 기능인데 조건이 제법 붙습니다. 토큰이 없으면 안 뜨는데 어떤 호스트에서는 안내조차 없이 그냥 조용합니다. 게다가 깃랩에서는 같은 초록이 다른 뜻이고요. 함께 붙은 이슈 참조 링크도 기준이 생각과 다릅니다.

📌 30초 요약

• 밑줄 색 네 가지로 상태를 알려 줍니다.
• 깃랩에서는 초록의 뜻이 다릅니다.
• 어떤 호스트는 안내조차 안 뜹니다.
• 이슈 링크는 내 저장소 호스트를 따릅니다.

1. 색으로 읽는 검토 상태

배지의 밑줄 색이 곧 상태입니다. 네 가지뿐이라 익히는 데 오래 걸리지 않습니다.

밑줄 색	깃허브에서의 뜻
초록	승인됨
노랑	검토 대기 중
빨강	변경 요청이 달림
회색	초안 상태

배지는 요청이 병합되거나 닫히면 사라집니다. 갱신 시점도 분명한데, 세션 안에서 밀어 올리기나 요청을 바꾸는 명령이 성공하면 곧바로 새로 읽습니다. 브라우저에서 승인을 받았다면 터미널에서 뭔가 한 번 해야 색이 바뀐다는 뜻이죠. 요청에 달린 검사나 댓글에 자동으로 반응하게 해 두셨다면 그쪽 동작과 이 배지는 별개라는 점도 함께 알아 두시면 좋습니다 — 하나는 고치는 쪽이고 이건 보여 주는 쪽입니다.

표시 방식에도 사정이 있습니다. 터미널이 링크를 지원하는지 확인되지 않아도 일단 누를 수 있는 형태로 그립니다. 원격 접속이나 화면 분할 도구를 쓸 때 흔히 확인이 안 되는데, 그래도 링크로 그려 두는 쪽을 택한 겁니다. 깨져 보이면 환경 변수 하나로 평범한 글자로 바꿀 수 있습니다.

2. 토큰이 없으면 생기는 일

배지를 띄우려면 깃허브 토큰이 있어야 합니다. 클로드 코드는 원격 저장소가 가리키는 호스트를 보고 어디서 토큰을 찾을지 정합니다. 공개 서비스라면 정해진 환경 변수 두 개를 보거나, 명령줄 도구로 로그인해 저장된 토큰을 씁니다. 기업용 호스트를 쓰신다면 그쪽 전용 변수를 보고요.

⚠️ 호스트에 따라 안내조차 안 뜹니다

공개 서비스나 기업용 호스트라면 토큰이 없을 때 화면 아래에 「상태를 보려면 도구를 깔라」 또는 「로그인하라」는 안내가 뜹니다. 그런데 그 밖의 호스트에서는 배지도 안 뜨고 안내도 안 뜹니다. 그냥 아무것도 없죠. 기능이 없는 건지 설정이 덜 된 건지 구분할 방법이 화면에 없다는 뜻입니다. 자체 구축한 저장소를 쓰신다면 호스트를 지정해 로그인해 둬야 배지가 생깁니다. 또 비필수 통신을 막는 설정을 켜 두면 상태 확인 자체를 하지 않습니다.

이 「조용한 없음」이 특히 성가신 이유가 있습니다. 배지가 없으면 요청이 없는 줄로 읽히기 때문입니다. 실제로는 요청이 열려 있는데 토큰 문제로 안 보이는 것일 수 있죠. 표시가 실제 상태와 어긋날 수 있다는 점에서 표시등과 실제 동작이 별개였던 사례와 성격이 비슷합니다. 안 보인다고 없는 게 아닙니다.

3. 깃랩은 규칙이 또 다릅니다

깃랩을 쓰시면 같은 자리에 병합 요청 배지가 뜹니다. 표기법도 그쪽 방식을 따르고요. 문제는 색입니다 — 여기서 초록은 「승인됨」이 아니라 「병합할 수 있는 상태」를 뜻합니다. 노랑은 그 밖의 열린 상태를 전부 묶은 것이고, 회색만 초안으로 같습니다. 빨강은 아예 없습니다. 두 서비스를 오가며 쓰신다면 같은 초록을 다르게 읽어야 한다는 뜻이라 헷갈리기 쉽습니다.

준비물도 더 까다롭습니다. 일정 판올림 이상이어야 하고, 원격이 깃랩 호스트를 가리켜야 하며, 그쪽 명령줄 도구를 깔고 로그인해 둬야 합니다. 여기서 깃허브와 결정적으로 다른 점이 나옵니다 — 깃랩 쪽은 토큰 환경 변수를 아예 무시합니다. 변수에 토큰을 내보내 두는 것만으로는 배지가 안 생기고, 반드시 도구로 로그인해야 합니다.

한 가지 더 — 도구가 깔려 있는지와 로그인돼 있는지를 세션당 한 번만 확인합니다. 그래서 클로드 코드를 켜 둔 채로 도구를 깔거나 로그인하면 그 세션에서는 배지가 끝내 안 나옵니다. 「분명 로그인했는데 왜 없지」 싶을 때는 재시작해 보세요. 터미널 쪽 문제로 화면이 이상해 보이는 경우와 구분해 두면 헛수고를 줄일 수 있습니다.

4. 이슈 링크는 내 저장소를 따릅니다

클로드가 답변에서 이슈를 언급할 때 눌러서 열 수 있는 링크가 붙습니다. 다만 형태를 가립니다 — 「소유자 이름 빗금 저장소 이름 우물정 번호」로 된 두 부분짜리만 링크가 됩니다.

이렇게 적히면	결과
두 부분 형태	링크로 걸립니다
번호만 달랑	평범한 글자로 남습니다
경로가 더 깊은 형태	깃랩식 하위 묶음 경로는 링크가 안 됩니다
코드 구역 안	역따옴표로 감싼 곳은 그대로 둡니다

여기서 가장 놓치기 쉬운 게 링크가 향하는 곳입니다. 참조가 가리키는 저장소의 호스트가 아니라, 지금 제가 열어 둔 저장소의 원격 호스트로 주소를 만듭니다. 공개 서비스에서 일하는 중이라면 그쪽 주소가 되고, 깃랩에서 일하는 중이면 깃랩 형식 주소가 됩니다. 다른 서비스의 이슈를 언급해도 내가 있는 곳 기준으로 조립된다는 뜻이라, 눌렀는데 엉뚱한 데가 열리거나 없는 쪽이 열릴 수 있습니다.

조립 방식도 적어 둘 만합니다. 공개 서비스나 기업용 호스트라면 「호스트 주소 뒤에 소유자·저장소·이슈·번호」를 차례로 붙인 평범한 주소가 됩니다. 깃랩은 중간에 짧은 구분 기호가 하나 더 들어가 모양 자체가 달라지고요. 여기서 눈여겨볼 대목은 목록에 없는 낯선 호스트를 만나면 깃허브 방식으로 조립한다는 점입니다. 처음 보는 호스트라도 링크는 일단 만들어진다는 뜻이죠. 다만 그 주소가 실제로 열리는지는 별개입니다 — 「링크가 생겼다」와 「그 주소가 맞다」는 다른 이야기라서, 사내 저장소처럼 주소 규칙이 다른 곳이라면 한 번쯤 눌러 확인해 두는 편이 낫습니다.

아예 링크를 안 만드는 호스트도 있습니다. 비트버킷을 비롯한 몇몇 서비스가 그런데, 이 경우 참조는 평범한 글자로만 남습니다. 터미널이 링크를 지원하는지 확인이 안 될 때는 앞서 본 환경 변수로 켜거나 끌 수 있고요. 터미널이 키 입력을 안 보내 주는 경우처럼, 여기서도 클로드 코드가 아니라 터미널 쪽 사정인 경우가 섞여 있습니다.

자주 묻는 질문 (FAQ)

Q. 요청이 열려 있는데 배지가 안 보입니다

토큰 문제일 가능성이 큽니다. 공개 서비스나 기업용 호스트면 안내 문구가 뜨지만, 그 밖의 호스트에서는 아무 표시 없이 조용합니다. 호스트를 지정해 로그인해 두세요. 비필수 통신을 막는 설정을 켜 두셨다면 상태 확인 자체를 안 합니다.

Q. 깃랩인데 로그인해도 배지가 안 나옵니다

두 가지를 보세요. 토큰 환경 변수는 무시하므로 반드시 도구로 로그인해야 하고, 도구와 로그인 확인은 세션당 한 번뿐이라 켜 둔 채 설치·로그인하셨다면 클로드 코드를 다시 시작해야 합니다.

Q. 초록인데 왜 아직 병합이 안 되나요

어느 서비스인지 보세요. 깃허브에서 초록은 「승인됨」이고, 깃랩에서 초록은 「병합할 수 있는 상태」입니다. 승인과 병합 가능은 다른 조건이라 같은 색을 다르게 읽어야 합니다.

Q. 이슈 링크를 눌렀더니 엉뚱한 곳이 열립니다

주소를 지금 열어 둔 저장소의 호스트 기준으로 조립하기 때문입니다. 참조가 가리키는 저장소의 호스트가 아닙니다. 다른 서비스의 이슈를 언급할 때는 링크를 믿지 말고 직접 확인하세요.

정리하면

• 밑줄 색 네 가지가 상태입니다.
• 깃랩 초록은 병합 가능을 뜻합니다.
• 호스트에 따라 안내도 없습니다.
• 깃랩은 토큰 변수를 무시합니다.
• 이슈 링크는 내 호스트 기준입니다.

※ 공개된 대화형 모드 문서를 읽고 정리했습니다. 환경 변수와 명령 이름은 우리말로 풀어 적었으니 실제 표기는 원문에서 확인하세요.

※ 깃랩 배지에는 최소 판올림 조건이 있고, 링크가 만들어지는 호스트 목록도 판올림에 따라 달라질 수 있습니다. 원문과 대조해 확인하세요.