무료 Claude Sonnet 4.5: OmniRoute + Node.js

OmniRoute와 Node.js 22으로 클로드 손넷 4.5 무료 접근하기

OmniRoute는 Node.js 버전 22를 반드시 요구합니다. 최신 릴리스는 필요한 종속성 지원이 불가능하므로, nvm을 설치해 노드 버전을 관리하세요.

nvm 설치

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

~/.zshrc 또는 ~/.bashrc에 추가:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

변경 사항 적용:

source ~/.zshrc

Node.js 22 설치 및 활성화:

nvm install 22
nvm alias default 22

버전 확인:

node -v

출력 결과는 v22.x.x 형태여야 합니다.

OmniRoute 설치 및 초기화

전역 설치:

npm install -g omniroute

비밀번호 설정용 구성 파일 생성:

mkdir -p ~/.omniroute
touch .env
echo -n $'\nINITIAL_PASSWORD=your_new_password\n' >> .env

기본 비밀번호: 123456.

실행:

omniroute

비밀번호 입력 후 기본적으로 웹 대시보드가 열립니다.

KiroAi 제공자 설정

OmniRoute 대시보드에서 KiroAi를 선택하고 제공자 구성을 클릭하세요.

AWS Builder ID를 선택하세요. 구글 계정으로 로그인하고 AWS 권한을 승인합니다.

승인 후, 클로드 손넷 4.5를 포함한 사용 가능한 모델들이 제공자 목록에 나타납니다.

API 매니저 → 첫 번째 키 생성으로 이동하여 생성된 API 키를 저장하세요.

엔드포인트에서 기본 URL 복사: http://localhost:20128/v1.

OpenCode와 통합하기

OpenCode 설치:

npm i -g opencode-ai

~/.config/opencode/opencode.json 파일 생성 또는 수정:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omni": {
      "name": "OmniRoute",
      "npm": "@ai-sdk/openai-compatible",
      "models": {
        "kr/claude-sonnet-4.5": {
          "name": "Omni sonnet-4.5"
        },
        "kr/claude-haiku-4.5": {
          "name": "Omni Haiku-4.5"
        }
      },
      "options": {
        "baseURL": "http://localhost:20128/v1"
      }
    }
  }
}

OmniRoute 대시보드에서 모델 ID(kr/claude-sonnet-4.5) 복사: http://localhost:20128/dashboard/providers/kiro.

~/.local/share/opencode/auth.json에 API 키 추가:

{
  "omni": {
    "type": "api",
    "key": "sk-your-api-key"
  }
}

opencode 실행 후 /models 명령어로 모델 선택하기.

설정 단계 요약

| 단계 | 작업 | 명령어/작업 |

|------|--------|----------------|

| 1 | nvm 설치 | curl ... | bash |

| 2 | Node.js 22 | nvm install 22 |

| 3 | OmniRoute 설치 | npm install -g omniroute |

| 4 | .env 구성 | echo INITIAL_PASSWORD=... >> .env |

| 5 | 실행 | omniroute |

| 6 | 제공자 설정 | 구글로 AWS Builder ID 인증 |

| 7 | API 키 생성 | API 매니저 → 키 생성 |

| 8 | OpenCode 설정 | ~/.config/opencode/opencode.json |

| 9 | 인증 설정 | ~/.local/share/opencode/auth.json |

핵심 포인트

• Node.js 버전: 오직 버전 22만 작동합니다. 그렇지 않으면 OmniRoute가 시작되지 않습니다.
• API 키: opencode.json과 auth.json 모두에서 제공자 ID(omni)가 정확히 일치해야 합니다.
• 기본 URL: http://localhost:20128/v1을 사용하세요. 이는 OpenAI API 호환성의 정확한 엔드포인트입니다.
• 인증 방식: 구글을 통해 AWS Builder ID를 사용하면 VPN 없이도 KiroAi 모델에 접근할 수 있습니다.
• 모델 ID: 손넷 4.5는 kr/claude-sonnet-4.5를 사용하세요. OmniRoute 대시보드에서 확인하세요.

이 방법을 통해 구독이나 지역 제한 없이 고성능 모델에 로컬 프록시 방식으로 접근할 수 있습니다. OmniRoute는 OpenAI 호환 API를 지원하므로 기존 워크플로우에 쉽게 통합 가능합니다.

— Editorial Team