ianjwhite99/opencode-with-claude

opencode-with-claude – OpenCode용 Claude-Max 프록시를 번들로 제공하는 플러그인

기능

• OpenCode 플러그인을 제공하여 Meridian 프록시(Claude Agent SDK를 통해 Anthropic의 Claude Max와 통신하는 로컬 서버)를 자동으로 시작하고 중지합니다.
• 프록시는 OpenCode를 시작할 때 실행되고 종료할 때 종료되므로 관리할 프로세스가 하나만 있습니다.
• 동일한 npm 패키지에서 OpenCode 1.x(원래 CLI)와 OpenCode 2(@opencode/cli)를 모두 지원합니다.
• 세션 추적 헤더를 처리하고 여러 OpenCode 창을 나란히 실행할 수 있으며, 기본 포트 3456이 사용 중이면 각 창에 고유한 여유 포트가 할당됩니다.

사용 방법

1. npm 또는 Homebrew로 전역 설치합니다.
2. Claude Agent SDK(@anthropic-ai/claude-code)를 설치하고 한 번 로그인합니다(claude auth login).
3. opencode.json에 플러그인 이름(Homebrew 사용 시 파일 URL)을 추가합니다(두 OpenCode 세대에 대해 다른 키 이름 사용).
4. opencode를 실행합니다. 플러그인이 프록시를 시작하고 Anthropic 공급자의 baseURL을 로컬 서버를 가리키도록 다시 작성한 다음 요청을 전달합니다.

주요 기능

• 수명 주기 관리 – OpenCode가 프록시를 소유하므로 별도의 CLI나 Docker 컨테이너가 필요 없습니다.
• 다중 인스턴스 지원 – 각 OpenCode 프로세스에 고유한 프록시 포트가 할당됩니다.
• 프로필 처리 – Meridian의 profiles.json 및 settings.json을 읽어 개인, 업무 또는 토큰 기반 Claude 계정 간에 전환할 수 있습니다.
• 런타임 구성 – MERIDIAN_PATH 환경 변수를 통해 새 플러그인 릴리스를 기다리지 않고 플러그인을 최신 Meridian 빌드로 지정할 수 있습니다.
• 세션 헤더 – 플러그인은 명시적인 x-meridian-profile 및 기타 ID 헤더를 추가하여 OpenCode의 숨겨진 제목/요약 요청이 세션 임대에 포함되지 않도록 합니다.

설치 및 업데이트

• npm: npm install -g opencode-with-claude 및 npm update -g opencode-with-claude.
• Homebrew: brew install ianjwhite99/tap/opencode-with-claude 및 brew upgrade opencode-with-claude(npm 게시 후 수식이 자동으로 업데이트됨).

문제 해결 팁

• Claude CLI가 설치되어 있는지 확인하세요(npm install -g @anthropic-ai/claude-code).
• claude auth login을 실행하여 유효한 세션을 만드세요.
• 프록시가 시작되지 않으면 인증 상태, 인터넷 연결, 선택한 포트가 이미 사용 중인지 확인하세요.
• CLAUDE_PROXY_HOST를 설정하여 프록시를 localhost 외부에 노출할 수 있습니다(주의해서 사용).

개발 노트

• TypeScript로 작성되었습니다. src/ 폴더에는 플러그인 진입점, 프록시 수명 주기 코드 및 Meridian 구성을 읽는 헬퍼가 포함되어 있습니다.
• 단위 테스트는 test/unit/에 있습니다. 스크립트 test/run.sh는 빌드된 플러그인으로 OpenCode 1.x를 시작하여 수동 테스트를 수행합니다.
• 플러그인은 id, server()(OpenCode 1용) 및 setup()(OpenCode 2용)이 포함된 단일 객체를 내보냅니다.

라이선스 – MIT.

결론 – OpenCode를 사용하고 Claude Max 구독이 있다면, 이 플러그인은 공식 Claude Agent SDK를 통해 OpenCode의 Anthropic 스타일 요청을 라우팅하는 원활한 단일 프로세스 방식을 제공하며 프로필 관리와 쉬운 업데이트를 지원합니다.