[OpenCode 실전기 3편] 토큰/구독 제한 줄이는 Provider 운영법

왜 Provider 전략이 중요할까?

고등학생이 OpenCode를 처음 쓰면 보통 한 가지 모델만 연결하고 시작합니다. 그런데 실제로는 한 모델만 계속 쓰다 보면 세 가지 문제가 자주 생깁니다.

• 사용량 제한이 빨리 온다
• 응답이 느린 날이 있다
• 로그인 방식이나 결제 방식이 서비스마다 다르다

그래서 중요한 건 "최고의 모델 하나"보다 끊기지 않는 조합을 만드는 것입니다.

먼저 알아둘 세 단어

쉽게 말하면, provider는 "어느 서비스를 쓸지", token은 "얼마나 사용했는지", subscription은 "월 이용권이 있는지"를 뜻합니다.

학생에게 추천하는 기본 조합

처음부터 비싼 모델만 연결할 필요는 없습니다. 아래처럼 역할을 나눠 두면 훨씬 안정적입니다.

핵심은 메인 1개 + 백업 1개입니다.

예시 설정 파일 보기

저는 보통 메인과 백업을 이런 식으로 나눠 둡니다. 아래 예시는 구조를 보여 주기 위한 것이고, 실제 키 값은 절대 그대로 저장하면 안 됩니다.

⚠️ 설정 파일 구조와 필드 이름은 OpenCode 버전이나 플러그인 버전에 따라 조금씩 달라질 수 있습니다. 여기서는 정확한 버튼 이름보다, 메인과 백업을 어떻게 나눌지 이해하는 데 집중하면 됩니다.

Google 로그인 연결하기

Google 계정을 연결해 두면 브라우저 로그인만으로 시작할 수 있어서, API 키가 아직 낯선 학생에게 특히 편합니다.

흐름 한눈에 보기

1. OpenCode에서 Google을 사용할 수 있는 provider를 선택합니다.
2. 브라우저 로그인 창이 뜨면 내 Google 계정으로 로그인합니다.
3. 권한 허용을 마치면 OpenCode가 인증 정보를 저장합니다.
4. 이후에는 같은 기기에서 다시 로그인하지 않아도 되는 경우가 많습니다.

예시 화면

학생에게 중요한 포인트

• 학교 계정은 관리 정책 때문에 외부 서비스 로그인이 제한될 수 있습니다
• 개인 Google 계정으로 먼저 연습하는 편이 더 단순합니다
• 로그인에 성공해도 모델별 사용량 제한은 따로 존재할 수 있습니다

Antigravity 구독을 플러그인으로 붙이는 방법

여기서 중요한 건 구독이 바뀌어도 작업 흐름은 끊기지 않게 만드는 것입니다. opencode-antigravity-auth@latest는 쉽게 말해, 그런 백업 경로를 하나 더 만드는 데 도움을 주는 플러그인이라고 보면 됩니다.

언제 유용할까?

• Google 쪽 응답이 느릴 때
• 다른 모델로 바로 바꾸고 싶을 때
• 한 서비스만 쓰다가 제한에 걸렸을 때

예시 설정

{
  "plugin": [
    "opencode-antigravity-auth@latest"
  ]
}

플러그인을 추가했다면 OpenCode를 다시 시작해서 제대로 읽히는지만 확인하면 됩니다.

학생 기준으로 이렇게 이해하면 쉽다

고등학생이라면 아래 세 문장으로 이해해 두면 충분합니다.

• "Antigravity는 여러 모델을 한 환경에서 관리하기 쉽게 만드는 연결 도구다"
• "로그인이나 구독 절차는 버전에 따라 화면이 조금씩 다를 수 있다"
• "중요한 건 특정 버튼 이름을 외우는 것보다 메인과 백업 경로를 만들어 두는 것이다"

내가 실제로 추천하는 운영 순서

1. Google 계정 기반 연결을 먼저 붙인다
2. Antigravity 같은 백업 경로를 하나 더 둔다
3. 복잡한 문제는 메인 모델에 맡긴다
4. 요약, 정리, 반복 작업은 보조 모델로 넘긴다

이렇게 해 두면 한쪽이 막혀도 바로 다른 경로로 넘어갈 수 있습니다.

학생용 체크리스트

• 메인 provider 1개 연결
• 백업 provider 1개 연결
• 로그인 방식과 API 키 방식을 구분해서 이해
• 키나 토큰을 친구와 공유하지 않기
• 응답이 느리면 다른 provider로 바꿔 보기

꼭 적어 둘 주의 사항

• OAuth 로그인 화면과 설정 파일 형식은 버전에 따라 조금 달라질 수 있습니다
• 학교 계정은 정책상 일부 로그인 방식이 막힐 수 있습니다
• 구독 플러그인을 쓰더라도 각 서비스의 이용 약관은 따로 확인해야 합니다

다음 단계

이제 연결 경로를 두 개 이상 만들었다면, 다음은 역할을 나눠 여러 에이전트를 함께 돌리는 방법을 배우면 됩니다. 다음 글에서는 oh-my-opencode를 이용해 탐색, 구현, 검토를 나누는 방법을 정리합니다.

출처

• opencode-antigravity-auth: https://github.com/NoeFabris/opencode-antigravity-auth
• oh-my-opencode: https://github.com/code-yeongyu/oh-my-opencode
• OpenCode 공식 문서: https://opencode.ai/docs/