---
read_when:
- code_execution을 활성화하거나 구성하려고 합니다
- 로컬 셸 액세스 없이 원격 분석을 원합니다
- 원격 Python 분석과 x_search 또는 web_search를 결합하려는 경우
summary: 'code_execution: xAI로 샌드박스화된 원격 Python 분석 실행'
title: 코드 실행
x-i18n:
generated_at: "2026-07-12T01:20:15Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: 1ab391daed9154f113535e6d241c45d5c08c22abdc012148a9f0f2ae5ec548b3
source_path: tools/code-execution.md
workflow: 16
---
`code_execution`은 xAI의 Responses API에서 샌드박스 처리된 원격 Python 분석을 실행합니다
(`https://api.x.ai/v1/responses`, `x_search`가 사용하는 것과 동일한 엔드포인트). 번들로 제공되는 `xai` Plugin이
`tools` 계약에 따라 등록합니다.
`code_execution`은 xAI 서버에서 실행됩니다. xAI는 도구 호출 1,000회당 5달러와
모델의 입력 및 출력 토큰 요금을 청구합니다.
| 속성 | 값 |
| ------------------ | --------------------------------------------------------------------------------- |
| 도구 이름 | `code_execution` |
| 제공자 Plugin | `xai`(번들 제공, `enabledByDefault: true`) |
| 인증 | xAI 인증 프로필, `XAI_API_KEY` 또는 `plugins.entries.xai.config.webSearch.apiKey` |
| 기본 모델 | `grok-4.3` |
| 기본 제한 시간 | 30초 |
| 기본 `maxTurns` | 설정되지 않음(xAI가 자체 내부 제한 적용) |
계산, 표 작성, 간단한 통계 및 차트 형태의 분석에 사용하세요.
여기에는 `x_search` 또는 `web_search`가 반환한 데이터의 분석도 포함됩니다. 로컬 파일,
셸, 저장소 또는 페어링된 기기에 접근할 수 없으며 호출 간에 상태를 유지하지 않으므로,
각 호출을 노트북 세션이 아닌 일시적인 분석으로 취급하세요. 최신 X 데이터를 사용하려면
먼저 [`x_search`](/ko/tools/web#x_search)를 실행하고 그 결과를 전달하세요.
로컬에서 실행하려면 대신 [`exec`](/ko/tools/exec)를 사용하세요.
## 설정
OAuth를 사용하려면 자격 요건을 충족하는 SuperGrok 또는 X Premium 구독이 필요합니다
(기기 코드 인증을 사용하므로 localhost 콜백 없이 원격 호스트에서도 작동합니다).
```bash
openclaw models auth login --provider xai --method oauth
```
새로 설치하는 동안 온보딩에서도 동일한 옵션을 선택할 수 있습니다.
```bash
openclaw onboard --install-daemon --auth-choice xai-oauth
```
또는 API 키를 사용할 수 있습니다.
```bash
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
```
또는 구성을 통해 설정할 수 있습니다.
```json5
{
plugins: {
entries: {
xai: {
config: {
webSearch: {
apiKey: "xai-...",
},
},
},
},
},
}
```
이 세 가지 방법은 모두 `x_search`와 Grok `web_search`에도 인증을 제공합니다.
`enabled`를 생략하면 활성 모델의 제공자가 `xai`이고 xAI 자격 증명을 확인할 수 있을 때만
`code_execution`이 노출됩니다. 제공자가 xAI가 아닌 것으로 확인된 활성 모델에서 제공자 간
사용을 선택하려면 `plugins.entries.xai.config.codeExecution.enabled`를 `true`로 설정하세요.
활성 모델 제공자가 없거나 확인되지 않으면 도구는 계속 숨겨집니다. 모든 제공자에서 비활성화하려면
`enabled`를 `false`로 설정하세요. xAI 자격 증명은 항상 필요합니다.
동일한 블록을 사용하여 모델, 실행 횟수 상한 또는 제한 시간을 재정의할 수 있습니다.
```json5
{
plugins: {
entries: {
xai: {
config: {
codeExecution: {
enabled: true, // xAI가 아닌 것으로 확인된 모델 제공자에는 필수
model: "grok-4.3", // 기본 xAI 코드 실행 모델 재정의
maxTurns: 2, // 내부 도구 실행 횟수의 선택적 상한
timeoutSeconds: 30, // 요청 제한 시간(기본값: 30)
},
},
},
},
},
}
```
```bash
openclaw gateway restart
```
xAI Plugin이 다시 등록되고 위의 제공자, 활성화 및 인증 검사를 통과하면
에이전트의 도구 목록에 `code_execution`이 표시됩니다.
## 사용 방법
분석 의도를 명확히 밝히세요. 이 도구는 단일 `task` 매개변수를 받으므로
전체 요청과 인라인 데이터를 하나의 프롬프트로 보내세요.
```text
code_execution을 사용하여 다음 숫자의 7일 이동 평균을 계산하세요: ...
```
```text
x_search를 사용하여 이번 주에 OpenClaw를 언급한 게시물을 찾은 다음, code_execution을 사용하여 날짜별로 집계하세요.
```
```text
web_search를 사용하여 최신 AI 벤치마크 수치를 수집한 다음, code_execution을 사용하여 백분율 변화를 비교하세요.
```
## 오류
인증이 없으면 도구는 예외를 발생시키는 대신 구조화된 JSON 오류를 반환하므로
에이전트가 스스로 수정할 수 있습니다.
```json
{
"error": "missing_xai_api_key",
"message": "code_execution needs xAI credentials. Run `openclaw onboard --auth-choice xai-oauth` to sign in with Grok, run `openclaw onboard --auth-choice xai-api-key`, set `XAI_API_KEY` in the Gateway environment, or configure `plugins.entries.xai.config.webSearch.apiKey`.",
"docs": "https://docs.openclaw.ai/tools/code-execution"
}
```
## 관련 항목
사용자 컴퓨터 또는 페어링된 Node에서 로컬 셸을 실행합니다.
셸 실행 허용/거부 정책입니다.
`web_search`, `x_search`, `web_fetch`입니다.
Grok 모델, 웹/X 검색 및 코드 실행 구성입니다.