직원 화면의 AI 비용과 회사 청구서가 다른 숫자였던 자리

회사가 AI 도구를 관문 하나로 모읍니다.
직원 계정을 그 관문에 붙이고, 회사는 관문에서 협상한 단가로 요금을 냅니다.

그러면 직원이 화면에서 보는 비용과 회사가 실제로 내는 요금이 다른 숫자가 됩니다. 직원 화면은 공개 요금표로 계산하고, 회사는 다른 단가로 내기 때문입니다.

9월 11일 새벽에 나온 Claude Code 2.1.268 은 그 자리를 맞췄습니다. 같은 판에 열린 문을 조용히 두지 않게 했고, 비밀값이 새던 자리 셋을 막았습니다. 대표가 가져갈 것은 기능이 아니라 세 칸입니다.

변경 기록에 이런 줄이 있습니다.
직원 화면의 비용을 회사 계량기에 맞춘 자리입니다.

"Added to the Claude apps gateway: with `pricing:` set in `gateway.yaml`, signed-in Claude Code clients receive the same rates through managed settings, so `/cost` and telemetry match the spend meter"

풀어 쓰면 이렇습니다. 관문 설정에 요금표를 적어 두면, 로그인한 직원의 도구가 같은 단가를 받아 갑니다. 직원이 화면에서 보는 비용과 회사 계량기가 같은 숫자가 됩니다.

이 줄이 뜻하는 것은 하나입니다. 그 전까지는 둘이 달랐다는 것입니다. 직원은 공개 요금표로 계산된 숫자를 보고 있었고, 회사는 관문 단가로 내고 있었습니다.

상담에서 이 자리는 도입 전에 먼저 나옵니다. 금융 서비스를 만들려는 대표님의 첫 문의입니다.

「가늠이 안 된다」는 도입 전의 문제입니다. 도입 뒤에는 더 나쁜 상태가 옵니다. 숫자가 둘 보이는데 어느 쪽이 청구서인지 모르는 상태입니다.

직원이 보는 숫자가 청구서보다 낮으면 직원은 넉넉하게 씁니다. 높으면 아끼는 척을 합니다. 어느 쪽이든 회사는 실제 소모를 모른 채 냅니다.

단가만 맞춘다고 끝나지 않습니다.
직원이 보는 숫자와 실제 소모가 갈리는 자리가 하나 더 있습니다.

저희 실측이 있습니다. 9월 10일, 다른 AI 도구의 주간 한도가 왜 이렇게 빨리 닳는지를 7일치 세션 기록 244개로 셌습니다.

입력 토큰이 7일에 22억이었습니다. 그중 97.8퍼센트가 캐시로 다시 읽힌 것이었고, 사람이 실제로 받은 출력은 680만이었습니다. 화면에서 보이는 것은 출력이고, 한도를 깎는 것은 입력이었습니다.

원인은 단가가 아니라 곱셈이었습니다. 요청 한 번에 평균 11만 3천 토큰의 맥락을 다시 보냈고, 그 요청이 7일에 1만 3천 6백 번이었습니다. 입력의 76퍼센트가 맥락 10만 초과 요청에서 나왔습니다.

상담에서 같은 결의 질문이 나온 적이 있습니다. 여러 에이전트를 나눠 돌리려는 대표님께 저희가 먼저 짚은 자리입니다.

대표님은 요금이 안 나가는 로컬 모델을 쓰니 비용이 0이라고 보셨습니다. 맞는 말이면서 틀린 말입니다. 돈은 0이어도 에이전트끼리 맥락을 주고받는 양은 그대로 소모됩니다.

이번 판이 맞춘 것은 단가입니다. 소모량은 여전히 회사가 재야 합니다. 관문에 요금표를 적은 뒤에도, 어떤 직원의 어떤 세션이 얼마나 큰 맥락을 몇 번 보내는지는 회사 계량기가 있어야 보입니다.

같은 판에 관문의 문에 대한 줄이 둘 있습니다.
하나는 경고의 자리, 하나는 잠금의 자리입니다.

"Added a startup warning for gateways when `access_control.allow_cidrs` is empty, and a one-time warning the first time a request arrives from a public address"

