---
title: Claude 시작하기
url: https://platform.claude.com/docs/ko/get-started
description: Claude에 첫 번째 API 호출을 보내고 간단한 웹 검색 어시스턴트를 만들어 보세요.
---

## 사전 요구 사항

* [Claude Console 계정](https://platform.claude.com)
* [API 키](https://platform.claude.com/docs/ko/get-api-key)

## API 호출하기

<Tabs>
  <Tab title="cURL">
    <Steps>
      <Step title="API 키 설정하기">
        API 키를 환경 변수로 내보내세요. 아래 cURL 명령은 `$ANTHROPIC_API_KEY`에서 API 키를 읽습니다.

        ```bash
        export ANTHROPIC_API_KEY="your-api-key-here"
        ```
      </Step>

      <Step title="첫 API 호출하기">
        Messages API에 `POST` 요청을 보내세요:

        ```bash cURL
        curl https://api.anthropic.com/v1/messages \
          -H "content-type: application/json" \
          -H "x-api-key: $ANTHROPIC_API_KEY" \
          -H "anthropic-version: 2023-06-01" \
          -d '{
            "model": "claude-opus-5-5",
            "max_tokens": 1000,
            "messages": [
              {
                "role": "user",
                "content": "What should I search for to find the latest developments in renewable energy?"
              }
            ]
          }'
        ```

        Claude는 어시스턴트의 메시지가 포함된 JSON 응답을 반환합니다:

        ```json Output
        {
          "model": "claude-opus-5-5",
          "id": "msg_013mHbppMPd2PrVJzGMZPt2D",
          "type": "message",
          "role": "assistant",
          "content": [
            {
              "type": "text",
              "text": "Here are some effective search strategies to find the latest developments in renewable energy:\n\n## General Search Terms\n- \"Renewable energy news 2025\"\n- ..."
            }
          ],
          "stop_reason": "end_turn",
          "stop_sequence": null,
          "stop_details": null,
          "usage": {
            "input_tokens": 21,
            "output_tokens": 305
          }
        }
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI">
    <Steps>
      <Step title="CLI 설치하기">
        Homebrew로 Anthropic CLI를 설치하세요:

        ```bash
        brew install anthropics/tap/ant
        ```

        다른 설치 방법은 CLI 빠른 시작의 [설치](https://platform.claude.com/docs/ko/cli-sdks-libraries/cli/quickstart#installation)를 참조하세요.
      </Step>

      <Step title="인증하기">
        Anthropic 계정으로 로그인하세요:

        ```bash
        ant auth login
        ```

        이렇게 하면 브라우저 기반 OAuth 흐름이 열립니다. 승인한 후 다음 명령으로 자격 증명을 확인하세요:

        ```bash
        ant auth status
        ```

        브라우저가 없는 원격 호스트에서는 `--no-browser`를 전달하여 다른 기기에서 열 수 있는 URL을 받은 다음, 반환된 코드를 터미널에 다시 붙여 넣으세요. 환경에 `ANTHROPIC_API_KEY`가 설정되어 있으면 로그인 자격 증명보다 우선합니다. CI와 같은 비대화형 환경의 경우 [CLI 인증 옵션](https://platform.claude.com/docs/ko/cli-sdks-libraries/cli/authentication)을 참조하세요.
      </Step>

      <Step title="첫 API 호출하기">
        터미널에서 `ant messages create`를 실행하세요:

        ```bash CLI
        ant messages create \
          --model claude-opus-5-5 \
          --max-tokens 1000 \
          --message '{
            role: user,
            content: "What should I search for to find the latest developments in renewable energy?"
          }'
        ```

        CLI가 JSON 응답을 출력합니다:

        ```json Output
        {
          "model": "claude-opus-5-5",
          "id": "msg_01N1ycuCkM5Mzd7WhTU4fwST",
          "type": "message",
          "role": "assistant",
          "content": [
            {
              "type": "text",
              "text": "Here are some effective search strategies to find the latest developments in renewable energy:\n\n## General Search Terms\n- \"Renewable energy news 2025\"\n- ..."
            }
          ],
          "stop_reason": "end_turn",
          "stop_sequence": null,
          "stop_details": null,
          "usage": { "input_tokens": 21, "output_tokens": 305 }
        }
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Python">
    <Steps>
      <Step title="API 키 설정하기">
        API 키를 환경 변수로 내보내세요. SDK는 `ANTHROPIC_API_KEY`를 자동으로 읽습니다.

        ```bash
        export ANTHROPIC_API_KEY="your-api-key-here"
        ```
      </Step>

      <Step title="프로젝트 생성 및 SDK 설치하기">
        ```bash
        mkdir claude-quickstart && cd claude-quickstart
        python3 -m venv .venv && source .venv/bin/activate
        pip install anthropic
        ```
      </Step>

      <Step title="코드 작성하기">
        `quickstart.py`라는 파일을 만드세요:

        ```python Python
        import anthropic

        client = anthropic.Anthropic()

        message = client.messages.create(
            model="claude-opus-5-5",
            max_tokens=1000,
            messages=[
                {
                    "role": "user",
                    "content": "What should I search for to find the latest developments in renewable energy?",
                }
            ],
        )

        for block in message.content:
            if block.type == "text":
                print(block.text)
        ```
      </Step>

      <Step title="코드 실행하기">
        ```bash
        python quickstart.py
        ```

        ```text Output wrap
        Here are some effective search strategies to find the latest developments in renewable energy:

        ## General Search Terms
        - "Renewable energy news 2025"
        - ...
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="TypeScript">
    <Steps>
      <Step title="API 키 설정하기">
        API 키를 환경 변수로 내보내세요. SDK는 `ANTHROPIC_API_KEY`를 자동으로 읽습니다.

        ```bash
        export ANTHROPIC_API_KEY="your-api-key-here"
        ```
      </Step>

      <Step title="프로젝트 생성 및 SDK 설치하기">
        ```bash
        mkdir claude-quickstart && cd claude-quickstart
        npm init -y
        npm pkg set type=module
        npm install @anthropic-ai/sdk
        ```
      </Step>

      <Step title="코드 작성하기">
        `quickstart.ts`라는 파일을 만드세요:

        ```typescript TypeScript
        import Anthropic from "@anthropic-ai/sdk";

        const client = new Anthropic();

        const message = await client.messages.create({
          model: "claude-opus-5-5",
          max_tokens: 1000,
          messages: [
            {
              role: "user",
              content: "What should I search for to find the latest developments in renewable energy?"
            }
          ]
        });

        for (const block of message.content) {
          if (block.type === "text") {
            console.log(block.text);
          }
        }
        ```
      </Step>

      <Step title="코드 실행하기">
        ```bash
        npx tsx quickstart.ts
        ```

        ```text Output wrap
        Here are some effective search strategies to find the latest developments in renewable energy:

        ## General Search Terms
        - "Renewable energy news 2025"
        - ...
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="C#">
    <Steps>
      <Step title="API 키 설정하기">
        API 키를 환경 변수로 내보내세요. SDK는 `ANTHROPIC_API_KEY`를 자동으로 읽습니다.

        ```bash
        export ANTHROPIC_API_KEY="your-api-key-here"
        ```
      </Step>

      <Step title="프로젝트 생성 및 SDK 설치하기">
        새 콘솔 프로젝트를 만들고 Anthropic 패키지를 추가하세요:

        ```bash
        dotnet new console -n ClaudeQuickstart
        cd ClaudeQuickstart
        dotnet add package Anthropic
        ```
      </Step>

      <Step title="코드 작성하기">
        `Program.cs`의 내용을 다음으로 바꾸세요:

        ```csharp C#
        using Anthropic;
        using Anthropic.Models.Messages;

        var client = new AnthropicClient();

        var message = await client.Messages.Create(new MessageCreateParams
        {
            Model = Model.ClaudeOpus5_5,
            MaxTokens = 1000,
            Messages =
            [
                new()
                {
                    Role = Role.User,
                    Content = "What should I search for to find the latest developments in renewable energy?",
                },
            ],
        });

        foreach (var block in message.Content)
        {
            if (block.TryPickText(out var textBlock))
            {
                Console.WriteLine(textBlock.Text);
            }
        }
        ```
      </Step>

      <Step title="코드 실행하기">
        ```bash
        dotnet run
        ```

        ```text Output wrap
        Here are some effective search strategies to find the latest developments in renewable energy:

        ## General Search Terms
        - "Renewable energy news 2025"
        - ...
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Go">
    <Steps>
      <Step title="API 키 설정하기">
        API 키를 환경 변수로 내보내세요. SDK는 `ANTHROPIC_API_KEY`를 자동으로 읽습니다.

        ```bash
        export ANTHROPIC_API_KEY="your-api-key-here"
        ```
      </Step>

      <Step title="프로젝트 생성 및 SDK 설치하기">
        새 모듈을 만들고 Anthropic SDK를 추가하세요:

        ```bash
        mkdir claude-quickstart && cd claude-quickstart
        go mod init claude-quickstart
        go get github.com/anthropics/anthropic-sdk-go
        ```
      </Step>

      <Step title="코드 작성하기">
        `main.go`라는 파일을 만드세요:

        ```go Go
        package main

        import (
        	"context"
        	"fmt"
        	"log"

        	"github.com/anthropics/anthropic-sdk-go"
        )

        func main() {
        	client := anthropic.NewClient()

        	message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
        		Model:     anthropic.ModelClaudeOpus5_5,
        		MaxTokens: 1000,
        		Messages: []anthropic.MessageParam{
        			anthropic.NewUserMessage(anthropic.NewTextBlock("What should I search for to find the latest developments in renewable energy?")),
        		},
        	})
        	if err != nil {
        		log.Fatal(err)
        	}

        	for _, block := range message.Content {
        		if textBlock, ok := block.AsAny().(anthropic.TextBlock); ok {
        			fmt.Println(textBlock.Text)
        		}
        	}
        }
        ```
      </Step>

      <Step title="코드 실행하기">
        ```bash
        go run .
        ```

        ```text Output wrap
        Here are some effective search strategies to find the latest developments in renewable energy:

        ## General Search Terms
        - "Renewable energy news 2025"
        - ...
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Java">
    <Steps>
      <Step title="API 키 설정하기">
        API 키를 환경 변수로 내보내세요. SDK는 `ANTHROPIC_API_KEY`를 자동으로 읽습니다.

        ```bash
        export ANTHROPIC_API_KEY="your-api-key-here"
        ```
      </Step>

      <Step title="프로젝트 설정하기">
        `PATH`에 JDK(25 이상)와 [Gradle](https://gradle.org/install/) 또는 [Maven](https://maven.apache.org/install.html)이 있어야 합니다. 프로젝트용 디렉터리를 만들고 그 안에 Java 소스 디렉터리를 만드세요:

        ```bash
        mkdir -p claude-quickstart/src/main/java && cd claude-quickstart
        ```

        그런 다음 빌드 파일을 추가하세요. 현재 SDK 버전은 [Maven Central](https://central.sonatype.com/artifact/com.anthropic/anthropic-java)에서 확인할 수 있습니다.

        <Tabs>
          <Tab title="Gradle">
            다음을 `build.gradle.kts`로 저장하세요:

            ```kotlin
            plugins {
                application
            }

            repositories {
                mavenCentral()
            }

            java {
                toolchain {
                    languageVersion = JavaLanguageVersion.of(25)
                }
            }

            dependencies {
                implementation("com.anthropic:anthropic-java:2.73.0")
            }

            application {
                mainClass = "QuickStart"
            }
            ```
          </Tab>

          <Tab title="Maven">
            다음을 `pom.xml`로 저장하세요:

            ```xml
            <project xmlns="http://maven.apache.org/POM/4.0.0">
              <modelVersion>4.0.0</modelVersion>
              <groupId>com.example</groupId>
              <artifactId>quickstart</artifactId>
              <version>1.0-SNAPSHOT</version>
              <properties>
                <maven.compiler.release>25</maven.compiler.release>
                <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
              </properties>
              <dependencies>
                <dependency>
                  <groupId>com.anthropic</groupId>
                  <artifactId>anthropic-java</artifactId>
                  <version>2.73.0</version>
                </dependency>
              </dependencies>
            </project>
            ```
          </Tab>
        </Tabs>
      </Step>

      <Step title="코드 작성하기">
        다음을 프로젝트의 Java 소스 디렉터리(일반적으로 `src/main/java/`)에 `QuickStart.java`로 저장하세요:

        ```java Java
        import com.anthropic.client.okhttp.AnthropicOkHttpClient;
        import com.anthropic.models.messages.Message;
        import com.anthropic.models.messages.MessageCreateParams;
        import com.anthropic.models.messages.Model;

        static void main() {
            var client = AnthropicOkHttpClient.fromEnv();

            var params = MessageCreateParams.builder()
                .model(Model.CLAUDE_OPUS_5_5)
                .maxTokens(1000)
                .addUserMessage(
                    "What should I search for to find the latest developments in renewable energy?"
                )
                .build();

            Message message = client.messages().create(params);
            for (var block : message.content()) {
                block.text().ifPresent(textBlock -> IO.println(textBlock.text()));
            }
        }
        ```
      </Step>

      <Step title="코드 실행하기">
        <Tabs>
          <Tab title="Gradle">
            ```bash
            gradle run
            ```
          </Tab>

          <Tab title="Maven">
            ```bash
            mvn compile exec:java -Dexec.mainClass=QuickStart
            ```
          </Tab>
        </Tabs>

        ```text Output wrap
        Here are some effective search strategies to find the latest developments in renewable energy:

        ## General Search Terms
        - "Renewable energy news 2025"
        - ...
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="PHP">
    <Steps>
      <Step title="API 키 설정하기">
        API 키를 환경 변수로 내보내세요. SDK는 `ANTHROPIC_API_KEY`를 자동으로 읽습니다.

        ```bash
        export ANTHROPIC_API_KEY="your-api-key-here"
        ```
      </Step>

      <Step title="프로젝트 생성 및 SDK 설치하기">
        ```bash
        mkdir claude-quickstart && cd claude-quickstart
        composer require "anthropic-ai/sdk" "guzzlehttp/guzzle:^7"
        ```
      </Step>

      <Step title="코드 작성하기">
        `quickstart.php`라는 파일을 만드세요:

        ```php PHP
        <?php
        require 'vendor/autoload.php';

        use Anthropic\Client;
        use Anthropic\Messages\Model;
        use Anthropic\Messages\TextBlock;

        $client = new Client();

        $message = $client->messages->create(
            model: Model::CLAUDE_OPUS_5_5,
            maxTokens: 1000,
            messages: [
                [
                    'role' => 'user',
                    'content' => 'What should I search for to find the latest developments in renewable energy?',
                ],
            ],
        );

        foreach ($message->content as $block) {
            if ($block instanceof TextBlock) {
                echo $block->text . PHP_EOL;
            }
        }
        ```
      </Step>

      <Step title="코드 실행하기">
        ```bash
        php quickstart.php
        ```

        ```text Output wrap
        Here are some effective search strategies to find the latest developments in renewable energy:

        ## General Search Terms
        - "Renewable energy news 2025"
        - ...
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Ruby">
    <Steps>
      <Step title="API 키 설정하기">
        API 키를 환경 변수로 내보내세요. SDK는 `ANTHROPIC_API_KEY`를 자동으로 읽습니다.

        ```bash
        export ANTHROPIC_API_KEY="your-api-key-here"
        ```
      </Step>

      <Step title="프로젝트 생성 및 SDK 설치하기">
        ```bash
        mkdir claude-quickstart && cd claude-quickstart
        bundle init
        bundle add anthropic
        ```
      </Step>

      <Step title="코드 작성하기">
        `quickstart.rb`라는 파일을 만드세요:

        ```ruby Ruby
        require "anthropic"

        client = Anthropic::Client.new

        message = client.messages.create(
          model: Anthropic::Model::CLAUDE_OPUS_5_5,
          max_tokens: 1000,
          messages: [
            {
              role: "user",
              content: "What should I search for to find the latest developments in renewable energy?"
            }
          ]
        )

        message.content.each do |block|
          puts block.text if block.type == :text
        end
        ```
      </Step>

      <Step title="코드 실행하기">
        ```bash
        bundle exec ruby quickstart.rb
        ```

        ```text Output wrap
        Here are some effective search strategies to find the latest developments in renewable energy:

        ## General Search Terms
        - "Renewable energy news 2025"
        - ...
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 다음 단계

첫 번째 API 호출을 완료했습니다. 다음으로, 모든 Claude 통합에서 사용하게 될 Messages API 패턴을 알아보세요.

<Card title="Messages API 사용하기" icon="messages" href="https://platform.claude.com/docs/ko/build-with-claude/working-with-messages">
  멀티턴 대화, 시스템 프롬프트, 중지 이유 및 기타 핵심 패턴을 알아보세요.
</Card>

기본 사항에 익숙해지면 더 자세히 살펴보세요:

<CardGroup cols={2}>
  <Card title="모델 개요" icon="brain" href="https://platform.claude.com/docs/ko/models/overview">
    기능과 비용별로 Claude 모델을 비교하세요.
  </Card>

  <Card title="기능 개요" icon="list" href="https://platform.claude.com/docs/ko/build-with-claude/overview">
    도구, 컨텍스트 관리, 구조화된 출력 등 모든 Claude 기능을 살펴보세요.
  </Card>

  <Card title="클라이언트 SDK" icon="code-brackets" href="https://platform.claude.com/docs/ko/cli-sdks-libraries/overview">
    Python, TypeScript, C# 및 기타 클라이언트 라이브러리에 대한 참조 문서입니다.
  </Card>

  <Card title="인증" icon="lock" href="https://platform.claude.com/docs/ko/manage-claude/authentication">
    API 키와 Workload Identity Federation을 비교하고 키 만료를 설정하세요.
  </Card>
</CardGroup>