GLM-5.2 무료 API, NVIDIA NIM에서 Claude Code까지 5분 연동 가이드

⚡ 한 줄로 먼저 결론부터

지난 두 편—메이퇀 CatPaw 편, 알리 QoderWork 편—을 올린 뒤로 백엔드 DM이 꽤 많이 쌓였다. 그중 한 줄이 계속 머릿속에 남더라. 요지가 이랬다. 이 도구들 확실히 공짜긴 한데, 전부 한도가 있잖아. CatPaw는 500회, QoderWork는 2000크레딧에 30일. GLM-5.2 API를 한도 없이 공짜로 쓸 방법은 없냐고.

솔직히 첫 반응은 "그건 좀 무리한 주문이네"였다. 최상위 모델 API 호출에 드는 연산 비용은 현물로 보이는 숫자니까, 진짜 무한으로 풀어주는 호사가 어디에 있겠어.

그래도 한 번 찾아봤다. 있었다.

📰 공짜 열쇠가 있는 곳: build.nvidia.com의 무료 모델 77개

NVIDIA에는 build.nvidia.com이라는 개발자 플랫폼이 있다. 여기에 AI 모델 141개가 올라와 있고, 그중 77개가 무료 API 엔드포인트를 제공한다. 눈 찢어지는 거 맞다. 무료 모델이 77개다. DeepSeek-V4-Pro도 있고, Kimi-K2.6도 있고, MiniMax-M2.7도 있고, Qwen3.5도 있다.

GLM-5.2도 그 안에 있다. 라벨은 Free Endpoint에 Downloadable. 제공자는 Z.ai(지푸/智谱). 최신 모델 목록 1위로 떠 있고, 론칭 하루 만에 다운로드 200만을 찍었다.

이 무료 API는 앞의 두 글에서 다룬 도구들과 근본적으로 다르다. CatPaw와 QoderWork는 완성된 제품이다—다운받아 켜면 바로 쓸 수 있지만, 모델이 제품 내부에 캡슐화되어 있어서 그들의 UI 안에서만 부를 수 있다. 반면 NVIDIA가 주는 건 순수 API 엔드포인트다. OpenAI 포맷과 호환되어, 이 포맷을 지원하는 어떤 도구에든 꽂을 수 있다.

어떤 도구든. Claude Code도 포함해서.

여기까지 읽고 "API는 나랑 거리가 먼데, 난 프로그래머도 아닌데" 하는 사람 있을 거다. 조금만 더 내려가자. CC Switch라는 GUI 도구가 있어서 마우스 클릭 몇 번이면 설정을 전부 끝내준다.

🧬 파라미터 세 개: base_url, api_key, model

기술적인 바닥부터 짚자. NVIDIA 플랫폼의 GLM-5.2 모델 페이지를 열면 핵심 파라미터 세 개가 나열되어 있다.

프로그래머라면 여기서 끝이다—이 파라미터 세 개 들고 가서 OpenAI 호환 포맷으로 호출하면 그만. Python, Node, Shell 예제 코드는 페이지에 다 있다. 하지만 대부분의 사람은 프로그래머가 아니고 CLI를 만지고 싶지도 않다. 결국 NVIDIA가 주는 건 원자재지 완성품이 아니다. API Key를 손에 넣은 뒤에는 Claude Code에 꽂아도 되고, Cursor에 꽂아도 되고, VS Code의 온갖 AI 플러그인에 꽂아도 되며, 직접 짠 프로그램에 꽂아도 된다. 도구는 네가 고르고, 모델은 공짜고, 조합은 네가 정한다.

이게 진짜 자유도다. 다음 절에서 이 키를 어떻게 따는지, 그리고 Claude Code에 어떻게 꽂는지를 이어서 보자.

⚖️ 무료 삼형제와 그 대가

무료 루트 세 개를 한 테이블에 놓고 보면 차이가 한눈에 드러난다.