관문을 켤 때 허용할 주소 목록이 비어 있으면 경고합니다. 그리고 공개 인터넷에서 첫 요청이 들어오면 한 번 알립니다. 열린 문을 조용히 두지 않겠다는 뜻입니다.

"Added the `gatewayInternalNetworks` managed setting, letting administrators allow `/login` to a Claude apps gateway on their organization's own public IPv4 block"

두 번째 줄은 회사 공인 주소 대역에서만 로그인되게 하는 설정입니다. 「누가 들어올 수 있나」를 회사가 적는 칸이 생긴 것입니다.

저희가 고객 연동을 만들 때 문을 어떻게 두는지 보여 주는 장면이 있습니다. 화상회의 연결이 안 된다는 문의에, 대표님이 직접 원인을 정리해 보내 주신 내용입니다.

연결이 막힌 이유는 문이 닫혀 있어서였습니다. 확인 값이 없는 요청은 전부 거부하도록 만들어 뒀고, 그날은 그 문이 정상 요청까지 막았습니다.

불편했지만 방향은 맞습니다. 열어 두고 조용한 것보다 닫아 두고 시끄러운 쪽이 쌉니다.

회사 관문, 관리 콘솔, 봇 주소마다 같은 칸이 있습니다. 허용 목록이 비어 있는 것은 막지 않은 상태가 아닙니다. 열어 둔 상태입니다.

이번 판이 막은 자리는 셋입니다.
셋 다 사람이 화면에서 읽는 글자였습니다.

"Fixed plugin and marketplace errors showing a token or password from a git source URL"

플러그인을 설치하다 실패하면 오류 메시지에 설치 주소가 찍혔습니다. 그 주소 안에 토큰이나 비밀번호가 들어 있으면 그대로 화면에 나왔습니다.

"Fixed `/mcp` and `/plugin` server details, `claude mcp list`/`get`, and MCP login errors showing secrets resolved from `${VAR}` placeholders in MCP configs"

두 번째는 목록 화면입니다. 설정 파일에는 비밀값을 변수 이름으로 숨겨 뒀는데, 연결 목록을 열면 그 변수가 풀린 실제 값이 보였습니다. 세 번째는 로그인 오류에 시크릿이 실리던 자리입니다.

저희 상담 기록에 이 자리가 실제로 어떻게 생기는지 보여 주는 장면이 있습니다. 대표님이 연동 인증을 마치고, 완료 화면을 그대로 채널에 붙여 넣으신 날입니다.

그 아래에 접근 토큰과 갱신 토큰 원문이 이어졌습니다. 담당자만 보라고 적어 둔 화면이었지만, 대표님은 화면 전체를 복사해 상담 채널에 올리셨습니다. 그 순간 비밀값은 채팅 기록에 남았습니다.

대표님 잘못이 아닙니다. 「캡처해서 보내 달라」고 한 것은 저희였고, 비밀값을 사람이 읽는 화면에 띄운 것도 저희였습니다. 오류 화면, 완료 화면, 목록 화면에 무엇이 찍히는지는 만든 쪽이 정하는 것입니다.

직원이 오류 화면을 캡처해 공유하는 순간 유출이 됩니다. 비밀은 금고에서 새지 않습니다. 화면에서 샙니다.

도구가 요금표를 맞추고, 빈 목록에 경고하고, 오류에서 비밀을 지웠습니다.
그래도 회사 쪽 칸은 비어 있습니다.

비용을 먼저 정해 달라는 요청은 상담에서 이렇게 옵니다.

맞는 순서입니다. 숫자를 먼저 같은 자리에 놓고 시작하면, 뒤에 「내가 본 것과 다르다」가 없습니다.

도구 안의 비용도 같습니다. 직원 화면 단가와 청구 단가가 같은 계량기에서 나오는지 도입 첫날 확인합니다.

문은 관문 하나로 끝나지 않습니다. 관리 콘솔, 봇 주소, 사내 자동화의 입구마다 「누가 들어올 수 있나」 칸이 있고, 비어 있으면 열어 둔 것입니다. 도구는 이제 경고하지만, 채우는 것은 회사입니다.

