Grok 4.7 사용법: API·Cursor·Grok Build
목차
Grok 4.7 사용법을 찾는다면 먼저 모델 ID가 grok-4.7이라는 점부터 확인하시면 됩니다. xAI는 2026년 9월 21일 Grok 4.7을 출시했으며, 이 모델은 코딩·에이전트 작업·지식 업무를 겨냥한 최신 프런티어 모델입니다. 컨텍스트 윈도는 500,000토큰이고, 지식 기준일은 2026년 5월입니다. 텍스트와 이미지 입력을 받고 텍스트를 출력하며, Responses API와 Chat Completions를 모두 지원합니다.
다만 지식 기준일 이후의 최신 정보가 모델 안에 자동으로 들어 있는 것은 아닙니다. 최신 웹 정보나 X 게시물을 확인하려면 공식 API의 웹 검색 또는 X 검색 도구를 요청에 함께 넣어야 합니다. 이 글은 2026년 9월 22일 공식 문서 기준으로 Grok 4.7의 사양, Grok 4.6과의 차이, 경쟁 모델 비교, API·Cursor·Grok Build 사용 절차를 정리한 독립 가이드입니다.
Grok 4.7은 무엇이며 누가 사용하면 좋을까

핵심 답변: 장시간 작업을 위한 Grok 최신 모델입니다
Grok 4.7은 단순한 대화형 모델보다 여러 단계가 필요한 코딩, 문서 작성, 조사, 에이전트 작업에 맞춰 설계되었습니다. 에이전트는 모델이 파일을 읽고 도구를 호출하며 결과를 확인하는 작업 방식을 뜻합니다. xAI 공식 발표는 Grok 4.7이 어려운 작업을 더 오래 수행하고, 자신의 결과를 더 꼼꼼하게 검증하며, 긴 맥락을 관리하도록 개선됐다고 설명합니다. 자세한 변경 방향은 xAI 공식 Grok 4.7 발표에서 확인할 수 있습니다.
적합한 작업과 신중해야 할 작업
대규모 코드베이스의 버그 분석, 여러 파일에 걸친 리팩터링, 긴 보고서 구조화, 조사 결과를 문서로 정리하는 업무라면 Grok 4.7을 우선 검토할 수 있습니다. 반대로 단순 번역이나 짧은 문장 생성만 필요하다면 긴 추론과 도구 호출이 오히려 비용과 지연을 늘릴 수 있으므로 작은 모델 또는 짧은 프롬프트가 더 적합할 수 있습니다.
또한 모델의 답변은 공식 문서나 원자료를 대신하지 않습니다. 법률·의료·보안처럼 오류 비용이 큰 업무에서는 검색 결과의 출처를 확인하고, 생성된 코드와 문서를 사람이 검토해야 합니다.
Grok 4.7 공식 사양과 지원 기능
모델 ID·컨텍스트·입출력
| 항목 | Grok 4.7 공식 값 | 실무 의미 |
|---|---|---|
| 모델 ID | grok-4.7 | API 요청의 model 필드에 사용합니다. |
| 출시일 | 2026년 9월 21일 | xAI 공식 발표일 기준입니다. |
| 컨텍스트 윈도 | 500,000토큰 | 긴 코드·문서·도구 결과를 한 작업에 넣을 수 있습니다. |
| 지식 기준일 | 2026년 5월 | 그 이후 정보는 검색 도구로 확인해야 합니다. |
| 입력·출력 | 텍스트·이미지 입력, 텍스트 출력 | 이미지 분석은 가능하지만 공식 사양상 이미지 출력 모델은 아닙니다. |
여기서 토큰은 모델이 문장을 처리하는 작은 텍스트 단위이며, 컨텍스트 윈도는 한 요청과 대화에서 모델이 참고할 수 있는 입력 범위입니다. xAI 공식 모델 문서는 500,000토큰 컨텍스트, 텍스트·이미지 입력, 텍스트 출력, 출력 길이 제한 없음으로 안내합니다. 최신 값은 xAI Grok 4.7 모델 문서에서 다시 확인하시기 바랍니다.
핵심 기준은 모델 ID grok-4.7, 컨텍스트 500,000토큰, 지식 기준일 2026년 5월입니다. 최신 웹·X 정보는 검색 도구를 켜야 합니다.API와 공식 도구
Grok 4.7은 새로운 통합에 권장되는 Responses API와 이전의 상태 비저장 OpenAI 호환 방식인 Chat Completions를 지원합니다. xAI는 Chat Completions를 Responses API의 predecessor로 설명하며, 새 프로젝트에는 Responses API를 권장합니다.
- Function calling: 모델이 사용자가 정의한 외부 함수를 호출하도록 연결합니다.
- Web Search: 실시간 웹 검색과 페이지 탐색을 수행합니다.
- X Search: X 게시물·사용자·스레드를 검색합니다.
- Code Execution: xAI 서버의 실행 환경에서 코드를 실행해 계산이나 데이터 처리를 수행합니다.
웹 검색과 X 검색은 지식 기준일 이후의 자료를 가져오는 통로이지만, 검색 결과가 항상 정확하다는 뜻은 아닙니다. 결과의 URL과 게시 시점을 확인하고, X 게시물은 원문·작성자·게시 맥락까지 검토하는 편이 안전합니다. 도구의 요청 형식은 xAI 도구 개요, 웹 검색은 Web Search 공식 문서, X 검색은 X Search 공식 문서를 참고하세요.
Grok 4.6 대비 달라진 점

