FreeToken claude code: 모델 라우팅 설정 가이드

FreeToken claude code는 Claude Code와 호환되는 모델 프로바이더 사이에서 작동하는 구성 계층으로 이해하는 것이 가장 좋습니다. 각 클라이언트의 설정을 개별적으로 변경하는 대신, 로컬 게이트웨이를 실행하고 하나의 Admin UI에서 모델을 선택한 다음 터미널 또는 에디터 클라이언트를 해당 게이트웨이에 연결할 수 있습니다.

실질적인 장점은 중앙 집중식 라우팅입니다. 기본 모델은 일반 요청을 처리하고, 별도의 설정을 통해 Fable, Opus, Sonnet 또는 Haiku 스타일의 티어를 서로 다른 호환 모델로 라우팅할 수 있습니다. 따라서 테스트가 쉬워지고 전체 클라이언트 설정을 다시 구성하지 않아도 프로바이더를 변경할 수 있습니다.

다음 단계를 순서대로 진행하세요. 목표는 다음 계층으로 넘어가기 전에 각 계층을 확인하는 것입니다. 이렇게 하면 연결 오류를 훨씬 쉽게 분리하여 해결할 수 있습니다.

처음 성공하는 테스트는 의도적으로 간단해야 합니다. 에이전트에게 작은 프로젝트 파일을 검사하거나, 함수를 설명하거나, 사소한 변경을 제안하도록 요청하세요. 작은 요청만으로도 인증, 모델 액세스, 컨텍스트 처리 및 도구 권한을 함께 확인할 수 있으므로 대규모 리팩터링으로 시작하지 마세요.

모델 선택은 단순히 브랜드 이름이 아니라 작업의 특성을 반영해야 합니다. 코딩 에이전트에는 안정적인 도구 호출, 프로젝트 지침을 처리할 수 있는 충분한 컨텍스트, 일관된 출력 형식이 필요합니다. 채팅에서 성능이 좋은 모델이라도 파일을 검사하고 명령을 실행해야 하는 에이전트에는 적합하지 않을 수 있습니다.

일반 요청에는 기본 MODEL 설정을 사용하세요. 복잡한 추론, 빠른 수정 또는 가벼운 작업에 서로 다른 동작이 필요할 때는 티어별 변수를 사용하여 개별 Claude Code 티어를 재정의할 수 있습니다.

대체 모델을 추가할 때는 요청이 성공하기 전에 둘 이상의 프로바이더에 전달될 수 있다는 점을 기억하세요. 이 경우 여러 계정의 사용량이 차감될 수 있습니다. 목록을 짧게 유지하고 의도적으로 순서를 지정하며, 검토하지 않은 프로바이더로 민감한 프로젝트 콘텐츠를 라우팅하지 마세요.

추론 제어 설정은 클라이언트에서 상속되거나 비활성화되거나 선택한 작업 수준으로 설정될 수 있습니다. 클라이언트 기본값으로 시작하세요. 더 높은 작업 수준은 지연 시간과 리소스 사용량을 늘릴 수 있으므로, 심층적인 계획이 필요한 작업에만 추론 수준을 높이세요.

Claude Code는 로컬 기본 URL과 인증 토큰을 통해 연결할 수 있습니다. 에디터 통합에서는 동일한 값이 게이트웨이 구성과 정확히 일치해야 합니다. 포트, URL 또는 토큰에서 문자 하나만 잘못되어도 프로바이더가 정상적으로 작동하는 상황에서 프로바이더 오류처럼 보일 수 있습니다.

VS Code에서는 게이트웨이 환경 변수를 Claude Code 확장 프로그램 설정에 추가한 다음 확장 프로그램을 다시 로드하세요. Codex App 또는 VS Code의 Codex에서는 적절한 config.toml 파일에 프로바이더 및 모델 설정을 배치하고 모델을 변경한 후 클라이언트를 재시작하세요.

다음 안전 수칙을 사용하세요.

• 프로바이더 자격 증명을 프로젝트 파일 외부에 저장하세요.
• 게이트웨이를 localhost 외부에 노출하기 전에 프록시 인증을 활성화하세요.
• Discord 또는 Telegram 통합을 승인된 사용자, 채널 및 디렉터리로 제한하세요.
• 프롬프트, 로그, 스크린샷 또는 공유 구성 파일에 비밀 정보를 입력하지 마세요.
• 각 봇 및 클라이언트 통합이 요청하는 권한을 검토하세요.
• 전체 홈 폴더에 액세스 권한을 부여하는 대신 프로젝트 디렉터리의 범위를 좁게 유지하세요.

대부분의 설정 문제는 네 가지 범주로 나뉩니다. 서버가 실행되지 않거나, 클라이언트가 잘못된 주소를 가리키거나, 토큰이 일치하지 않거나, 선택한 모델을 사용할 수 없는 경우입니다. 여러 설정을 변경하기 전에 이 조건들을 순서대로 확인하세요.