오픈클로 사용법을 제대로 알아두지 않으면 앤트로픽(Anthropic)의 구독 지원 중단 이후 갑자기 쓸 수 없는 상황에 맞닥뜨리게 됩니다. 오픈클로(OpenClaw)는 로컬 기반 AI 에이전트(Agent) 프레임워크로, 구독 없이도 API 키 하나만 있으면 얼마든지 계속 이용할 수 있습니다. 이 글에서는 구독 중단 이후에도 오픈클로를 끊김 없이 활용하는 5단계 방법을 실전 중심으로 알려드립니다.
1. 오픈클로(OpenClaw)란 무엇인가, 왜 구독이 막혔나
오픈클로(OpenClaw)는 오스트리아 개발자 피터 스타인버거(Peter Steinberger)가 2025년 11월에 출시한 오픈소스(MIT 라이선스) 기반의 개인용 AI 에이전트 실행 프레임워크입니다. 내 컴퓨터에 직접 설치해서 사용하는 방식이기 때문에 데이터가 외부 서버로 전송되지 않는다는 점이 가장 큰 특징이고, 그래서 많은 사람들이 업무 자동화 도구로 적극 사용해왔죠.
그런데 2026년 초, 앤트로픽은 오픈클로와 같은 타사 도구에서 클로드(Claude) 구독을 사용하는 것을 공식 차단했습니다. 클로드 코드(Claude Code) 책임자 보리스 체르니가 직접 SNS를 통해 “타사 도구의 사용 패턴을 고려해 설계된 것이 아니다”라고 밝혔는데요. 쉽게 말하면, 오픈클로를 통해 클로드 구독 계정에 과도한 부하가 걸리는 현상이 발생했고 앤트로픽 측이 용량 관리를 위해 제한을 건 겁니다.
이게 오픈클로를 영구적으로 사용하지 못하게 막는 건 아닙니다. 앤트로픽 개발자 플랫폼을 통한 별도 API(Application Programming Interface, 응용 프로그램 인터페이스) 방식은 여전히 허용됩니다. 실제로 지인 한 명이 “구독 막혔다는 말에 엄청 당황했는데 API 방식으로 연결하니 전혀 문제없이 쓴다”며 안도하더라고요. 방법을 알면 별것 아닙니다.
| 구분 | 클로드 구독 방식 | API 키 방식 |
|---|---|---|
| 오픈클로 연동 가능 여부 | ❌ 2026년 이후 차단 | ✅ 현재도 정상 사용 가능 |
| 요금 방식 | 월정액 구독 | 사용량 기반 종량제 |
| 설정 난이도 | 쉬움 | 약간의 초기 설정 필요 |
| 데이터 보안 | 클라우드 경유 | 로컬 처리 가능 |
2. 앤트로픽 콘솔에서 API 키 발급받기
오픈클로 사용법의 핵심 첫 단추는 앤트로픽 API(Anthropic API) 키를 발급받는 것입니다. 어렵게 생각할 필요 없이 순서대로 따라오면 5분이면 충분합니다. 우선 console.anthropic.com에 접속합니다. 계정이 없다면 가입 먼저 해야 하는데, 구독 계정과는 별도의 개발자 콘솔 계정입니다.
API 키 발급 상세 절차
로그인 후 상단 메뉴에서 “API Keys” 또는 “Get API Key” 버튼을 클릭합니다. 그다음 “Create Key” 버튼을 누르면 키 이름 입력창이 뜨는데, 본인이 알아볼 수 있는 이름(예: openclaw-key)을 입력하고 생성합니다. 이때 발급된 키값이 화면에 딱 한 번 표시됩니다. 이후에는 다시 확인할 수 없으므로 반드시 어딘가에 복사해두세요. 메모장이나 비밀번호 관리자에 저장해두는 걸 권장합니다.
API 키를 발급받았다면 결제 수단도 등록해야 합니다. 앤트로픽 콘솔의 “Billing” 탭에서 신용카드를 추가하면 되는데, 처음 가입 시 일정 크레딧이 제공되는 경우도 있으니 확인해보세요. 중요한 건 API 방식은 사용한 만큼만 비용이 발생하는 종량제(Pay-as-you-go) 구조라는 점입니다. 가벼운 개인 업무 자동화 목적이라면 한 달에 수천 원 수준으로도 충분히 쓸 수 있습니다.
Anthropic Console – API 키 발급받기
3. 오픈클로에 API 키 설정하는 방법
API 키를 손에 쥐었다면 이제 오픈클로 사용법의 핵심인 설정 단계입니다. 오픈클로가 이미 설치된 상태를 기준으로 설명합니다. 설정 방법은 크게 두 가지, 설정 파일에 직접 입력하는 방법과 환경 변수(Environment Variable)로 등록하는 방법이 있습니다.
방법 A: 오픈클로 설정 파일에 직접 입력
오픈클로 설치 디렉토리 안에 있는 설정 파일(보통 config.json 또는 .env 파일)을 텍스트 에디터로 열면 AI 모델 관련 설정 항목이 있습니다. 여기에 발급받은 API 키를 다음 형식으로 입력하면 됩니다. ANTHROPIC_API_KEY=sk-ant-여기에본인키입력 형태로 저장하면 오픈클로가 자동으로 앤트로픽 API를 인식합니다.
방법 B: 시스템 환경 변수로 등록
맥(Mac)의 경우 터미널을 열고 다음 명령어를 입력합니다. echo ‘export ANTHROPIC_API_KEY=”sk-ant-your-key-here”‘ >> ~/.zshrc 그런 다음 source ~/.zshrc를 실행하면 적용됩니다. 윈도우(Windows)의 경우 시스템 속성 > 환경 변수 탭에서 ANTHROPIC_API_KEY라는 이름으로 변수를 추가하면 됩니다. 환경 변수 방식이 보안적으로 더 안전하고, 여러 프로젝트에서 동시에 활용할 수 있어 권장하는 방식입니다.
| 운영체제 | 설정 경로 | 적용 명령어 |
|---|---|---|
| macOS (zsh) | ~/.zshrc 파일 수정 | source ~/.zshrc |
| macOS (bash) | ~/.bash_profile 파일 수정 | source ~/.bash_profile |
| Windows | 시스템 환경 변수 설정 | 재시작 또는 새 터미널 창 |
| Linux | ~/.bashrc 또는 ~/.profile | source ~/.bashrc |
클로드 API 가격 50% 절약하는 프롬프트 캐싱 설정 노하우
4. 사용할 Claude 모델 선택 및 비용 최적화
오픈클로 사용법 중 비용 관리는 생각보다 중요합니다. API 방식은 종량제이기 때문에 어떤 모델을 선택하느냐에 따라 비용이 크게 달라집니다. 앤트로픽에서 제공하는 주요 모델은 현재 클로드 오퍼스(Claude Opus), 클로드 소네트(Claude Sonnet), 클로드 하이쿠(Claude Haiku) 세 계열입니다.
일상적인 업무 자동화나 텍스트 처리에는 클로드 하이쿠(Claude Haiku)가 적합합니다. 가장 빠르고 비용도 저렴해서 반복적인 작업에 부담 없이 쓸 수 있습니다. 복잡한 분석이나 코딩 작업이 필요하다면 클로드 소네트(Claude Sonnet)가 성능과 가격의 균형이 좋습니다. 실제로 직장 동료가 처음에는 무조건 좋은 모델을 써야 한다며 오퍼스만 고집했다가 한 달 청구서를 보고 깜짝 놀랐다고 하더라고요. 용도에 맞게 모델을 나눠 쓰는 게 훨씬 현명합니다.
모델별 용도 비교
| 모델 | 적합한 용도 | 비용 수준 |
|---|---|---|
| Claude Haiku | 빠른 응답, 반복 작업, 간단한 요약 | 저렴 |
| Claude Sonnet | 코딩, 문서 작성, 중간 난이도 분석 | 중간 |
| Claude Opus | 복잡한 추론, 심층 연구, 고난이도 작업 | 높음 |
오픈클로 설정 파일에서 모델 항목을 찾아 원하는 모델명을 입력하면 됩니다. 예를 들어 claude-haiku-4-5-20251001 또는 claude-sonnet-4-6과 같은 모델 스트링(string)을 사용합니다. 앤트로픽 공식 문서에서 최신 모델 목록을 확인하는 습관을 들이면 좋습니다.
5. API 연동 후 오픈클로 정상 작동 확인 및 활용 팁
오픈클로 사용법의 마지막 단계는 설정이 제대로 됐는지 확인하는 것입니다. API 키와 모델 설정을 모두 마쳤다면 오픈클로를 재시작해봅니다. 텔레그램(Telegram) 봇 연동을 사용 중이라면 봇에게 간단한 메시지를 보내서 응답이 오는지 확인하는 것이 가장 빠른 테스트 방법입니다. 응답이 없다면 API 키가 제대로 입력됐는지, 크레딧 잔액이 충분한지부터 점검하세요.
설정이 잘 됐다면 오픈클로의 진짜 활용이 시작됩니다. 자동화 업무 범위를 점점 넓혀가면서 쓰는 걸 권장합니다. 처음에는 파일 정리나 일정 입력처럼 간단한 작업부터 시작하고, 익숙해지면 데이터 수집, 문서 요약, 브라우저 자동 조작 등으로 확장하면 됩니다. 또한 오픈클로는 오픈소스이기 때문에 GitHub에서 꾸준히 업데이트가 이루어집니다. 정기적으로 최신 버전을 유지해야 새로운 기능과 보안 패치를 적용받을 수 있습니다.
프롬프트 캐싱(Prompt Caching) 기능도 적극 활용하면 비용을 크게 줄일 수 있습니다. 반복적으로 같은 시스템 프롬프트를 사용하는 경우, 캐싱을 통해 입력 토큰 비용의 상당 부분을 절감할 수 있어요. 실제로 앤트로픽 측에서도 오픈클로의 프롬프트 캐시 효율을 개선하기 위한 작업에 직접 기여한 바 있을 정도로 이 기능의 중요성이 높습니다.
| 점검 항목 | 확인 방법 | 문제 시 해결책 |
|---|---|---|
| API 키 정상 입력 여부 | 설정 파일 또는 환경 변수 재확인 | 키 재발급 또는 복사/붙여넣기 재시도 |
| 크레딧 잔액 | 콘솔 Billing 탭 확인 | 결제 수단 추가 또는 크레딧 충전 |
| 모델 스트링 오류 | 앤트로픽 공식 문서 모델 목록 확인 | 정확한 모델명으로 수정 |
| 오픈클로 버전 | GitHub 릴리즈 페이지 확인 | 최신 버전으로 업데이트 |
Anthropic Console – 크레딧 및 사용량 확인하기
자주 묻는 질문
오픈클로 구독 없이 API만으로 계속 사용할 수 있나요?
네, 완전히 가능합니다. 오픈클로 사용법에서 구독은 하나의 방법일 뿐이고, 앤트로픽 개발자 API를 통해 연동하는 방식은 현재도 공식적으로 허용되고 있습니다. 앤트로픽도 “이번 조치가 오픈클로를 배척하려는 의도가 아니다”라고 명확히 밝혔습니다. API 키만 발급받으면 기존과 동일한 기능을 모두 사용할 수 있으며, 오히려 사용량을 직접 조절할 수 있어 더 유연한 운용이 가능합니다.
API 방식은 구독보다 비용이 더 많이 드나요?
사용 패턴에 따라 다릅니다. 하루 몇 번 가볍게 사용하는 경우라면 API 방식이 훨씬 저렴할 수 있습니다. 반면 하루 종일 헤비하게 사용한다면 월정액 구독보다 비쌀 수도 있죠. 클로드 하이쿠(Claude Haiku) 모델은 비용이 매우 저렴하므로, 일상적인 자동화 작업에는 하이쿠를 기본으로 설정하고 필요할 때만 상위 모델을 쓰는 방식을 권장합니다. 앤트로픽 콘솔에서 실시간으로 사용량과 비용을 확인할 수 있습니다.
API 키 발급에 기술적인 지식이 많이 필요한가요?
전혀 그렇지 않습니다. 앤트로픽 콘솔(console.anthropic.com)에 접속해서 계정을 만들고, “API Keys” 메뉴에서 “Create Key” 버튼을 누르는 것만으로 발급이 완료됩니다. 발급된 키를 오픈클로 설정 파일에 복사해서 붙여넣는 수준이면 충분합니다. 환경 변수 설정이 어렵게 느껴진다면 설정 파일에 직접 입력하는 방식을 먼저 사용해보세요.
오픈클로는 윈도우에서도 잘 작동하나요?
기본적으로는 작동하지만, 맥(Mac) 환경에서의 안정성이 더 높다는 사용자 후기가 많습니다. 오픈클로가 처음 개발된 배경 자체가 맥 운영체제에 최적화된 방향이었기 때문입니다. 윈도우에서 사용할 경우 WSL(Windows Subsystem for Linux, 윈도우 리눅스 하위 시스템)을 활용하거나 도커(Docker) 환경을 구성하면 더 안정적으로 실행할 수 있습니다. 설치 과정에서 오류가 발생한다면 공식 GitHub 이슈 트래커를 참고하는 것이 빠릅니다.
오픈클로에서 Claude 외에 다른 AI 모델도 쓸 수 있나요?
가능합니다. 오픈클로는 오픈소스 프레임워크이기 때문에 올라마(Ollama)를 통한 로컬 LLM(Large Language Model, 대규모 언어 모델) 연동도 지원합니다. 로컬 모델을 사용하면 비용이 전혀 들지 않지만, 클로드(Claude)와 비교했을 때 지능 수준 차이가 상당히 나는 경우가 많습니다. 일반적인 사용 목적이라면 클로드 API 연동이 가장 만족스러운 결과를 줍니다. GPT 계열 모델도 별도 설정을 통해 연동할 수 있습니다.
API 키가 유출되면 어떻게 되나요?
타인이 내 API 키를 무단으로 사용할 경우 그 비용이 내 계정으로 청구됩니다. 그래서 API 키 보안 관리가 매우 중요합니다. 키를 코드에 직접 입력하거나 공개 저장소(GitHub 등)에 올리는 것은 절대 피해야 합니다. 환경 변수로 관리하는 것이 안전하며, 키가 유출됐다고 의심되면 즉시 앤트로픽 콘솔에서 해당 키를 삭제하고 새로 발급받으면 됩니다. 콘솔에서 사용량을 수시로 확인하는 습관도 도움이 됩니다.
글을 마치며
오픈클로 사용법에서 구독 중단은 끝이 아니라 새로운 시작입니다. 앤트로픽 API를 직접 연동하는 방식은 오히려 사용량을 직접 컨트롤할 수 있고, 원하는 모델을 골라 쓸 수 있다는 면에서 더 유연합니다. API 키 발급부터 오픈클로 설정, 모델 선택, 비용 최적화까지 5단계를 차근차근 따라가면 누구든 어렵지 않게 구독 없는 환경을 구축할 수 있습니다. 처음에는 낯설고 번거롭게 느껴질 수 있지만, 한 번 설정해두면 이후에는 훨씬 안정적이고 지속 가능한 방식으로 AI 에이전트를 활용할 수 있게 됩니다. 오픈클로는 지금도 오픈소스로 꾸준히 발전 중이고, API 연동 방식의 호환성도 함께 개선되고 있으니 앞으로도 오래 사용할 수 있을 겁니다. 이 글이 오픈클로를 포기하지 않고 계속 쓰고 싶은 분들에게 실질적인 도움이 됐으면 합니다.