빠른 시작: 모든 AI 플랫폼 할당량 일괄 조회

학습 후 할 수 있는 것

5분 안에 opencode-mystatus 플러그인 설치 완료
슬래시 명령어 /mystatus 설정
설치 성공 확인 및 첫 번째 AI 플랫폼 할당량 조회

현재 겪고 있는 문제

여러 AI 플랫폼(OpenAI, 지푸 AI, GitHub Copilot, Google Cloud 등)을 사용하여 개발 중이며, 매일 각 플랫폼의 남은 할당량을 자주 확인해야 합니다. 매번 각 플랫폼에 개별적으로 로그인하여 확인하는 것은 시간이 너무 많이 소요됩니다.

언제 이 기능을 사용하나요?

OpenCode를 처음 사용할 때: 초보자로서 설치하는 첫 번째 플러그인
다중 플랫폼 할당량 관리가 필요할 때: OpenAI, 지푸 AI, GitHub Copilot 등 여러 플랫폼을 동시에 사용
팀 협업 시나리오: 팀원들이 여러 AI 계정을 공유하며, 할당량을 통합하여 확인 필요

🎒 시작 전 준비

시작하기 전에 다음을 확인하세요:

전제 조건

[ ] OpenCode가 설치되어 있습니다
[ ] 적어도 하나의 AI 플랫폼 인증 정보가 설정되어 있습니다(OpenAI, 지푸 AI, Z.ai, GitHub Copilot 또는 Google Cloud)

아직 어떤 AI 플랫폼도 설정하지 않았다면, OpenCode에서 적어도 하나의 플랫폼 로그인을 먼저 완료한 후 이 플러그인을 설치하는 것이 좋습니다.

핵심 원리

opencode-mystatus는 OpenCode 플러그인으로, 핵심 가치는 다음과 같습니다:

인증 파일 자동 읽기: OpenCode의 공식 인증 저장소에서 모든 설정된 계정 정보를 읽습니다
모든 플랫폼 병렬 조회: OpenAI, 지푸 AI, Z.ai, GitHub Copilot 및 Google Cloud의 공식 API를 동시에 호출합니다
시각적 표시: 프로그레스 바와 카운트다운을 사용하여 남은 할당량을 직관적으로 표시합니다

설치 프로세스는 간단합니다:

OpenCode 설정 파일에 플러그인과 슬래시 명령어를 추가합니다
OpenCode를 재시작합니다
/mystatus를 입력하여 할당량을 조회합니다

따라하기

1단계: 설치 방법 선택

opencode-mystatus는 세 가지 설치 방법을 제공합니다. 사용 습관에 따라 하나를 선택하세요:

AI가 설치 도와주기(권장)수동 설치로컬 파일에서 설치

bash

다음 내용을 임의의 AI 에이전트(Claude Code, OpenCode, Cursor 등)에 붙여넣으세요:

Install opencode-mystatus plugin by following: https://raw.githubusercontent.com/vbgate/opencode-mystatus/main/README.md

bash

~/.config/opencode/opencode.json을 열고, 2단계 설정을 편집하세요

bash

플러그인 파일을 ~/.config/opencode/plugin/ 디렉토리에 복사하세요(자세한 내용은 4단계 참조)

AI 설치를 권장하는 이유: AI 에이전트가 모든 설정 단계를 자동으로 실행하므로, 확인만 하면 되며 가장 빠르고 간편합니다.

2단계: 수동 설치 설정(수동 설치 필수)

수동 설치를 선택한 경우, OpenCode 설정 파일을 편집해야 합니다.

2.1 설정 파일 열기

bash

# macOS/Linux
code ~/.config/opencode/opencode.json

# Windows
code %APPDATA%\opencode\opencode.json

2.2 플러그인 및 슬래시 명령어 추가

설정 파일에 다음 내용을 추가합니다(기존 plugin 및 command 설정을 유지하며, 새 설정 항목을 추가):

json

{
  "plugin": ["opencode-mystatus"],
  "command": {
    "mystatus": {
      "description": "Query quota usage for all AI accounts",
      "template": "Use the mystatus tool to query quota usage. Return the result as-is without modification."
    }
  }
}

이렇게 설정하는 이유:

설정 항목	값	역할
`plugin` 배열	`["opencode-mystatus"]`	OpenCode에 이 플러그인을 로드하도록 알림
`description`	"Query quota usage for all AI accounts"	명령어 목록에 표시되는 설명
`template`	"Use the mystatus tool..."	OpenCode가 mystatus 도구를 호출하는 방법 안내