표를 보면 깔끔하다. CatPaw의 500회는 다 쓰면 리셋 신청서를 내고 심사를 기다려야 한다. QoderWork의 2000크레딧은 30일 유효 기간이 지나면 소멸하고, 댓글창 반응을 보면 한 달을 채우기도 전에 동난다는 사람이 많다. 반면 NVIDIA는 한도 없는 마스터키를 그냥 준다. 검증 페이지에 적힌 문구는 Unlimited API requests without daily limits, 일일 요청 상한이 없다.

물론 "무한"이라는 말에는 물음표를 붙여야 한다—공짜엔 보통 숨은 제약이 따라온다. NVIDIA 무료 티어의 잘 알려진 문제가 하나 있다: 피크 시간대엔 느리다. 이건 나만의 느낌이 아니다. 해외 개발자 커뮤니티 반응을 보면, 혼잡 시간대에는 요청이 대기열에 쌓이거나 아예 429로 연결이 떨어지고, 응답 시간이 몇 초에서 10여 초, 심하면 그 이상까지 늘어난다. Threads에서 누군가 아주 직설적으로 써놓더라—Peak hours, you queue up and wait, 번역하면 "대기열에 서서 기다려라". 반대로 비피크 시간대 체감은 괜찮은 편이라 새벽이나 주말에 돌리는 작업은 속도가 제법 나온다. 다만 평일 낮에 고빈도 호출을 안정적으로 버텨줄 거라 기대하면 크게 실망할 것이다.

그리고 하나 더 분명히 짚고 가야 한다: GLM-5.2는 결국 Claude가 아니다. Claude의 시스템 프롬프트도, 대화 페르소나도, 복잡한 장거리 추론에서의 안정성도 갖고 있지 않다. CC Switch로 Claude Code에 꽂은 뒤에는 화면이 똑같아 보이지만, 답변의 맛은 다르다. 어떤 작업은 기대보다 나을 때도 있고, 어떤 작업은 기대보다 못할 때도 있다. 구체적으로 어디가 강하고 어디가 약한지는 본인이 실제 프로젝트 몇 개를 직접 돌려봐야 판단할 수 있다—타인의 평가가 본인 체감을 대신해주지는 않는다.

🛠️ 5분 만에 키 따기 + Claude Code에 연동하기

첫 번째 단계: 5분 만에 API Key 따기

build.nvidia.com을 열고 가입한다. Google이나 GitHub 계정이 있다면 그걸로 바로 로그인하면 된다. 가입 후 API Key를 생성하려면 휴대전화 인증이 필요한데—여기가 핵심: 중국 본토 번호를 지원한다. Location 드롭다운에서 China를 고르고 +86 번호를 넣은 뒤 Send Code to Phone을 누르면, 폰으로 6자리 인증번호가 온다. 그걸 입력하면 인증 완료.

이 단계에서 중국 번호는 안 될 거라 짐작하는 사람이 많은데, 전혀 문제없다. 직접 돌려봤고, 문자가 몇 초 만에 도착했다.

휴대전화 인증까지 끝내면 우측 상단의 개인 센터에서 API Keys 관리 페이지로 들어가 Generate API Key를 누른다. 키 이름을 정한다—예컨대 freeapi—그러면 nvapi-로 시작하는 문자열이 생성된다. 이 키는 한 번만 보여준다. 페이지를 닫으면 두 번 다시 볼 수 없으니 그 자리에서 바로 복사해둬야 한다.

유효기간이 보이는가—2027년 7월 5일. 내가 1년으로 잡은 기한이다. 평생 만료 없음 옵션도 있지만, 이벤트가 언제 "전원 컷"을 당할지 모르니 1년이 더 안전하다. 이 엔드포인트는 NVIDIA의 글로벌 인프라 위에서 돌아간다. 지역 잠금도, VPN도 필요 없다. 해외(일본 포함) 개발자라면 이메일 하나로 가입해서 바로 쓸 수 있다.

