AI 코딩 도구 써보셨나요? Claude Code나 Cursor 같은 도구들이 정말 편하긴 한데... 가격 보고 놀라신 분들 많으실 거예요.
"Claude Max가 월 200달러...?" 😱
그런데 말이죠, 월 3달러로 비슷한 수준의 AI 코딩 어시스턴트를 쓸 수 있다면 어떨까요?
오늘은 중국 AI 기업 Z.ai(구 Zhipu AI)에서 만든 GLM 4.7 모델을 Claude Code와 OpenCode에 연동하는 방법을 A to Z로 알려드릴게요.
1. GLM 4.7이 뭔가요?
GLM 4.7은 중국의 AI 기업 Z.ai(구 Zhipu AI)에서 2024년 12월 22일에 출시한 최신 대규모 언어 모델이에요.
핵심 스펙
| 항목 | 내용 |
| 파라미터 | 약 3,550억 개 (활성화: 320억) |
| 컨텍스트 윈도우 | 200,000 토큰 |
| 최대 출력 | 128,000 토큰 |
| 추론 속도 | 초당 55 토큰 |
| 아키텍처 | MoE (Mixture of Experts) |
주요 특징
🧠 Thinking 기능
- 답변 전에 "생각"하는 과정을 거쳐요
- 복잡한 코딩 작업에서 더 정확한 결과를 내놓죠
🔧 에이전틱 코딩에 최적화
- Claude Code, Cline, Roo Code 같은 코딩 에이전트와 잘 맞아요
- 여러 단계의 작업도 안정적으로 수행해요
💰 오픈 웨이트
- 모델 가중치가 공개되어 있어서 로컬에서도 돌릴 수 있어요
- Hugging Face에서 다운로드 가능!
2. 왜 GLM 4.7을 써야 할까요?
벤치마크 성능
GLM 4.7은 주요 코딩 벤치마크에서 Claude Sonnet 4.5와 비슷하거나 더 좋은 성능을 보여줘요.
| 벤치마크 | GLM 4.7 | Claude Sonnet 4.5 |
| SWE-bench Verified | 73.8% | ~72% |
| LiveCodeBench v6 | 84.9% | ~82% |
| τ²-Bench (도구 사용) | 87.4% | - |
가격 비교 (핵심!)
여기가 진짜 중요한 부분이에요.
| 서비스 | 월 가격 | 5시간당 프롬프트 |
| Claude Max 5x | $100 | ~200개 |
| Claude Max 20x | $200 | ~800개 |
| GLM Coding Lite | $3 | ~120개 |
| GLM Coding Pro | $15 (분기당 $41) | ~600개 |
| GLM Coding Max | $30 (분기당 $81) | ~2,400개 |
3달러로 Claude Pro($20)의 약 3배 사용량을 얻을 수 있어요! 🎉
3. 사전 준비: API 키 발급받기
GLM 4.7을 사용하려면 먼저 Z.ai에서 API 키를 발급받아야 해요.
Step 1: Z.ai 회원가입
- Z.ai 공식 사이트에 접속해요
- 우측 상단 Sign Up 클릭
- 이메일 또는 소셜 계정으로 가입
Step 2: GLM Coding Plan 구독 (선택)
방법 A: 구독 플랜 사용 (추천)
- Z.ai 구독 페이지로 이동
- 원하는 플랜 선택:
- Lite: $3/월 (입문용)
- Pro: 약$40/분기 (중급 사용자)
- Max: 약$80/분기 (헤비 유저)
- 결제 정보 입력 후 구독 완료
방법 B: API 종량제 사용
구독 없이 사용한 만큼만 내고 싶다면 API 종량제도 가능해요.
- 입력: 100만 토큰당 $0.16
- 출력: 100만 토큰당 $0.80
Step 3: API 키 생성
- Z.ai API 키 관리 페이지로 이동
- Create new key (또는 "Add New Key") 클릭
- 키 이름 입력 후 생성
- ⚠️ 중요: 생성된 키를 바로 복사해서 안전한 곳에 저장하세요!
- 키는 한 번만 표시되고, 다시 볼 수 없어요
예시 키 형태: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
4. Claude Code에 GLM 4.7 연동하기
이제 본격적으로 연동해볼게요. Claude Code가 뭔지 모르시는 분들을 위해 간단히 설명하면, Anthropic에서 만든 터미널 기반 AI 코딩 어시스턴트예요.
Step 1: Claude Code 설치
먼저 Node.js가 설치되어 있어야 해요. 없다면 Node.js 공식 사이트에서 설치하세요.
# Claude Code 전역 설치
npm install -g @anthropic-ai/claude-code
Step 2: 설정 파일 수정
Claude Code의 설정 파일을 수정해서 Z.ai API를 사용하도록 바꿔줄게요.
macOS/Linux:
# 설정 파일 열기
nano ~/.claude/settings.json
Windows:
메모장으로 %USERPROFILE%\.claude\settings.json 파일 열기
Step 3: 설정 내용 입력
아래 내용을 settings.json에 입력하세요:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "여기에_Z.ai_API_키_입력",
"ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
"API_TIMEOUT_MS": "3000000",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
}
}
각 항목 설명:
| 키 | 설명 |
| ANTHROPIC_AUTH_TOKEN | Z.ai에서 발급받은 API 키 |
| ANTHROPIC_BASE_URL | Z.ai의 Anthropic 호환 엔드포인트 |
| API_TIMEOUT_MS | 타임아웃 시간 (밀리초) |
| ANTHROPIC_DEFAULT_SONNET_MODEL | 기본 모델을 GLM 4.7로 설정 |
Step 4: Claude Code 실행
# 프로젝트 디렉토리로 이동
cd your-project
# Claude Code 실행
claude
Step 5: 연동 확인
Claude Code 안에서 /status 명령어를 입력하면 현재 사용 중인 모델을 확인할 수 있어요.
> /status
glm-4.7이 표시되면 성공이에요! 🎉
5. OpenCode에 GLM 4.7 연동하기
OpenCode는 오픈소스 AI 코딩 에이전트예요. Claude Code와 비슷하지만 더 유연하게 여러 모델을 지원하죠.
Step 1: OpenCode 설치
# npm으로 설치
npm install -g opencode-ai
# 또는 설치 스크립트 사용
curl -fsSL https://opencode.ai/install.sh | bash
Step 2: 인증 설정
# OpenCode 인증 로그인
opencode auth login
실행하면 프롬프트가 나와요:
┌ Add credential
│
◆ Select provider
│ ● Z.AI Coding Plan ← 이거 선택!
│ ○ Z.AI
│ ○ OpenAI
│ ○ Anthropic
│ ...
└
Z.AI Coding Plan을 선택하고, 발급받은 API 키를 입력하세요.
Step 3: OpenCode 실행
# OpenCode 시작
opencode
Step 4: 모델 선택
OpenCode 안에서 /models 명령어를 입력하면 사용 가능한 모델 목록이 나와요.
> /models
목록에서 GLM-4.7을 선택하세요.
대안: 설정 파일로 직접 설정
opencode.json 파일을 프로젝트 루트에 만들어서 설정할 수도 있어요:
{
"provider": {
"zai": {
"apiKey": "여기에_API_키_입력",
"baseUrl": "https://api.z.ai/api/anthropic"
}
},
"model": "zai/glm-4.7"
}
6. 연동 후 확인 & 트러블슈팅
연동이 잘 됐는지 확인하는 방법
Claude Code:
claude
> /status
# GLM-4.7이 표시되면 성공!
OpenCode:
opencode
> /models
# GLM-4.7 선택되어 있으면 성공!
자주 발생하는 문제와 해결법
문제 1: "API key invalid" 에러
원인: API 키가 잘못 입력됨
해결:
- Z.ai 대시보드에서 키가 활성 상태인지 확인
- 키에 앞뒤 공백이 있는지 확인
- 새 키를 발급받아 다시 시도
문제 2: 설정 변경이 적용 안 됨
해결:
- 모든 Claude Code / OpenCode 창 닫기
- 새 터미널 열기
- 다시 실행
# Claude Code의 경우
rm ~/.claude/settings.json # 기존 설정 삭제
# 다시 설정 파일 생성
문제 3: 연결 타임아웃
해결: API_TIMEOUT_MS 값을 늘려보세요
{
"env": {
"API_TIMEOUT_MS": "5000000"
}
}
문제 4: JSON 파싱 에러
해결: JSON 유효성 검사 도구에서 설정 파일 검사
7. 요금제 비교: 진짜 얼마나 저렴할까?
Claude vs GLM Coding Plan 상세 비교
| 항목 | Claude Pro | Claude Max 5x | GLM Lite | GLM Pro |
| 월 가격 | $20 | $100 | $3 | ~$40 |
| 5시간당 사용량 | ~40개 | ~200개 | ~120개 | ~600개 |
| 비용 대비 효율 | 기준 | 5x | 18x | 30x |
연간 비용 계산
예를 들어, 현재 Claude Max 5x ($100/월)를 쓰고 있다면:
- Claude Max 5x 연간: $100 × 12 = $1,200
- GLM Coding Pro 연간: $40 × 4 = $160
- 절감액: $1,080/년 💰
어떤 플랜을 선택해야 할까?
| 사용 패턴 | 추천 플랜 |
| 취미 개발자, 가끔 코딩 | GLM Lite ($3/월) |
| 일반 개발자 | GLM Pro (약$40/분기) |
| 헤비 유저, 에이전트 자주 사용 | GLM Max (약$80/분기) |
| 기업, 안정성 최우선 | Claude Max + GLM Pro 병행 |
8. 실제 사용 후기
장점 👍
1. 가성비 끝판왕
"월 3달러에 이 정도면... 진짜 가격 파괴예요."
2. Claude Code와 완벽 호환
"설정만 바꾸면 기존 워크플로우 그대로 쓸 수 있어요."
3. 코딩 성능 준수
"프론트엔드 UI 생성이 특히 깔끔해요. Vibe Coding에 강점이 있네요."
4. Thinking 모드
"복잡한 리팩토링 작업할 때 생각 과정이 보여서 신뢰가 가요."
단점 👎
1. 속도가 조금 느릴 수 있음
"Claude Sonnet보다 응답이 약간 느릴 때가 있어요."
2. 특정 프레임워크 지식 부족
"최신 프레임워크(Tailwind 최신 버전 등)는 좀 헤맬 때 있어요."
3. 영어가 아닌 언어 지원
"한국어 주석이나 변수명이 많으면 가끔 이상한 결과가 나와요."
꿀팁 🍯
- 간단한 작업은 Thinking 끄기: 단순 질문에는 thinking 모드 비활성화로 속도 UP
- 복잡한 작업은 GLM 4.7, 단순 작업은 GLM-4.5-Air 사용: 비용 절감
- Claude와 병행 사용: 중요한 프로젝트는 Claude, 일상적 작업은 GLM으로
9. 마무리
핵심 정리 ✨
- GLM 4.7은 뭐다?: Z.ai의 최신 AI 모델, 코딩에 특화
- 왜 쓰나?: Claude 급 성능인데 가격은 1/30
- 어떻게 쓰나?: settings.json만 수정하면 끝
- 누가 쓰면 좋나?: 비용 효율을 중시하는 개발자, 취미 개발자
시작하기 체크리스트
- [ ] Z.ai 회원가입
- [ ] GLM Coding Plan 구독 (또는 API 종량제)
- [ ] API 키 발급
- [ ] Claude Code 또는 OpenCode 설치
- [ ] 설정 파일 수정
- [ ] /status로 연동 확인
- [ ] 코딩 시작! 🚀
관련 링크 모음
'AI > AI 에이전트' 카테고리의 다른 글
| AI 에이전트 손과 발, MCP가 뭔가요? (0) | 2026.01.24 |
|---|---|
| 프롬프트 5종 세트로 “AI 결과물 퀄리티” 고정시키기 (0) | 2026.01.23 |