다음과 같이 보여야 합니다: 설정 파일에 완전한 plugin 및 command 필드가 포함되어 있으며, 형식이 올바릅니다(JSON의 쉼표와 따옴표 주의).

3단계: 로컬 파일에서 설치(로컬 설치 필수)

로컬 파일에서 설치를 선택한 경우, 플러그인 파일을 수동으로 복사해야 합니다.

3.1 플러그인 파일 복사

bash

# opencode-mystatus 소스코드를 ~/opencode-mystatus/에 클론했다고 가정

# 메인 플러그인 및 라이브러리 파일 복사
cp -r ~/opencode-mystatus/plugin/mystatus.ts ~/.config/opencode/plugin/
cp -r ~/opencode-mystatus/plugin/lib/ ~/.config/opencode/plugin/

# 슬래시 명령어 설정 복사
cp ~/opencode-mystatus/command/mystatus.md ~/.config/opencode/command/

이 파일들을 복사해야 하는 이유:

mystatus.ts: 플러그인 메인 엔트리 파일, mystatus 도구 정의 포함
lib/ 디렉토리: OpenAI, 지푸 AI, Z.ai, GitHub Copilot 및 Google Cloud의 조회 로직 포함
mystatus.md: 슬래시 명령어 설정 설명

다음과 같이 보여야 합니다: ~/.config/opencode/plugin/ 디렉토리에 mystatus.ts 및 lib/ 하위 디렉토리가 있고, ~/.config/opencode/command/ 디렉토리에 mystatus.md가 있습니다.

4단계: OpenCode 재시작

어떤 설치 방법을 선택하든, 마지막 단계는 OpenCode를 재시작하는 것입니다.

재시작해야 하는 이유: OpenCode는 시작 시에만 설정 파일을 읽으므로, 설정 변경 후 재시작해야 적용됩니다.

다음과 같이 보여야 합니다: OpenCode가 재시작된 후 정상적으로 사용할 수 있습니다.

5단계: 설치 확인

이제 설치가 성공했는지 확인하세요.

5.1 슬래시 명령어 테스트

OpenCode에서 다음을 입력하세요:

bash

/mystatus

다음과 같이 보여야 합니다:

최소 하나의 AI 플랫폼 인증 정보가 설정된 경우, 다음과 유사한 출력이 표시됩니다(OpenAI 예시):

한국어 시스템 출력영어 시스템 출력

markdown

## OpenAI 계정 할당량

Account:        user@example.com (team)

3시간 할당량
███████████████████████████ 85% 남음
재설정: 2h 30m 후

markdown

## OpenAI Account Quota

Account:        user@example.com (team)

3-hour limit
███████████████████████████ 85% remaining
Resets in: 2h 30m

출력 언어 설명

플러그인은 시스템 언어를 자동으로 감지합니다(한국어 시스템은 한국어 표시, 영어 시스템은 영어 표시). 위 두 출력 모두 올바릅니다.

아직 계정이 설정되지 않은 경우, 다음이 표시됩니다:

한국어 시스템 출력영어 시스템 출력

markdown

설정된 계정을 찾을 수 없습니다.

지원되는 계정 유형:
- OpenAI (Plus/Team/Pro 구독 사용자)
- 지푸 AI (Coding Plan)
- Z.ai (Coding Plan)
- Google Cloud (Antigravity)

markdown

No configured accounts found.

Supported account types:
- OpenAI (Plus/Team/Pro subscribers)
- Zhipu AI (Coding Plan)
- Z.ai (Coding Plan)
- Google Cloud (Antigravity)

5.2 출력 의미 이해

요소(한국어 버전)	요소(영어 버전)	의미
`## OpenAI 계정 할당량`	`## OpenAI Account Quota`	플랫폼 제목
`user@example.com (team)`	`user@example.com (team)`	계정 정보(이메일 또는 팀)
`3시간 할당량`	`3-hour limit`	할당량 유형(3시간 할당량)
`85% 남음`	`85% remaining`	남은 비율
`재설정: 2h 30m 후`	`Resets in: 2h 30m`	재설정 시간 카운트다운

API Key가 완전히 표시되지 않는 이유: 프라이버시 보호를 위해 플러그인이 자동으로 마스킹합니다(예: 9c89****AQVM).

체크포인트 ✅

다음 단계를 완료했는지 확인하세요:

단계	확인 방법	예상 결과
플러그인 설치	`~/.config/opencode/opencode.json` 확인	`plugin` 배열에 `"opencode-mystatus"` 포함
슬래시 명령어 설정	동일 파일 확인	`command` 객체에 `mystatus` 설정 포함
OpenCode 재시작	OpenCode 프로세스 확인	재시작됨
명령어 테스트	`/mystatus` 입력	할당량 정보 또는 "설정된 계정을 찾을 수 없습니다" 표시

일반적인 실수

일반적인 오류 1: JSON 형식 오류

증상: OpenCode 시작 실패, JSON 형식 오류 보고

원인: 설정 파일에 쉼표나 따옴표가 너무 많거나 부족함

해결 방법:

온라인 JSON 유효성 검사 도구를 사용하여 형식을 확인하세요. 예를 들어:

json

// ❌ 오류: 마지막 항목에 쉼표가 있음
{
  "plugin": ["opencode-mystatus"],
  "command": {
    "mystatus": {
      "description": "Query quota usage for all AI accounts",
      "template": "Use the mystatus tool..."
    }
  }  // ← 여기에 쉼표가 있으면 안 됨
}

// ✅ 올바름
{
  "plugin": ["opencode-mystatus"],
  "command": {
    "mystatus": {
      "description": "Query quota usage for all AI accounts",
      "template": "Use the mystatus tool..."
    }
  }
}

일반적인 오류 2: OpenCode 재시작 잊음

증상: 설정 완료 후 /mystatus 입력 시 "명령을 찾을 수 없습니다" 표시

원인: OpenCode가 설정 파일을 다시 로드하지 않음

해결 방법:

OpenCode를 완전히 종료합니다(최소화가 아님)
OpenCode를 다시 시작합니다
다시 /mystatus 명령어를 시도합니다

일반적인 오류 3: "설정된 계정을 찾을 수 없습니다" 표시

증상: /mystatus 실행 후 "설정된 계정을 찾을 수 없습니다" 표시

원인: OpenCode에 아직 AI 플랫폼에 로그인하지 않음

해결 방법:

OpenCode에서 최소 하나의 AI 플랫폼(OpenAI, 지푸 AI, Z.ai, GitHub Copilot 또는 Google Cloud)에 로그인
인증 정보가 ~/.local/share/opencode/auth.json에 자동 저장됨
다시 /mystatus 실행

일반적인 오류 4: Google Cloud 할당량 조회 실패

증상: 다른 플랫폼은 정상적으로 조회되지만 Google Cloud는 오류 표시

원인: Google Cloud에는 추가 인증 플러그인이 필요함

해결 방법:

Google 계정 인증을 완료하려면 먼저 opencode-antigravity-auth 플러그인을 설치하세요.

이번 수업 요약

이번 수업에서는 opencode-mystatus 설치와 기본 확인을 완료했습니다:

세 가지 설치 방법: AI가 설치 도와주기(권장), 수동 설치, 로컬 파일에서 설치
설정 파일 위치: ~/.config/opencode/opencode.json
핵심 설정 항목:
- plugin 배열: "opencode-mystatus" 추가
- command 객체: mystatus 슬래시 명령어 설정
확인 방법: OpenCode 재시작 후 /mystatus 입력
자동 인증 읽기: 플러그인이 ~/.local/share/opencode/auth.json에서 설정된 계정 정보를 자동으로 읽음

설치 완료 후, OpenCode에서 /mystatus 명령어 또는 자연어를 사용하여 모든 AI 플랫폼의 할당량을 조회할 수 있습니다.

다음 수업 미리보기

다음 수업에서는 **mystatus 사용하기: 슬래시 명령어와 자연어**를 학습합니다.
다음을 배우게 됩니다:
슬래시 명령어 /mystatus의 상세 사용법
자연어로 mystatus 도구를 트리거하는 방법
두 가지 트리거 방식의 차이점과 사용 시나리오
슬래시 명령어 설정 원리

부록: 소스코드 참조

클릭하여 소스코드 위치 펼치기

업데이트 날짜: 2026-01-23

기능	파일 경로	행 번호
플러그인 엔트리	`plugin/mystatus.ts`	26-94
mystatus 도구 정의	`plugin/mystatus.ts`	29-33
인증 파일 읽기	`plugin/mystatus.ts`	35-46
모든 플랫폼 병렬 조회	`plugin/mystatus.ts`	49-56
결과 수집 및 요약	`plugin/mystatus.ts`	58-89
슬래시 명령어 설정	`command/mystatus.md`	1-6

핵심 상수:

인증 파일 경로: ~/.local/share/opencode/auth.json(plugin/mystatus.ts:35)

