모델 가이드초보자업데이트

Claude Code에서 Grok 4.7 사용하기

Claude Code에 I Code Easy API Key, 루트 URL https://api.icodeeasy.cc, 모델 grok-4.7을 설정하면 본 서비스를 통해 Grok 4.7을 사용할 수 있습니다. macOS, Linux, Windows 설정과 확인 방법을 안내합니다.

Grok 텍스트 모델 확인

Grok은 모델이고 Claude Code는 코딩 클라이언트입니다. 이 문서는 I Code Easy에서 제공하는 Claude Code 연결 방법이며 본 서비스 Key가 필요합니다. xAI API Key나 Grok 계정·구독으로 대체할 수 없습니다. xAI 직접 연결의 인터페이스 지원 범위는 본 서비스와 별개입니다.

grok-4.7은 텍스트 모델 ID입니다. Grok Imagine 이미지·동영상은 별도 모델과 인터페이스를 사용합니다. 아래 변수에 Imagine 모델명을 넣지 말고 이미지 생성 또는 동영상 생성 가이드를 참고하세요.

시작 전 준비

  1. Claude Code 가이드에 따라 설치합니다. 이 설정은 터미널 클라이언트용입니다. Desktop의 별도 게이트웨이 설정은 해당 가이드를 확인하세요.
  2. 가입 후 API Keys에서 본 서비스 Key를 복사합니다. 현재 제공 범위와 선택 가능한 접속점은 콘솔에서 확인합니다. Claude Code용 표시명은 Grok-4.7입니다.
  3. 가격 페이지에서 현재 가격을, 모델 기능 목록에서 필요한 기능을 확인합니다. 공식 구독의 한도와 기능을 본 서비스에 그대로 적용하지 마세요.

설정 요약

변수값
ANTHROPIC_AUTH_TOKENI Code Easy API Key 입력
ANTHROPIC_BASE_URLhttps://api.icodeeasy.cc — 루트 URL만 사용. /v1 또는 /v1/messages 제외
ANTHROPIC_MODELgrok-4.7
ANTHROPIC_DEFAULT_HAIKU_MODELgrok-4.7
ANTHROPIC_DEFAULT_SONNET_MODELgrok-4.7
ANTHROPIC_DEFAULT_OPUS_MODELgrok-4.7
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1

Haiku, Sonnet, Opus 별칭도 grok-4.7을 가리키지만 Grok이 Claude 모델로 바뀌지는 않습니다. 기존 설정이나 실행 인수도 선택에 영향을 주므로 전환 후 확인하세요.

macOS / Linux 설정

Claude Code를 실행할 터미널에 붙여 넣고 Key 자리표시자를 바꾸세요. Key 앞에 Bearer를 추가하지 않습니다. 우선 현재 터미널에 적용됩니다.

export ANTHROPIC_AUTH_TOKEN="I Code Easy API Key 입력"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export ANTHROPIC_MODEL="grok-4.7"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="grok-4.7"
export ANTHROPIC_DEFAULT_SONNET_MODEL="grok-4.7"
export ANTHROPIC_DEFAULT_OPUS_MODEL="grok-4.7"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

계속 사용하려면 같은 export 줄을 사용하는 셸의 ~/.zshrc 또는 ~/.bashrc에 저장하고 터미널을 다시 여세요. Key가 포함된 파일을 저장소에 넣지 마세요. 자세한 내용은 환경 준비를 참고하세요.

Windows PowerShell 설정

Claude Code를 실행할 PowerShell 창에서 설정합니다.

$env:ANTHROPIC_AUTH_TOKEN = "I Code Easy API Key 입력"
$env:ANTHROPIC_BASE_URL = "https://api.icodeeasy.cc"
$env:ANTHROPIC_MODEL = "grok-4.7"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "grok-4.7"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "grok-4.7"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "grok-4.7"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

현재 창과 여기서 시작한 프로세스에만 적용됩니다. 사용자 환경에 저장하려면 GLM Windows 단계에 따라 이 일곱 변수의 현재 값을 저장하세요. 이후 PowerShell을 다시 열고, 통합 터미널을 쓴다면 IDE도 다시 시작합니다.

설정과 첫 요청 확인

버전과 Key 존재 여부를 확인합니다. 아래 명령은 모델 요청을 보내지 않으며 Key 원문도 출력하지 않습니다.

claude --version

macOS / Linux:

test -n "$ANTHROPIC_AUTH_TOKEN" && echo true || echo false

PowerShell:

[bool]$env:ANTHROPIC_AUTH_TOKEN

이 터미널에서 claude를 실행하고 /status로 모델, URL, 인증 정보 출처를 확인하세요. 이어서 직접 “OK만 답해 줘”라고 보내고 요청 로그에서 성공 상태, 모델과 요금을 확인합니다. 실제 요청은 현재 규칙에 따라 과금됩니다.

/status는 로컬 설정만 확인하며 실제 추론 성공을 보장하지 않습니다. 화면의 Claude, Haiku, Sonnet, Opus 이름이나 답변 속 모델의 자기소개만으로 판단하지 말고 로그를 확인하세요.

문제 해결

증상우선 확인할 항목
401본 서비스 Key, 공백, 교체 여부, URL을 확인하세요. Key 전체를 공유하지 마세요.
403계정 상태와 현재 모델 접근 범위를 확인하고 오류 내용과 시간을 기록하세요.
404 / 잘못된 URLANTHROPIC_BASE_URL에는 루트만 넣고 중복된 /v1 또는 /messages를 제거하세요.
429오류 전체를 읽고 동시 요청 수를 줄여 재시도하세요. 항상 잔액 부족을 뜻하지는 않습니다.
다른 모델 / 이전 설정주 모델과 기본 변수 세 개를 확인한 뒤 이전 프로세스를 종료하고 설정한 터미널에서 다시 실행하세요.
시간 초과 / 연결 실패프록시와 네트워크를 확인하고 아래 대체 URL 및 연결 가이드를 참고하세요.

주 URL이 느리면 Key와 모델 변수를 유지하고 ANTHROPIC_BASE_URL만 바꾸세요.

https://jp.icodeeasy.cc
https://sg.icodeeasy.cc

변경 후 Claude Code를 다시 시작하세요. 해결되지 않으면 연결 문제 해결에 따라 오류 코드, 시간대가 포함된 발생 시각, 민감 정보를 지운 로그를 전달하세요. Key 원문은 첨부하지 마세요.

관련 가이드와 참고 자료

관련 가이드

Claude Code 설치, API 설정 및 Windows 오류 해결

Claude Code 설치, API 키와 접속 주소 설정, Windows·macOS·Linux 환경 확인부터 인증 오류와 연결 문제 해결까지 안내하고 Desktop·Kimi·GLM 설정을 연결합니다.

Kimi Code 설정: API Key, K3.1 Pro와 Claude Code

Kimi Code CLI와 Claude Code에서 K3.1 Pro를 설정하세요. 영구·임시 설정, Windows 세션, URL 차이와 첫 호출 확인, 401 및 모델 전환 문제 해결을 안내합니다.

위안화 가격, 잔액, 사용 내역은 어디서 확인하나요?

공개 화면과 대시보드에서 실시간 위안화 가격, 잔액, 요청 로그, 토큰 사용량, 청구 내역, 현재 결제 가능 여부를 확인하는 안내입니다.

가입하고 API Key 받기