두 번째 단계: CC Switch로 Claude Code에 연동

키를 땄다. 다음이 핵심 단계다: 이 키를 실제로 어떻게 쓸 것인가.

프로그래머라면 파라미터 세 개 들고 OpenAI 호환 API를 바로 호출하면 그만. 하지만 대부분은 CLI를 만지고 싶지 않다—바로 여기서 CC Switch가 제 몫을 한다. Claude Code의 밑단 모델을 갈아끼우는 GUI 기반 공급자 관리 도구다. 열면 공급자 리스트가 빽빽하게 깔리는데, SiliconFlow, OpenRouter, GitHub Copilot, Codex까지 수십 개가 있고 NVIDIA도 그중 하나다. 리스트에서 Nvidia 파란 버튼을 누르면 요청 주소가 자동으로 채워지고, 네가 할 일은 API Key만 붙여넣는 것이다.

설정 포인트는 네 가지다.

1. API Key: 네 nvapi- 키를 넣는다.
2. 요청 주소: https://integrate.api.nvidia.com. 이건 CC Switch가 이미 채워뒀다.
3. API 포맷: 반드시 OpenAI Chat Completions(라우팅 활성화 필요)을 고른다. 이걸 고르지 않으면 요청 포맷이 맞지 않는다.
4. 모델 매핑(가장 중요): Sonnet, Opus, Haiku 세 역할을 전부 z-ai/glm-5.2로 매핑한다. 이렇게 하면 Claude Code가 어떤 모델 역할로 요청을 보내든 실제로는 GLM-5.2가 돌아간다.

저장한 뒤 Claude Code를 열고 /model을 입력하면, 예전에 Sonnet 4.6과 Opus라고 적혀 있던 자리가 전부 z-ai/glm-5.2로 바뀌어 있다. "Custom Sonnet model"을 선택하고 hi를 쳐서 테스트.

파이프라인이 뚫렸다.

지금 네가 가진 건 Claude Code의 인터페이스 전체와 에이전트 워크플로 전부이되, 밑단에서 도는 건 NVIDIA가 공짜로 풀어놓은 GLM-5.2다. Claude Code의 멀티 파일 편집, 자동화 실행, 컨텍스트 관리, 툴 호출 기능은 그대로 살아 있고, 추론 엔진만 GLM-5.2로 바뀐 것이다. 네가 말 안 하면 밖에서 절대 모른다—터미널엔 여전히 Claude Code 로고가 뜨고, 인터랙션도 같고, /model 명령도 같다. 하지만 대화 한 번 한 번이 전부 NVIDIA의 GPU 클러스터를 타고, 지푸의 GLM-5.2를 부른다.

🌍 공짜 뒤에 있는 비즈니스: 3개 층, 같은 모델

세 편을 쓰면서 내가 말하고 싶었던 건 이미 GLM-5.2라는 모델 하나가 아니다. 세 편을 나란히 놓고 보면 선명한 3층 구조가 보인다.

• 첫째 층, 애플리케이션 층—메이퇀과 알리. 이들은 GLM-5.2를 자기 제품에 쑤셔넣는다(CatPaw는 IDE, QoderWork는 데스크톱 단짝). 무료 모델로 최종 사용자를 모은다. 모델이 쓸만한지는 제품 자체가 얼마나 잘 만들어졌는지에 크게 달려 있다.
• 둘째 층, 인프라 층—NVIDIA. GLM-5.2를 자사 GPU 클라우드에 올려 무료 API 엔드포인트로 푼다. 무료 연산으로 개발자를 모은다.
• 셋째 층, 모델 층—지푸 본인. GLM-5.2를 MIT 라이선스로 완전히 오픈해서 누구나 배포하게 둔다.

세 층, 세 가지 비즈니스 논리, 서로 전혀 다른 종류의 "공짜". 하지만 그 아래로 흐르는 건 같은 하나다.