핵심 함수:

mystatus(): mystatus 도구의 메인 함수, 인증 파일을 읽고 모든 플랫폼을 병렬로 조회(plugin/mystatus.ts:29-33)
collectResult(): 조회 결과를 results 및 errors 배열에 수집(plugin/mystatus.ts:100-116)
queryOpenAIUsage(): OpenAI 할당량 조회(plugin/lib/openai.ts)
queryZhipuUsage(): 지푸 AI 할당량 조회(plugin/lib/zhipu.ts)
queryZaiUsage(): Z.ai 할당량 조회(plugin/lib/zhipu.ts)
queryGoogleUsage(): Google Cloud 할당량 조회(plugin/lib/google.ts)
queryCopilotUsage(): GitHub Copilot 할당량 조회(plugin/lib/copilot.ts)

설정 파일 형식: OpenCode 설정 파일 ~/.config/opencode/opencode.json의 플러그인 및 슬래시 명령어 설정은 README.zh-CN.md 33-82행을 참조하세요.

빠른 시작

플랫폼 기능

고급 기능

常见问题

부록

버전 기록

빠른 시작: 모든 AI 플랫폼 할당량 일괄 조회

학습 후 할 수 있는 것

현재 겪고 있는 문제

언제 이 기능을 사용하나요?

🎒 시작 전 준비

핵심 원리

따라하기

1단계: 설치 방법 선택

2단계: 수동 설치 설정(수동 설치 필수)

2.1 설정 파일 열기

2.2 플러그인 및 슬래시 명령어 추가

3단계: 로컬 파일에서 설치(로컬 설치 필수)

3.1 플러그인 파일 복사

4단계: OpenCode 재시작

5단계: 설치 확인

5.1 슬래시 명령어 테스트

5.2 출력 의미 이해

체크포인트 ✅

일반적인 실수

일반적인 오류 1: JSON 형식 오류

일반적인 오류 2: OpenCode 재시작 잊음

일반적인 오류 3: "설정된 계정을 찾을 수 없습니다" 표시

일반적인 오류 4: Google Cloud 할당량 조회 실패

이번 수업 요약

다음 수업 미리보기

부록: 소스코드 참조

빠른 시작: 모든 AI 플랫폼 할당량 일괄 조회 ​

학습 후 할 수 있는 것 ​

현재 겪고 있는 문제 ​

언제 이 기능을 사용하나요? ​

🎒 시작 전 준비 ​

핵심 원리 ​

따라하기 ​

1단계: 설치 방법 선택 ​

2단계: 수동 설치 설정(수동 설치 필수) ​

2.1 설정 파일 열기 ​

2.2 플러그인 및 슬래시 명령어 추가 ​

3단계: 로컬 파일에서 설치(로컬 설치 필수) ​

3.1 플러그인 파일 복사 ​

4단계: OpenCode 재시작 ​

5단계: 설치 확인 ​

5.1 슬래시 명령어 테스트 ​

5.2 출력 의미 이해 ​

체크포인트 ✅ ​

일반적인 실수 ​

일반적인 오류 1: JSON 형식 오류 ​

일반적인 오류 2: OpenCode 재시작 잊음 ​

일반적인 오류 3: "설정된 계정을 찾을 수 없습니다" 표시 ​

일반적인 오류 4: Google Cloud 할당량 조회 실패 ​

이번 수업 요약 ​

다음 수업 미리보기 ​

부록: 소스코드 참조 ​

빠른 시작: 모든 AI 플랫폼 할당량 일괄 조회

학습 후 할 수 있는 것

현재 겪고 있는 문제

언제 이 기능을 사용하나요?

🎒 시작 전 준비

핵심 원리

따라하기

1단계: 설치 방법 선택

2단계: 수동 설치 설정(수동 설치 필수)

2.1 설정 파일 열기

2.2 플러그인 및 슬래시 명령어 추가

3단계: 로컬 파일에서 설치(로컬 설치 필수)

3.1 플러그인 파일 복사

4단계: OpenCode 재시작

5단계: 설치 확인

5.1 슬래시 명령어 테스트

5.2 출력 의미 이해

체크포인트 ✅

일반적인 실수

일반적인 오류 1: JSON 형식 오류

일반적인 오류 2: OpenCode 재시작 잊음

일반적인 오류 3: "설정된 계정을 찾을 수 없습니다" 표시

일반적인 오류 4: Google Cloud 할당량 조회 실패

이번 수업 요약

다음 수업 미리보기

부록: 소스코드 참조