모델 구조와 장시간 작업 개선
xAI 공식 발표에서 확인되는 가장 중요한 차이는 더 큰 기반 모델과 장시간·고난도 작업을 겨냥한 강화학습입니다. xAI는 Grok 4.7이 Grok 4.6보다 더 큰 기반 모델을 사용하고, 수시간이 걸리는 문제에 가중치를 둔 더 긴 강화학습을 진행했다고 설명합니다. 다만 파라미터 수, 학습 데이터 규모, 특정 기업 내부 데이터 사용 여부는 공식 발표에서 확인되지 않으므로 단정해서는 안 됩니다.
또한 Grok 4.7은 자체 검증과 긴 맥락 관리가 개선됐으며, Grok Bot 하네스를 네이티브하게 이해하도록 학습됐다고 xAI는 밝힙니다. 하네스는 모델이 도구·파일·에이전트 루프와 상호작용하는 실행 구조를 뜻합니다. 이 설명은 장기 작업 흐름에 관한 공식 발표이지, 모든 실사용 환경에서 항상 더 우수하다는 보장은 아닙니다.
컨텍스트와 기본 단가는 동일합니다
| 비교 항목 | Grok 4.7 | Grok 4.6 |
|---|---|---|
| 컨텍스트 윈도 | 500,000토큰 | 500,000토큰 |
| 기본 입력 단가 | $2.00/100만 토큰 | $2.00/100만 토큰 |
| 캐시 입력 단가 | $0.50/100만 토큰 | $0.50/100만 토큰 |
| 기본 출력 단가 | $6.00/100만 토큰 | $6.00/100만 토큰 |
| 긴 컨텍스트 단가 | 공식 가격표상 200k 이상 $4/$1/$12 | 공식 가격표상 200k 이상 $4/$1/$12 |
따라서 4.7은 4.6보다 컨텍스트 한도나 기본 토큰 단가가 커진 모델이 아닙니다. 차이는 주로 모델 학습과 장시간 작업 수행 방식에 있습니다. xAI 가격표는 긴 컨텍스트 요청이 기준을 넘으면 전체 요청에 긴 컨텍스트 단가가 적용될 수 있다고 안내하므로, 실제 비용은 프롬프트 길이·캐시 적중·지역 엔드포인트·우선 처리 여부에 따라 달라질 수 있습니다. 최신 xAI API 가격표를 결제 전에 확인하세요.
새로운 안전장치
xAI는 Grok 4.7에 완전히 새로운 안전장치 스택을 적용했다고 발표했습니다. 특히 사이버보안과 생물학처럼 정상적인 연구와 위험한 요청이 함께 존재하는 이중용도 영역에서 유용성과 위험 요청 거부의 균형을 개선하는 데 초점을 맞췄다고 설명합니다. 이는 xAI가 공개한 평가와 발표에 근거한 내용이며, 모든 상황에서 안전한 결과를 보장한다는 의미는 아닙니다.
프런티어 모델 비교: 코딩·에이전트·문서 업무

