---
title: Claude Code | RunAPI
description: Claude Code를 설치하고, RunAPI에 연결하고, 모델을 선택하고, 구성을 확인합니다.
url: https://runapi.ai/ko/docs/resources/tool-integrations/claude-code.md
canonical: https://runapi.ai/ko/docs/resources/tool-integrations/claude-code
locale: ko
---

> HTML 버전: https://runapi.ai/ko/docs/resources/tool-integrations/claude-code
> 에이전트용 사이트 색인: https://runapi.ai/llms.txt

# Claude Code

## 개요

Claude Code는 터미널용 에이전틱 코딩 도구입니다. 이 가이드는 CLI를 설치하고,
Anthropic 호환 요청을 RunAPI로 지정하고, RunAPI 모델을 선택하고, 연결을 확인합니다.

## 시작하기 전에

* [공식 Claude Code 설정 가이드][1]에서 지원하는 플랫폼을 사용하십시오.
* [인증 가이드](https://runapi.ai/ko/docs/guides/authentication.md)에서 표준 RunAPI API 키를 생성하십시오. 리포지토리에 커밋하지 마십시오.
* [모델 카탈로그](https://runapi.ai/ko/models)에서 Anthropic Messages를 지원하는 모델 식별자를 복사하십시오.



[1]: https://code.claude.com/docs/en/setup

## 설치

macOS, Linux, 또는 WSL에서 공식 네이티브 설치 프로그램을 사용한 후, 명령이 사용 가능한지 확인하세요:

```shell
curl -fsSL https://claude.ai/install.sh | bash
claude --version
```

Homebrew, WinGet 및 플랫폼별 요구 사항은 [공식 설치 가이드][1]를 사용하세요.



[1]: https://code.claude.com/docs/en/setup

## RunAPI 구성

첫 번째 테스트를 위해 현재 셸에서 Base URL, API 키, 모델을 내보내세요:

```shell
export ANTHROPIC_BASE_URL=https://runapi.ai
export ANTHROPIC_API_KEY=YOUR_RUNAPI_API_KEY
export ANTHROPIC_MODEL=YOUR_RUNAPI_MODEL_ID
```

사용자의 모든 Claude Code 세션에 값을 적용하려면 `~/.claude/settings.json`의 `env` 객체에 추가하세요:

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}
```

커밋될 수 있는 프로젝트 설정용 `.claude/settings.json`에는 실제 키를 포함하지 마세요. 구성 범위 및 우선 순위에 대해서는 [Claude Code 설정 참조][1]를 사용하세요.



[1]: https://code.claude.com/docs/en/settings

## 모델 선택

`YOUR_RUNAPI_MODEL_ID`를 [모델 카탈로그](https://runapi.ai/ko/models)의 정확한 식별자로 교체하세요.
`ANTHROPIC_BASE_URL`은 요청이 전송되는 위치를 변경하며 모델을 선택하지 않습니다.
`claude
--model YOUR_RUNAPI_MODEL_ID`로 세션을 시작하거나 세션 중에 `/model`을
실행할 수도 있습니다.

## 확인

설치 및 구성 확인을 실행한 후 짧은 프롬프트 하나를 전송하세요:

```shell
claude --version
claude doctor
claude
```

Claude Code 내에서 `/status`를 실행하여 로드된 설정과
활성 모델을 확인하세요. `Describe this repository in one
sentence.`에 대한 정상 응답은 RunAPI 연결이 작동함을 확인합니다.

## 문제 해결

* **`claude`를 찾을 수 없음:** 터미널을 다시 열고 [공식 설치 문제 해결][1]을 따르세요.
* **설정이 로드되지 않음:** `claude doctor`로 `~/.claude/settings.json`을 검증한 후 `/status`를 사용하여 로드된 소스를 검사하세요.
* **인증 실패:** `ANTHROPIC_API_KEY`에 활성 RunAPI 키가 포함되어 있는지 확인하세요. [인증 가이드](https://runapi.ai/ko/docs/guides/authentication.md)를 통해 키를 생성하거나 교체하세요.
* **모델을 사용할 수 없음:** [Model Catalog](https://runapi.ai/ko/models)에서 정확한 식별자를 복사한 후 새 세션을 시작하세요. 재개된 세션은 이전 모델을 유지할 수 있습니다.
* **요청이 다른 엔드포인트를 사용함:** 환경 변수를 변경한 후 새 터미널을 시작하고 더 높은 우선순위의 Claude Code 설정이 있는지 확인하세요.



[1]: https://code.claude.com/docs/en/troubleshoot-install

## 다음 단계

프로토콜 동작은 [LLM API quickstart](https://runapi.ai/ko/docs/guides/llm-api/quickstart.md)를,
요청 필드는 [Anthropic Messages API
Reference](https://runapi.ai/ko/docs/api/anthropic/messages.md)를 참조하세요. Claude Code에
RunAPI 도구를 추가하려면 [MCP
Overview](https://runapi.ai/ko/docs/resources/mcp.md)로 계속 진행하세요.

---

## RunAPI의 더 많은 정보

- [홈](https://runapi.ai/ko/.md)
- [모델 카탈로그](https://runapi.ai/ko/models.md)
- [요금](https://runapi.ai/ko/pricing.md)
- [제공사](https://runapi.ai/ko/models)
- [문서](https://runapi.ai/ko/docs/guides)
- [SDK](https://runapi.ai/ko/sdk.md)
- [CLI](https://runapi.ai/ko/cli.md)
- [MCP Server](https://runapi.ai/ko/mcp.md)
- [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md)
- [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md)
- [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md)
- [엔터프라이즈](https://runapi.ai/ko/contact.md)
- [문의](https://runapi.ai/ko/contact.md)
- [약관](https://runapi.ai/ko/terms.md)
- [개인정보](https://runapi.ai/ko/privacy.md)
- [에이전트용 사이트 색인](https://runapi.ai/llms.txt)

문의: contact@runapi.ai

## 구조화된 데이터

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ko",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ko",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/koicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "TechArticle",
    "headline": "Claude Code",
    "description": "Claude Code를 설치하고, RunAPI에 연결하고, 모델을 선택하고, 구성을 확인합니다.",
    "url": "https://runapi.ai/ko/docs/resources/tool-integrations/claude-code",
    "mainEntityOfPage": "https://runapi.ai/ko/docs/resources/tool-integrations/claude-code"
  }
]
```