30초 결론: OpenCode와 Claude Code 중 어디를 고를 것인가#
여러 모델 제공자를 직접 연결하려면 OpenCode를, Claude 구독과 IDE 연동을 함께 쓰려면 Claude Code를 검토하세요. 사내망 접근과 계정별 청구 조건도 확인하세요.
비교표: 인터페이스, 모델, 권한, 한국어, 가격 (6–8행)#
아래 공식 자료와 가격은 2026-11-01 확인 기준입니다. 제공자와 설정에 따라 실제 경험과 비용이 달라집니다.
| 기준 | OpenCode | Claude Code |
|---|---|---|
| 작업 화면 | 터미널, 데스크톱, 웹 (공식 소개) | 터미널, IDE, 데스크톱, 웹 (공식 소개) |
| 모델 연결 | 여러 제공자를 연결할 수 있으며 Go는 선택형 구독과 API 키로 연결 (Go 문서) | Claude 구독 또는 Anthropic Console 계정 등을 사용하며, 일부 환경은 외부 제공자도 지원 (공식 소개) |
| 권한 | 동작과 대상별로 허용·거부·확인을 설정 (권한 문서) | 도구별 권한 규칙과 모드 설정 (권한 문서) |
| 한국어 | 모델과 설정에 따른 결과를 직접 확인 | 모델과 설정에 따른 결과를 직접 확인 |
| 구독 예시 | 선택형 Go 월 $10, Go Plus 월 $40; 팀은 인당 월 $20 (Go 문서) | 개인 월 결제 Pro $20, Max $100, Ultra $200, 세금 별도 (요금 페이지) |
| 한도·추가 비용 | Go는 모델별 5시간·주간·월간 한도가 있고 Extra Usage를 켜면 잔액에서 종량 과금 | 구독 한도가 있으며 사용 속도는 모델과 대화·파일 크기에 따라 달라짐 (요금 페이지) |
| 데이터·사내망 | 제공자와 모델별 데이터 처리 조건 및 접속 경로 확인 | 계정·제공자별 데이터 처리 조건 및 접속 경로 확인 |
선택 전에는 다음 순서로 확인하세요.
- 사용할 모델과 제공자, 사내망의 외부 접속 허용 범위를 정합니다.
- 구독료뿐 아니라 모델별 한도, 초과 사용 설정, 세금과 환율을 확인합니다.
- 파일 수정과 명령 실행 권한을 검토하고 민감한 정보가 없는 저장소로 시험합니다.
- 같은 한국어 과제와 검증 기준을 사용해 결과와 테스트를 직접 비교합니다.
OpenCode가 강한 경우 / Claude Code가 강한 경우#
OpenCode는 여러 제공자를 직접 연결하고 설정을 조정하려는 경우 살펴볼 만합니다. Claude Code는 Claude 구독을 이용하면서 IDE 확장과 터미널을 함께 쓰려는 경우 선택지입니다. 다만 Claude Code도 일부 환경에서 외부 제공자를 지원하므로 모델 선택을 양자택일로 볼 수는 없습니다. 어느 쪽이 특정 과제에 더 잘 맞는지는 별도 실험이 필요합니다.
데이터·보안 문서 비교 — 2026-11-02 추가 확인. 아래 OpenCode 열은 주로 Console 모델 경로의 정책입니다. 개인 키로 직접 연결한 제공자나 Go 전체에 일괄 적용하지 마세요. Claude Code 열도 개인 구독, 상업용 계약과 실행 경로를 구분해 읽어 보세요.
| 검토 항목 | OpenCode 공식 문서 | Claude Code 공식 문서 |
|---|---|---|
| 학습 이용 | Console 개인정보 안내는 기본 정책과 예외를 구분. Big Pickle·Flint 등의 무료 기간 데이터는 모델 개선에 쓰일 수 있음 | 데이터 이용: 개인 계정은 개선 이용 설정에 따라 달라짐; 상업용은 고객이 별도로 제공에 동의한 경우 등 예외를 제외하고 학습에 쓰지 않는다고 안내 |
| 보관 | 같은 Console 안내에서 Flint 무료 모델은 30일, OpenAI·Anthropic API 요청도 30일 보관 예외를 명시; 선택한 제공자 조건 확인 | 같은 데이터 문서는 개인 개선 이용 허용 시 5년, 거부 시 30일; 상업용 기본 30일. Enterprise라도 무조건 ZDR이 아니며 별도 자격·조직별 활성화 필요 |
| 명령·외부 도구 | 권한 설정과 연결 제공자의 처리 조건을 함께 검토 | 도구 권한과 데이터 정책을 함께 검토; 로컬 CLI도 LLM 요청은 네트워크로 전송 |
| 보고·공유 | 무료 엔드포인트의 시험용 제한과 기밀정보 제출 금지 등 모델별 예외 확인 | 데이터 문서는 /feedback 등에 보낸 transcript의 별도 보관을 설명; 모델 요청과 피드백 전송을 같은 것으로 보지 않음 |
학습 이용과 보관은 별개입니다. 학습 거부 설정, 도구 실행 승인, 파일 백업도 서로 다른 보호 수단입니다. 위 표는 사내망에서 실행해 검증한 결과가 아닙니다. 프록시·인증서·접속 허용과 조직 계약은 보안 담당자와 확인하고 실제 사내 코드 대신 합성 자료로 먼저 시험하세요.
같은 과제 비교: OpenCode와 Claude Code에 같은 이슈를 맡겼을 때#
같은 이슈를 맡겨 모델 연결 방식과 권한 요청, 변경 사항을 비교해 보세요.
동일 과제 실측은 아직 없습니다. 비교하려면 같은 저장소와 이슈, 모델 및 권한 설정, 테스트 기준을 기록하고 변경 내용과 실행 결과를 각각 검토하세요. 설치·설정 실행 기록도 아직 수집하지 않았습니다.
남은 실행 증거: OpenCode 설치·설정 transcript(모델 프로바이더 키 설정)는 아직 수집하지 못했습니다. 키와 사내 주소를 제거한 실제 명령·출력이 필요합니다.
가격: 구독과 사용량#
2026-11-01 확인한 OpenCode Go 공식 문서에는 Go 월 $10, Go Plus 월 $40, Go Teams 인당 월 $20이 표시됩니다. Go와 Go Plus는 단일 구성원 워크스페이스용입니다. Go의 모델별 월 한도를 기준으로 5시간 20%, 주간 50%, 월간 100% 한도가 적용됩니다. Extra Usage를 켜면 한도 이후 Console 잔액을 사용하며, Go Teams는 기본 활성화 상태입니다. Go 구독은 OpenCode 사용에 필수가 아닙니다.
Claude 일반 요금 페이지의 개인 월 결제 가격은 Pro $20, Max $100, Ultra $200이며 적용 세금은 별도입니다. 지역·결제 주기·세금에 따라 달라질 수 있으므로 결제 화면에서 다시 확인하세요. 이 금액은 구독료이지 동일한 사용량이나 동일한 과제 비용을 뜻하지 않습니다.
Claude 일반 요금 페이지는 Pro를 연간 구독 할인으로 고르면 월 $17로 표시하고 $200을 선불로 청구한다고 설명합니다. 같은 Pro를 월 결제로 고르면 $20이며, Max와 Ultra는 월 결제 기준으로 표시됩니다. 연간 선불을 월 환산해 월 결제와 같은 칸에 두면 청구 시점과 해지 조건이 달라지므로, 장부에는 결제 주기를 먼저 적어 두세요. 같은 페이지는 표시 가격에 적용 세금이 포함되지 않는다고 명시하므로 세금 칸을 따로 두어야 합니다 (요금 페이지, 2026-11-03 확인).
사용량 한도는 Max가 Pro보다 5시간과 주간 단위로 5배 많고, Ultra는 Pro보다 주간 사용량이 10배이며 인증된 계정에는 5시간 한도가 없다고 같은 요금 페이지가 설명합니다. 따라서 한도 비교는 플랜 이름이 아니라 시간 단위와 인증 조건을 함께 적으세요 (요금 페이지, 2026-11-03 확인).
| 청구 경로 | 요청 비용을 확인할 곳 | 다른 경로와 섞지 않을 것 |
|---|---|---|
| OpenCode Console 종량제 | 선택 모델의 토큰 요금, 크레딧 구매 수수료와 잔액 | 무료 모델의 기간·데이터 예외; Go 구독 한도와는 별도 |
| OpenCode Go | 월 구독과 모델별 기간 한도, Extra Usage | 포함량 소진 후 Console 잔액 사용 설정 |
| Claude 구독 또는 API | 실제 인증 경로의 구독 사용량 또는 API 사용량 | 구독료를 냈다는 사실만으로 별도 API 요청 비용을 포함하지 않음 |
같은 월 요금이라도 사용할 수 있는 모델과 사용량 단위가 달라 작업당 비용은 따로 기록하세요. OpenCode의 제공자 연결을 바꾼 경우에는 새 제공자의 과금·데이터 조건도 다시 확인하세요.
미르 코드가 맞는 경우 / 맞지 않는 경우#
Mirr Code는 한국어 작업에 초점을 둔 터미널 코딩 에이전트를 찾는 경우 함께 살펴볼 수 있습니다. 반대로 여러 제공자를 직접 고르는 것이 우선이거나 기존 Claude 구독·IDE 연동이 중요하다면 OpenCode 또는 Claude Code가 더 맞을 수 있습니다. 현재 요금과 조건, 모델 정보, 한계를 확인하세요. 같은 과제의 우열을 입증하는 비교 결과는 아직 없습니다.
모델 선택권은 연결 뒤의 운영까지 포함합니다#
모델 목록이 길다는 사실은 원하는 모델을 현재 계정에서 사용할 수 있다는 보증이 아닙니다. 연결 가능한 제공자, 조직이 허용한 제공자와 실제로 결제할 수 있는 계정이 겹쳐야 작업을 시작할 수 있습니다. OpenCode의 여러 제공자 연결은 선택지를 넓히지만 인증과 청구, 데이터 조건을 확인할 대상도 늘립니다. Claude Code도 구독 외의 제공 경로가 있으므로 하나의 고정 청구 방식으로 설명하면 안 됩니다. 이번 비교에서는 설치할 프로그램과 요청을 받는 모델 제공자를 나눠 판단하는 편이 낫습니다.
원하는 모델부터 정한 다음 접근 조건을 보세요. 사내에서 승인한 엔드포인트가 있다면 클라이언트에서 연결할 수 있는지, 필요한 기능이 그 경로에서 지원되는지 확인할 차례입니다. 모델 이름이 같아도 라우팅, 인증과 사용 정책이 같다고 가정하지 않습니다. 같은 제공자의 직접 API와 중개 서비스도 다른 계약일 수 있습니다. 과제를 시작하기 전에 선택한 경로를 기록하면 비용과 오류의 원인을 좁힐 수 있습니다.
OpenCode V2의 policies 항목은 제공자 사용을 allow나 deny로 정하고, MCP 서버, skill, plugin의 사용도 같은 형식으로 막을 수 있다고 설정 문서가 설명합니다. 문서 예시는 모든 제공자를 deny로 두고 anthropic만 allow로 여는 구성입니다. 조직의 허용 제공자 목록을 설정 파일로 옮긴다면 항목의 순서와 더 넓은 범위의 구성이 덮어쓰는 규칙을 함께 확인하세요. 콘솔 관리 정책도 정책 가이드에서 다룬다고 안내합니다 (설정 문서, 2026-11-03 확인).
OpenCode 설정은 내장 에이전트를 바꾸거나 자체 모델, 지침, 모드와 권한을 가진 전문 에이전트를 정의할 수 있다고 문서가 설명합니다. 문서 예시는 검토만 하는 하위 에이전트에 편집을 거부하는 규칙을 붙이는 구성입니다. 같은 형식에서 셸 명령 git push는 확인을 묻는 규칙으로 둘 수 있다는 예도 있습니다. 두 도구의 권한 차이를 비교할 때는 전역 규칙과 에이전트별 규칙을 나눠 기록하세요 (설정 문서, 2026-11-03 확인).
OpenCode V2와 Claude Code의 권한 규칙을 혼용하지 마세요#
2026-11-03 확인한 OpenCode V2 권한 문서는 순서가 있는 규칙에서 마지막 일치가 적용된다고 설명합니다. V1과 V2의 필드와 행동 이름도 구분합니다. Claude Code 권한은 deny, ask, allow 순서로 규칙을 평가한다고 설명합니다. 두 문서에서 비슷한 단어를 보더라도 같은 설정 파일을 복사할 수 있다는 뜻은 아닙니다. 과거 블로그의 설정을 쓰기 전에 대상 버전과 공식 안내를 대조하세요. 이 글은 현재 V2 안내를 기준으로 설명합니다.
지침과 실행 권한도 다릅니다. 모델에게 비밀 파일을 읽지 말라고 요청하는 문장은 행동 지침이며, 도구가 실제로 접근을 거부하는 정책과 같지 않습니다. 또한 셸이 호스트 사용자의 권한으로 실행되는 경로에서는 명령 허용만으로 파일과 네트워크가 모두 격리됐다고 볼 수 없습니다. OpenCode 문서는 셸 경로 추론이 최선 노력 방식이라고 명시합니다. 필요한 경우 조직이 승인한 별도 격리 환경을 검토하세요.
사내망 검증을 준비하는 순서#
먼저 조직이 허용한 요청 목적지를 정하세요. 모델 서비스 외에도 인증, 업데이트와 선택한 확장이나 도구가 사용하는 경로가 있을 수 있습니다. 프로그램이 실행됐다는 사실만으로 필요한 모든 경로가 허용됐다고 볼 수 없습니다. 반대로 일부 부가 기능이 막혔다고 코드 작업 전체가 불가능하다고 단정할 수도 없습니다. 실제로 필요한 기능을 기준으로 접속을 분류하세요. 접속 허용 목록은 현재 공식 문서와 조직 정책을 바탕으로 작성하고 임의의 광범위한 도메인을 추가해 해결하려 하지 않습니다.
인증서 오류를 해결하려고 검증을 끄는 방법을 기본 절차로 삼지 마세요. 먼저 회사가 배포한 신뢰 설정과 해당 실행 환경이 사용하는 신뢰 저장소를 담당자와 확인합니다. 승인된 설정이 있어도 로컬 터미널과 다른 실행 환경에서 동일하게 적용되는지는 별도 시험입니다. 인증 성공 뒤에는 기밀 자료 없이 작은 요청을 보내 응답과 청구 경로를 확인할 수 있습니다. 이러한 요청은 별도의 실행 승인이 있을 때 진행할 일이며, 이 페이지는 계정이나 키를 사용해 실행하지 않았습니다.
관리 기기 전체에서 게이트웨이 외의 주소를 막으려면 관리 설정 파일에 allowedProviders를 customEndpoint로 두고 env 블록에 게이트웨이의 ANTHROPIC_BASE_URL을 넣는 구성을 문서가 소개합니다. 이 구성에서는 개발자의 프록시나 Anthropic 직접 연결을 가리키는 세션이 거부된다고 설명합니다 (게이트웨이 문서, 2026-11-03 확인). 실제 기기에서 거부되는지는 승인된 환경에서 따로 시험해야 합니다.
데이터 처리를 네 묶음으로 검토합니다#
앞의 개인정보 표를 읽을 때 특히 Console 경로의 예외를 유지하세요. Console 문서의 무료 모델 개선 이용이나 보관 조건은 개인 키로 연결한 모든 제공자의 공통 정책이 아닙니다. Go 역시 선택한 모델과 워크스페이스의 개인정보 조건을 봐야 합니다. Claude Code의 개인 계정과 상업용 계약도 다릅니다. 학습에 쓰지 않는다는 문구를 보관이 전혀 없다는 뜻으로 바꾸지 마세요. 로컬에서 작업한다는 표현도 네트워크로 코드가 전달되지 않는다는 뜻은 아닙니다.
실제 검토에서는 데이터 종류별로 허용 여부를 적는 편이 좋습니다. 공개 코드, 내부 코드, 고객 입력과 비밀값을 한 칸에 넣지 마세요. 조직이 내부 코드의 전송을 허용해도 고객 개인정보를 같은 경로에 보낼 수 있다는 뜻은 아닙니다. 로그를 공유할 때도 필요한 부분만 발췌하고 식별 정보와 키를 제거해야 합니다. 익명화했다고 주장하려면 제거 범위와 검토자를 정해야 하며, 이 페이지에는 그러한 실제 보안 검토 결과가 없습니다. 현재 표는 공개 정책의 비교입니다.
키와 구독을 구분하는 비용 장부#
API 키가 있다는 사실만으로 어떤 지갑에서 비용이 나가는지 알 수는 없습니다. 키가 가리키는 제공자와 워크스페이스, 연결한 구독과 종량제 잔액을 확인하세요. OpenCode Go를 사용하다 한도 이후 잔액이 사용되는 경로와 다른 제공자의 직접 API를 연결하는 경로는 별개입니다. Claude 구독 로그인과 API 인증도 분리해야 합니다. 여러 경로를 시험하는 기간에는 요청별로 경로를 남겨야 중복 청구로 오해하거나 빠뜨리는 일을 줄일 수 있습니다. 키 자체를 장부에 복사할 필요는 없습니다.
ANTHROPIC_BASE_URL로 게이트웨이 주소만 바꾸면 요청은 게이트웨이를 거치지만, 게이트웨이 자격을 함께 두지 않으면 저장된 claude.ai 로그인이 여전히 활성 자격으로 남습니다. 이때는 그 구독의 사용량 한도와 청구가 그대로 적용된다고 게이트웨이 문서는 설명합니다. API 키 경로와 구독 로그인 경로를 같은 칸에 적지 않는 것이 출발점입니다. 주소를 바꿨다는 사실만으로 구독 비용이 모두 사라졌다고 장부에 적지 마세요 (게이트웨이 문서, 2026-11-03 확인).
게이트웨이가 요청을 Anthropic으로 다시 넘긴다면 anthropic-beta 헤더에서 OAuth 기능을 전달해야 한다는 조건도 같은 문서에 있습니다. 이 항목은 게이트웨이 운영 담당자가 확인할 필수 조건으로 장부 옆에 적어 두세요.
게이트웨이 운영 세부 사항은 별도의 호환 안내에 있습니다. 이 안내는 Claude Code가 게이트웨이로 보내는 엔드포인트, 전달해야 할 헤더와 기능 pass-through를 운영자용으로 다룬다고 설명합니다. 사내 게이트웨이가 이 항목을 충족하는지 확인표를 만들어 두면, 구독 로그인 경로와 API 경로를 같은 칸에 섞는 판단을 줄일 수 있습니다 (게이트웨이 문서, 2026-11-03 확인).
| 장부 항목 | 기록할 내용 | 분리하는 이유 |
|---|---|---|
| 클라이언트 | 제품과 설치 버전 | 설정 문법과 기능 범위를 구분 |
| 인증 경로 | 구독 로그인 또는 제공자 연결 | 청구 주체와 접근 조건 식별 |
| 모델 | 실제 선택 식별자와 제공 경로 | 같은 이름의 다른 계약 혼동 방지 |
| 포함 사용 | 기간과 사용량 화면의 단위 | 요청 수와 토큰·크레딧을 섞지 않음 |
| 추가 사용 | 허용 여부와 실제 차감 경로 | 기본 구독료와 별도 비용 구분 |
| 관리 작업 | 키 회수, 정책 변경과 담당자 | 운영에 드는 일을 비용 판단에 반영 |
이 표는 장부의 필드이며 완료된 작업당 비용표가 아닙니다. 포함 사용량의 표시 단위를 임의로 같은 요청 수로 환산하지 마세요. 여러 모델을 바꾸며 시험했다면 한 과제의 총량과 모델별 사용을 함께 기록할 수 있습니다. 캐시나 긴 대화의 영향도 실제 내역 없이 단가 차이로 추정하지 않습니다. 예산을 초과할 때는 멈출지, 다른 승인 경로를 쓸지 미리 정하세요. 자동으로 더 비싼 경로에 연결하는 것은 기능 선택과 다른 지출 결정입니다.
설치 기록을 공개할 때 필요한 내용#
아래 연결 예시는 공식 V2 문서에 따른 구성과 진단을 설명하며 실행한 transcript가 아닙니다. 공개 기록을 남긴다면 제품 버전과 운영체제, 인증 종류를 적고 키와 사내 주소는 제외해야 합니다.
V2 연결 구성을 읽는 구체적인 예시#
OpenCode V2 제공자 문서에서 연결과 모델 선택은 분리됩니다. /connect로 제공자 계정을 연결한 뒤 /models에서 모델을 선택하는 흐름입니다. 직접 구성하는 제공자에는 providers 아래의 제공자 ID, 통신할 runtime package와 settings.baseURL, 모델 목록이라는 서로 다른 항목이 있습니다. 아래에서는 사내 게이트웨이를 이미 승인받았다고 가정한 설정 설계를 설명합니다.
예를 들어 사람이 읽는 이름을 company/coder로 두고 실제 제공자에 보내는 식별자를 별도의 modelID로 매핑할 수 있다고 문서가 설명합니다. 이때 company는 OpenCode가 참조하는 제공자 ID이고 coder는 선택 목록의 모델 ID입니다. 화면의 별칭을 바꾸는 일과 게이트웨이가 실제로 받는 모델을 바꾸는 일이 분리됩니다. 운영자가 별칭은 유지하고 상류 모델을 교체하려 한다면 modelID와 실제 계약을 검토할 일이고, 별칭만 보기 좋게 고쳤다면 요청 대상이 바뀌었다고 보고할 이유는 없습니다.
통신 package는 또 다른 결정입니다. OpenAI 호환 형식을 쓰는 게이트웨이라면 공식 문서의 호환 runtime과 해당 엔드포인트의 요구를 대조해야 합니다. settings는 package별로 의미가 달라 선택한 package가 지원하지 않는 옵션은 효과가 없습니다. 이름이 같은 설정 키를 다른 package로 복사하면 같은 동작이 보장된다는 뜻이 아닙니다. 사내 게이트웨이를 도입할 때 모델 선택의 자유는 이 통신 조합을 운영할 책임까지 포함합니다.
Claude Code에서는 먼저 기존 구독, Console 또는 지원되는 클라우드 제공 경로 중 무엇을 사용할지 정합니다. 인증 문서는 각 경로의 로그인을 나눠 설명합니다. 이미 조직의 Anthropic 또는 클라우드 계약이 있다면 그 경로의 인증과 사용량을 활용하는 안을 검토할 수 있습니다. OpenCode의 임의 제공자 목록과 같은 방식이라고 묶기보다, 사용할 수 있는 Claude 연결 경로 안에서 조직의 인증과 비용을 어떻게 유지할지 보는 비교입니다.
오류 계층을 구성 항목에 연결하기#
| 문제를 좁힐 계층 | OpenCode V2에서 대조할 구성 | Claude Code에서 대조할 경로 | 다음 판단 |
|---|---|---|---|
| 요청 목적지 | 제공자 ID와 settings.baseURL | 선택한 인증·클라우드 제공 경로 | 의도한 서비스에 연결하는가 |
| 전송 형식 | runtime package와 엔드포인트 지원 | 해당 연결 방식의 요구 조건 | 서로 맞는 형식인가 |
| 인증 | 연결 계정 또는 설정한 credential 참조 | 구독·Console·클라우드 인증 | 선택 경로의 권한인가 |
| 모델 라우팅 | 선택 모델 ID와 실제 modelID | 계정·경로에 제공되는 모델 | 표시 이름과 요청 대상이 맞는가 |
| 도구 실행 | V2 permissions와 별도 정책 | 도구 규칙과 현재 모드 | 모델 응답 이후 행동을 허용하는가 |
이 표의 장점은 연결 실패를 파일 권한 설정으로 해결하려 하지 않게 하는 데 있습니다. 모델 목록을 선택했는데 요청 형식이 맞지 않는다면 셸의 읽기 권한을 넓혀도 그 불일치를 해결하지 못합니다. 반대로 모델 응답을 받았지만 파일 수정이 금지됐다면 제공자 키를 다시 만드는 것이 먼저가 아닙니다. 앞의 V2 마지막 일치 규칙과 Claude의 deny 우선 규칙은 이 마지막 계층에서 읽을 조건입니다. 연결과 실행이라는 서로 다른 문제를 구분해 필요한 담당자에게 전달할 수 있습니다.
프로바이더 요청의 실패에는 시간 제한도 관계될 수 있습니다. 현재 OpenCode 제공자 문서는 응답 헤더를 기다리는 제한과 스트리밍 응답의 조각 사이 제한을 나눠 설명합니다. 요청 시작부터 아무 응답이 없는 경우와 생성이 시작된 뒤 중간에 끊기는 경우는 관찰 위치가 다릅니다. 긴 코드 생성이 끊겼다는 이유로 모델을 바꾸기 전에 어느 제한에 해당하는지 확인할 수 있습니다. 실제 값은 사용하는 버전과 설정 문서를 따라야 하며 이 글은 시간 제한이나 재시도 횟수를 실측하지 않았습니다.
제공자·모델·variant의 설정 우선순위#
V2 제공자 구성의 env는 credential을 제공할 수 있는 환경 변수 이름을 순서 있는 목록으로 설명합니다. 공용 설정에 키 문자열을 적는 대신 어떤 이름의 credential을 준비해야 하는지 표현하는 구성입니다. 목록의 이름과 실제 비밀값은 다른 자료이므로 담당자가 회수와 교체를 관리할 수 있도록 경로를 나눕니다.
이 구조에서는 게이트웨이 주소를 바꾸는 담당자와 credential을 배포하는 담당자가 달라도 구성의 목적을 설명할 수 있습니다. 인증 오류를 모델 품질의 실패로 분류하기 전에 어떤 제공자와 credential 경로를 선택했는지 읽는 이유입니다. 모델 목록을 넓히는 선택과 인증을 운영하는 선택을 함께 비교할 수 있습니다.
OpenCode V2 제공자 문서는 headers와 body를 제공자 단위로 두거나 특정 모델이나 variant에만 둘 수 있다고 설명합니다. 같은 제공자의 모든 요청에 붙이는 헤더와 특정 모델에만 붙이는 헤더를 나눌 수 있는 구조입니다. 팀 전체의 gateway 식별 정보가 필요한 경우와 일부 모델의 요청 옵션이 필요한 경우를 같은 전역 문자열로 처리하지 않아도 됩니다. 이 자유를 쓰는 팀은 어느 계층에서 최종 값이 정해지는지 관리하세요.
예시로 제공자에는 조직용 요청 메타데이터를, 특정 모델에는 그 모델만 지원하는 출력 옵션을 둔다고 생각할 수 있습니다. 모델을 바꾸고도 예전 옵션이 남으면 새 package가 그것을 지원하는지 확인하세요. 설정 파일에 값이 보인다는 이유만으로 최종 요청의 값을 단정하지 않습니다. 실제 요청을 관찰할 권한이 있는 운영자가 비밀값 없이 적용 결과를 확인할 영역입니다.
Claude Code를 기존 계약의 경로로 운영한다면 제공자별 임의 구성의 폭보다 계정과 관리 설정의 일관성이 중요한 기준이 될 수 있습니다. 여러 제공자를 일상적으로 바꿔야 하는 팀과 승인된 하나의 경로를 안정적으로 유지하려는 팀은 운영할 설정의 종류가 다릅니다. 두 제품의 장점을 이 책임의 차이로 읽을 수 있습니다.
Claude Code 설정은 관리 설정, 명령줄의 --settings, 프로젝트 로컬, 공유 프로젝트, 사용자 파일 순서로 높은 쪽 값을 쓴다고 설정 문서가 설명합니다 (설정 문서, 2026-11-03 확인). 다만 권한 허용 목록처럼 리스트 키는 여러 파일에서 하나를 고르지 않고 합쳐집니다. 환경 변수는 이 단계에 들어가지 않고 키마다 짝이 정해진다고도 설명합니다. 관리 설정이 availableModels를 정하면 사용자, 프로젝트, 로컬 파일의 모델 항목은 무시되므로 모델 목록이 조직에 고정됐는지는 이 키를 보고 확인하세요.
Claude Code에서 설정이 실제로 적용됐는지는 세션의 /status에서 읽은 설정 파일 목록으로 확인하고, 거부된 항목은 claude doctor로 찾는다고 설정 문서가 설명합니다. 다만 /status 목록은 어느 파일이 읽혔는지만 보여 주고 키마다 출처 파일을 알려 주지 않습니다. 비대화형 -p 실행은 깨진 설정을 대화창 없이 건너뛰므로, 설정이 무시된 것처럼 보이면 claude doctor를 먼저 실행하라는 안내도 있습니다. 설정 파일은 엄격한 JSON이라 주석이 있으면 설정 오류로 보고된다고 명시합니다 (설정 문서, 2026-11-03 확인).
관리 설정이 가장 높은 계층이라는 원칙에도 예외가 있습니다. 설정 문서는 보안에 민감한 몇몇 키에서 하위 계층이 더 엄격한 값을 주면 Claude Code가 그 값을 따른다고 설명하고, 예외 키의 목록을 따로 제공합니다. 관리 정책을 적용했다고 장부에 적을 때는 예외 키가 포함되는지도 함께 확인하세요 (설정 문서, 2026-11-03 확인).
팀이 같은 설정을 쓰려면 .claude/settings.json을 저장소에 커밋하라고 설정 문서가 안내합니다. 구성원은 자기 .claude/settings.local.json에서 개인 예외를 덮어쓸 수 있어 개인 설정을 커밋할 필요가 없습니다. 장부에는 공유 설정의 커밋 여부와 구성원별 로컬 예외를 함께 적으세요 (설정 문서, 2026-11-03 확인).
개인정보 예외가 바꾸는 실제 선택#
게이트웨이용 추가 헤더를 공용 설정에 두는 경우에도 이름과 값의 성격을 구분하세요. 팀을 식별하는 공개 메타데이터와 credential을 같은 공유 예제로 넣지 않고, 실제 인증 값은 승인된 경로에서 관리하는 구성이 필요합니다.
무료 모델의 개선 이용 예외를 받아들이지 않는 조직이라면 가격이 무료라는 이유로 그 경로를 후보에 남길 수는 없습니다.
운영 결론은 단순히 API 키와 구독 중 하나를 고르는 것이 아닙니다. OpenCode에서 연결한 제공자와 Console·Go를 구분하고, Claude Code에서 실제 인증한 계약 경로를 고른 뒤, 필요한 통신과 실행 설정을 유지할 담당자를 정하는 일입니다.
수정·보완 기록#
모델 선택권과 청구 경로를 양자택일로 설명하지 않도록 보완했습니다. 설치·키 설정 기록은 미수집 상태로 유지했으며, 가격 문서의 한도 설명을 사내망 동작이나 실제 청구액의 검증으로 보지 않았습니다.
검증일 · 출처#
위 공식 문서와 요금 자료는 2026-11-01 확인했습니다.
출처: OpenCode 소개, OpenCode Go, Claude Code 소개, Claude 요금. 가격과 한도는 변경될 수 있습니다.
📋 증거 체크리스트
- OpenCode 설치·설정 transcript(모델 프로바이더 키 설정)
- 양쪽 공식 문서의 데이터·보안 조건 비교와 출처 정리(2026-11-02 추가 확인; 실제 사내망·보안 시험 아님)
- 청구 구조 비교표(키·구독·한도): 위 표와 요금 설명. 실제 청구액은 별도 확인 필요.