비교 기준과 해석 방법
아래 비교 대상은 xAI 공식 Grok 4.7 발표에 함께 표기된 Grok 4.6, GPT-5.6 Sol, Claude Fable 5.1입니다. 벤치마크 수치는 xAI 자체 발표값이며, 모델별 노력 수준·도구 사용·평가 조건이 다를 수 있습니다. 따라서 아래 숫자를 모든 작업의 절대적인 우열로 해석하면 안 됩니다.
| 모델 | 코딩·에이전트 | 문서·지식 업무 | 컨텍스트·가격·도구 |
|---|---|---|---|
| Grok 4.7 | CursorBench 4.0 46.3%, DeepSWE v1.1 71.0% 고노력 설정. 장시간 코딩과 자체 검증을 강조합니다. | AA Briefcase v1.1 1,657. Grok Bot 하네스 이해와 장시간 지식 업무를 강조합니다. | 500k, 기본 $2/$6, 캐시 $0.50. Responses·Chat Completions, 함수 호출·웹 검색·X 검색·코드 실행을 지원합니다. |
| Grok 4.6 | CursorBench 4.0 40.4%, DeepSWE v1.1 65.2%. 장시간 에이전트와 인터랙티브 작업에 초점을 둡니다. | AA Briefcase v1.1 1,546. 복합적인 지식 업무와 시각적·인터랙티브 프로젝트를 강조합니다. | 500k, 기본 $2/$6, 캐시 $0.50. 정확한 사용 가능 도구와 계정 조건은 xAI 공식 문서를 확인해야 합니다. |
| GPT-5.6 Sol | xAI 발표값은 CursorBench 4.0 41.7%, DeepSWE v1.1 72.7%입니다. | OpenAI 계열 모델은 복잡한 전문 업무와 에이전트 작업을 겨냥한 제품군으로 비교할 수 있으며, 최신 모델명·컨텍스트·가격·도구 지원은 OpenAI 공식 모델 카탈로그에서 확인해야 합니다. | OpenAI 공식 모델 카탈로그와 실제 API 배포 경로에서 컨텍스트·가격·도구 지원을 확인합니다. Responses·Chat Completions, 웹 검색·파일 검색·코드 인터프리터·MCP·컴퓨터 사용 등을 OpenAI 공식 문서에서 확인할 수 있습니다. |
| Claude Fable 5.1 | xAI 발표값은 CursorBench 4.0 51.8%, DeepSWE v1.1 70.0%입니다. | Anthropic은 장시간 코딩·에이전트·다단계 지식 업무·비전 활용을 설명합니다. | Anthropic 공식 페이지의 가격은 $10/$50이며 모델 ID는 claude-fable-5-1입니다. 정확한 컨텍스트와 배포별 도구 연동은 공식 문서 확인이 필요합니다. |
GPT-5.6 Sol의 세부 사양은 OpenAI 공식 모델 문서, Claude Fable 5.1의 가격과 사용 범위는 Anthropic 공식 Fable 페이지에서 확인할 수 있습니다. 특히 경쟁 모델의 컨텍스트나 도구 지원은 API·클라우드·IDE 배포 경로에 따라 달라질 수 있으므로 xAI 발표 표만으로 확정하지 않는 것이 좋습니다.
Grok 4.7 API 사용법

1단계: API 키를 만들고 안전하게 보관하기
- xAI Console에서 팀과 결제 상태를 확인합니다.
- API Keys 화면에서 키를 생성합니다.
- 키를 코드에 직접 입력하지 말고 서버 환경변수
XAI_API_KEY로 저장합니다. - Git 저장소·브라우저 코드·클라이언트 앱·오류 로그에 키가 남지 않는지 확인합니다.
- 키가 노출되면 즉시 폐기하고 새 키를 발급합니다.
xAI API는 https://api.x.ai/v1를 사용하고 Bearer 인증을 요구합니다. 팀의 크레딧, 요청 한도, 지역 엔드포인트, 가격은 변경될 수 있으므로 실제 사용 전 xAI REST API 공식 문서와 Console을 함께 확인하세요.
2단계: Responses API로 기본 요청 보내기
아래 예시는 xAI 공식 문서에 맞춘 OpenAI 호환 JavaScript SDK 방식입니다. 새 연동에서는 Responses API를 사용하고, 최신 정보가 필요한 질문에만 서버 측 검색 도구를 추가하는 방식이 관리하기 쉽습니다.
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.XAI_API_KEY,
baseURL: 'https://api.x.ai/v1'
});
const response = await client.responses.create({
model: 'grok-4.7',
input: '이 저장소의 인증 오류 원인을 분석하고 수정 순서를 제안하세요.',
tools: [
{ type: 'web_search' },
{ type: 'x_search' },
{ type: 'code_interpreter' }
]
});
console.log(response.output_text);검색이 필요하지 않은 내부 문서 요약이라면 tools를 빼면 됩니다. 웹 검색은 현재 웹 페이지와 검색 결과를, X 검색은 X 게시물과 스레드를, 코드 실행은 계산·데이터 처리 결과를 보강하는 용도입니다. 도구 호출 비용과 결과 토큰도 사용량에 포함될 수 있으므로 긴 검색을 무조건 켜기보다 작업 목적에 맞게 선택하세요.
3단계: 캐시와 긴 에이전트 루프 관리하기
xAI는 Responses API에서 prompt_cache_key를 설정하고 Chat Completions에서는 x-grok-conv-id 헤더를 활용하면 같은 대화가 같은 서버로 라우팅되어 캐시 적중을 높이는 데 도움이 된다고 안내합니다. 긴 작업에서는 모든 파일을 매번 다시 넣기보다 핵심 파일과 변경 결과를 유지하고, 필요할 때 컨텍스트를 압축하는 편이 비용 관리에 유리합니다.
기본 가격은 입력 $2, 캐시 입력 $0.50, 출력 $6이며 모두 100만 토큰 기준입니다. 200k 이상 긴 컨텍스트 요청은 별도 단가가 적용될 수 있으므로 실제 청구 화면을 확인하세요.
Grok Build와 Cursor에서 실무적으로 쓰는 법