오류 메시지는 직원이 가장 자주 캡처하는 화면입니다. 그 화면에 주소와 토큰이 찍히는지 한 번 보는 것은 도구를 고르는 일이 아니라 화면을 열어 보는 일입니다.

대표님이 가져갈 칸은 셋입니다.

비용은 「보이는 숫자」와 「내는 숫자」가 같은 계량기에서 나오는지 도구마다 확인한다.
관문·콘솔·봇 주소마다 「누가 들어올 수 있나」를 비워 두지 않는다.
오류 화면·로그·채팅 알림에 주소나 토큰이 그대로 찍히는지 한 번 본다.

정리

경고 신호

• 직원이 화면에서 보는 AI 비용과 회사 청구서의 단가가 같은지 확인한 적이 없다

• 어떤 세션이 얼마나 큰 맥락을 몇 번 보내는지 회사 쪽 계량기가 없다

• 관문·콘솔·봇 주소의 허용 목록이 비어 있고, 그것을 「막지 않은 것」으로 부른다

• 오류 화면에 무엇이 찍히는지 본 적 없이 직원이 캡처를 공유한다

좋은 신호

• 도구마다 「직원 화면 단가 = 청구 단가」를 도입 첫날 확인한 기록이 있다

• 출력이 아니라 입력 소모량을 세션 단위로 세는 계량기가 회사 쪽에 있다

• 입구마다 허용 목록이 채워져 있고, 비어 있으면 알림이 온다

• 오류 화면·로그·완료 화면에 주소와 토큰이 찍히지 않는 것을 직접 열어 확인했다

관문을 켜기 전에 정할 네 가지

1. 직원 화면의 비용과 청구서의 단가가 같습니까?
   다르면 직원은 아끼는 척만 하고, 회사는 실제 소모를 모른 채 냅니다.

2. 출력이 아니라 입력을 세고 있습니까?
   저희 실측에서 둘은 300배 넘게 달랐습니다.

3. 허용 목록이 비어 있는 입구가 몇 개입니까?
   비어 있는 것은 막지 않은 것이 아니라 열어 둔 것입니다.

4. 오류 화면을 캡처하면 무엇이 같이 찍힙니까?
   주소와 토큰이 찍히면 공유하는 순간 유출입니다.

자주 묻는 질문

Q. 관문 요금표를 적으면 직원 화면의 비용이 정확히 어떻게 바뀝니까?

변경 기록은 관문 설정에 요금표를 적어 두면 로그인한 도구가 관리 설정을 통해 같은 단가를 받고, 비용 명령과 텔레메트리가 회사의 소비 계량기와 일치한다고 적습니다. 직원이 따로 손댈 것은 없고, 관문 쪽에서 적는 칸입니다.

Q. 허용 주소 목록이 비어 있으면 이제 어떻게 됩니까?

변경 기록은 관문이 시작할 때 경고를 내고, 공개 주소에서 첫 요청이 오면 한 번 더 경고한다고 적습니다. 막아 주는 것이 아니라 알려 주는 것입니다. 목록을 채우는 것은 여전히 회사 몫입니다.

Q. 회사 공인 IP 대역에서만 로그인되게 하는 설정은 무엇입니까?

변경 기록은 gatewayInternalNetworks 라는 관리 설정이 추가됐고, 관리자가 조직의 공인 IPv4 대역에서 관문 로그인을 허용할 수 있게 한다고 적습니다.

Q. 비밀값이 새던 자리 셋은 정확히 어디입니까?

플러그인·마켓플레이스 오류 메시지에 git 주소의 토큰이나 비밀번호가 찍히던 것, 연결 목록 화면과 목록 명령이 변수로 숨겨 둔 비밀을 풀어서 보여 주던 것, MCP 로그인 오류에 시크릿이 실리던 것입니다. 셋 다 2.1.268 에서 고쳐졌다고 적혀 있습니다.

Q. 2.1.268 은 언제 나왔습니까?

npm 게시 시각 기준 2026년 9월 10일 18:41 UTC, 한국 시각 9월 11일 새벽 3시 41분입니다. 확인 시점의 최신 버전은 다음 날 나온 2.1.269 였습니다.