OpenCode에서 Claude 리밋 확인하려고 Claude Code를 따로 켜던 시절은 끝
2026.02.07
📝 한줄 요약
OpenCode에서 Claude 사용량과 계정 정보를 바로 확인하는 스킬을 만들었습니다. 설치 30초, 토큰 자동 갱신까지.
🎯 이런 분들께 도움돼요
OpenCode 쓰면서 리밋 확인할 방법이 없어서 답답했던 분
Claude 계정이 여러 개라 지금 어떤 계정으로 쓰는지 헷갈리는 분
리밋 확인하려고 Claude Code를 따로 띄워놓고 있는 분
결과부터 보고 가시죠!

😫 문제 상황 (Before)
OpenCode에는 현재 Claude 사용량을 확인할 방법이 없습니다.
Claude Code에는 /usage 하면 리밋이 표시되는데, OpenCode에는 그런 게 없어요. 그래서 저는 리밋 확인 전용으로 Claude Code 터미널을 따로 하나 띄워놓고 거기서만 사용량을 봤습니다. 말 그대로 리밋 확인하는 용도로만요.
그리고 또 하나 불편했던 게 — 계정이 여러 개면 지금 어떤 계정으로 쓰고 있는지 헷갈립니다. 저희 회사에는 전략적으로 여러 계정을 돌려쓰는데요, 확인하려면 로그아웃하고 로그인 하고... 정말 번거롭습니다.
🛠️ 사용한 도구
OpenCode + Claude Code (Claude Opus)
Anthropic OAuth API (사용량 조회, 토큰 갱신)
🔧 만든 과정
스킬 하나 만들면 되겠다
OpenCode는 / 명령어로 스킬을 실행할 수 있어서, 사용량 조회 스킬을 만들기로 했습니다.
Anthropic OAuth API에 /api/oauth/usage랑 /api/oauth/profile 엔드포인트가 있어서, 여기에 토큰 던지면 사용량이랑 계정 정보를 가져올 수 있습니다.
bash 스크립트 하나로 만들었고, 결과는 이렇게 나옵니다:
+- Account ------------------------------+
| [email protected] / Max 20x |
+- Claude Usage -------------------------+
| 5H Limit: 67% (reset: 1h 4m) |
| 7D Limit: 60% (reset: 4d 20h) |
+----------------------------------------+
계정 이메일, 플랜(Pro/Max/Team), 5시간/7일 사용량, 리셋까지 남은 시간이 한눈에 보입니다.
토큰이 만료되면?
만들고 잘 쓰다가, 오늘 아침에 갑자기 "API 호출 실패"가 떴습니다.
디버깅해보니 OAuth access token이 만료된 거였어요. 8시간마다 만료됩니다. 그동안은 운 좋게 만료 전에 확인했던 거고요.
매번 claude login 다시 치는 건 말이 안 되니까, 자동 갱신 로직을 추가했습니다.
Claude Code 소스에서 client_id 찾기
토큰을 갱신하려면 OAuth refresh 요청을 보내야 하는데, client_id가 필요합니다. 공식 문서에는 없어서 Claude Code 소스 코드를 직접 뒤졌습니다.
Claude Code 설치 경로에서 CLIENT_ID 문자열을 검색
두 개가 나왔는데, 하나씩 시도해서 맞는 걸 찾았습니다. 이걸로 refresh token을 보내면 새 access token이 발급됩니다.
3단계 fallback 구조
최종적으로 토큰 조회 로직을 이렇게 만들었습니다:
auth.json 유효 → 그대로 사용
auth.json 만료 → refresh token으로 자동 갱신 (파일도 업데이트)
refresh도 실패 → macOS Keychain에서 Claude Code 토큰 가져오기
이렇게 하니까 토큰 만료 걱정 없이 계속 쓸 수 있게 됐습니다.
✅ 결과 (After)
Before vs After
항목 | Before | After |
|---|---|---|
리밋 확인 | Claude Code 별도 터미널 띄워서 확인 |
|
계정 확인 | 어딘가 뒤져봐야 함 | 이메일 + 플랜 바로 표시 |
토큰 만료 | 수동 | 자동 갱신 |
결과물
OpenCode에서 /usage-claudecode 입력하면 바로 확인:
+- Account ------------------------------+
| [email protected] / Max 20x |
+- Claude Usage -------------------------+
| 5H Limit: 2% (reset: 4h 42m) |
| 7D Limit: 10% (reset: 6d 0h) |
+----------------------------------------+
💬 이 과정에서 배운 것
효과적이었던 것
Claude Code 소스를 직접 뒤진 것 — 공식 문서에 없는 client_id를 찾아서 토큰 자동 갱신까지 구현할 수 있었음
fallback 구조를 넣은 것 — auth.json → refresh → Keychain 순서로 시도하니까 어떤 상황에서든 동작
주의할 점
OAuth refresh token은 한 번 쓰면 폐기(rotation)됩니다. 디버깅할 때 수동으로 refresh 한 번 날렸더니 기존 토큰이 무효화돼서 다시 로그인해야 했음
claude login은 Keychain만 갱신하고 auth.json은 안 건드림 — 이걸 몰라서 한참 헤맸음
📋 설치 방법
터미널에서 이거 복붙하면 설치 끝:
mkdir -p ~/.config/opencode/skills/usage-claudecode/scripts
curl -fsSL https://raw.githubusercontent.com/wineny/opencode-usage/master/scripts/usage.sh -o ~/.config/opencode/skills/usage-claudecode/scripts/usage.sh
curl -fsSL https://raw.githubusercontent.com/wineny/opencode-usage/master/SKILL.md -o ~/.config/opencode/skills/usage-claudecode/SKILL.md
chmod +x ~/.config/opencode/skills/usage-claudecode/scripts/usage.sh
설치 후 OpenCode에서 /usage-claudecode 입력하면 됩니다.
이미 설치한 분은 스크립트만 업데이트:
curl -fsSL https://raw.githubusercontent.com/wineny/opencode-usage/master/scripts/usage.sh -o ~/.config/opencode/skills/usage-claudecode/scripts/usage.sh
🔗 GitHub
로그인하고 댓글을 남겨 주세요
우리 회사에도 이런 자동화를 도입하고 싶다면
회사 업무에 맞춘 AI 교육을 함께 설계해요.




잘쓰고있습니다 누리님! 근데 오픈코드 너무 무거워서, 저는 순정 클로드 코드로 돌아갈까 하고 있습니다 ㅎㅎ 누리님도 돌아간걸로 알고있는데 ...
저 글을 쓸 때까지는 오픈코드 쓰고 있었거든요... 그리고 바로 다음날에 경호님 강의 듣고 클로드코드로 넘어왔습니다. ㅎ