Grok Build 활용 절차
xAI 발표상 Grok 4.7은 Grok Build에서도 제공됩니다. Grok Build는 프로젝트를 읽고 계획을 세우며 파일 편집·터미널 실행·테스트·MCP 연동 등을 수행하는 코딩 에이전트 환경입니다. 다만 제품 화면에 표시되는 기본 모델과 접근 범위는 계정·지역·제품 업데이트에 따라 달라질 수 있습니다.
- Grok Build 공식 페이지의 설치 또는 실행 경로를 확인합니다.
- 작업 폴더를 열고 먼저 요구사항, 변경하지 말아야 할 파일, 실행할 테스트를 구체적으로 적습니다.
- 복잡한 작업은 계획 모드에서 설계와 변경 목록을 먼저 검토합니다.
- 승인 후 파일을 수정하게 하고, 변경 diff와 실행 명령을 확인합니다.
- 테스트 실패·외부 API 호출·삭제 명령은 자동 승인하지 말고 직접 검토합니다.
Cursor에서 모델 선택과 비용 확인
Cursor에서는 채팅 또는 에이전트 패널의 모델 선택기에서 Grok 4.7을 선택하는 방식이 기본입니다. Cursor 공식 문서는 Grok 4.7을 Cursor Models 사용량 풀에 포함된 모델로 안내하지만, 실제 지원 플랜·사용량·온디맨드 요금은 바뀔 수 있습니다. 따라서 Cursor 공식 모델 목록과 계정의 Spending 화면에서 현재 조건을 확인하세요.
긴 코드베이스를 다룰 때는 한 번에 모든 파일을 넣기보다 관련 디렉터리, 재현 명령, 기대 동작, 실패 로그를 먼저 제공합니다. “수정해 주세요”보다 “원인 분석 → 수정안 → 테스트 실행 → 변경 요약 순서로 진행하고, 삭제·의존성 변경 전에는 확인을 요청하세요”처럼 작업 순서를 명시하면 검토가 쉬워집니다.
비용·보안·품질 검증 체크리스트
비용을 통제하는 방법
- 짧은 질의에는 검색·코드 실행 도구를 기본으로 켜지 않습니다.
- 반복되는 시스템 지침과 긴 문서는 캐시 키 사용을 검토합니다.
- 200k토큰을 넘는 요청은 긴 컨텍스트 단가가 전체 요청에 적용될 수 있음을 고려합니다.
- Cursor와 API를 동시에 사용할 때 각각의 사용량 풀과 결제 화면을 따로 확인합니다.
- 가격·지원 플랜·모델 노출 여부는 이 글의 기준일 이후에도 바뀔 수 있습니다.
결과를 검증하는 방법
- 웹 검색 답변은 인용 URL의 원문과 날짜를 확인합니다.
- X 검색 결과는 게시물 하나를 전체 여론으로 일반화하지 않습니다.
- 코드 실행 결과는 입력 데이터와 실행 환경을 함께 기록합니다.
- 에이전트가 수정한 파일을 diff로 확인하고 테스트를 직접 재실행합니다.
- API 키·개인정보·비공개 저장소 내용이 프롬프트와 로그에 포함되지 않았는지 점검합니다.
자주 묻는 질문
Q. Grok 4.7의 공식 모델 ID는 무엇인가요?
공식 모델 ID는 grok-4.7입니다. xAI API의 Responses API와 Chat Completions 요청에서 model 값으로 사용합니다.
Q. Grok 4.7은 실시간 정보를 자동으로 알고 있나요?
아닙니다. 공식 지식 기준일은 2026년 5월이며, 최신 웹이나 X 정보를 확인하려면 Web Search 또는 X Search 도구를 요청에 추가해야 합니다.
Q. Grok 4.7은 Grok 4.6보다 컨텍스트와 가격이 더 큰가요?
공식 문서 기준으로 두 모델 모두 500,000토큰 컨텍스트와 기본 입력 $2, 캐시 입력 $0.50, 출력 $6의 단가를 사용합니다. Grok 4.7의 차이는 더 큰 기반 모델, 장시간 작업 중심 학습, 자체 검증·긴 맥락 관리 개선, Grok Bot 하네스 이해, 새로운 안전장치에 있습니다.
Q. Cursor에서 Grok 4.7을 사용하려면 어떤 요금제가 필요한가요?
지원 플랜과 사용량 정책은 변경될 수 있으므로 Cursor의 현재 모델 목록과 계정 Spending 화면을 확인해야 합니다. 모델 선택기에 Grok 4.7이 표시되는지, 포함 사용량과 온디맨드 요금이 어떻게 적용되는지 함께 확인하세요.