NVIDIA는 왜 이 짓을 하는가? 모델 회사도 아닌데. NVIDIA의 사업이 뭔지 생각해보자—GPU를 판다. H200이나 B200 같은 AI 칩은 한 개당 수만 달러다. NVIDIA의 최대 고객은 대규모 추론 연산이 필요한 기업들이다. 무료 API라는 건, 겉으로는 NVIDIA가 돈을 보태 남의 모델을 돌려주는 것처럼 보이지만, 실제로는 한 가지 일을 하는 중이다—더 많은 개발자가 NVIDIA 인프라 위에서 코드를 짜고, 모델을 테스트하고, 프로토타입을 만들게 두는 것. 일단 이 플랫폼에서 프로젝트가 돌아가기 시작하면, 프로덕션으로 올릴 때 가장 자연스러운 선택지는 NVIDIA GPU를 사거나 NVIDIA 유료 추론 서비스를 쓰는 것이다.

이건 예전엔 상상도 못 할 일이었다. 과거의 모델은 닫혀 있었다—GPT-4는 OpenAI 플랫폼에서만, Claude는 Anthropic 플랫폼에서만 쓸 수 있었고, 누구의 모델을 쓰려면 그 생태계 안으로 들어가야 했다. GLM-5.2는 이 규칙을 부순다—MIT 오픈소스라 누구나 가져다 쓸 수 있다. 그래서 메이퇀은 IDE를 만들고, 알리는 오피스 도구를 만들고, NVIDIA는 무료 API로 트래픽을 끌어모은다. 제 각기 같은 모델로 자기 사용자 진입점을 쟁취하지만, 이 모델을 소유한 곳은 아무도 없다.

지푸가 한 일은 영리하다: 대기업과 최종 사용자를 두고 정면으로 싸우지 않고, 수원(水源)이 된다. 누구든 물을 끌어다 쓰게 둔다, 물은 공짜다. 하지만 모든 사람의 논에 흐르는 물이 내 물인 한, 이 강 자체가 인프라가 된다—이걸 우회하려면 직접 우물을 파야 한다. 오픈소스 모델의 진짜 힘은 "공짜" 그 자체가 아니라, 모든 경쟁자를 너의 유통 채널로 만든다는 데 있다. 네가 더 열수록, 남들은 더 빠져나갈 수 없다.

1911년, 스탠다드 오일은 미국 대법원에서 독점 판결을 받고 34개의 독립 회사로 강제 분할됐다. 당시 월가는 아우성이었고, 모두가 록펠러는 끝났다고 생각했다. 아이러니하게도 이 34개 회사는 각자 석유업계의 거인으로 자라났다—엑슨, 모빌, 셰브론, 아모코, 하나같이 포춘 500 기업이다. 록펠러는 분할된 회사들의 원시 주식을 전부 보유하고 있어서, 개인 재산이 분할 전보다 오히려 몇 배로 불었다.

하나를 쪼개서 흩뿌리는 게 때로는 통제를 잃는 게 아니다. 그걸 모두가 의존하지 않을 수 없는 인프라로 키우는 일이다.

📝 마무리

이벤트가 살아있는 동안 build.nvidia.com에서 가입부터 해두자. 어차피 공짜고 5분이면 끝나며, 남은 설정은 CC Switch가 클릭 한두 번으로 마무리해준다.

GLM-5.2 무료 삼부작—메이퇀은 제품 층, 알리도 제품 층, NVIDIA는 인프라 층. 한 층씩 아래로 파고들었다. 네가 필요한 게 어느 층인지는 네가 고르면 된다.

본문의 조작 단계와 페이지 스크린샷은 모두 필자가 직접 실측한 것입니다(2026년 7월 기준). 무료 티어 한도, 속도 제한, 이벤트 유효 기간은 언제든 조정될 수 있으므로 build.nvidia.com 공식 페이지를 기준으로 삼아 주세요. 글의 견해는 필자 개인의 것입니다.