> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux의 Claude Desktop (베타)

> Ubuntu 및 Debian에서 Claude 데스크톱 앱 설치 및 업데이트

<Note>
  Claude 데스크톱 앱의 Linux 지원은 베타 버전입니다. Chat, Cowork 및 Code 탭을 모두 사용할 수 있습니다.
</Note>

Linux의 데스크톱 앱은 macOS 및 Windows와 동일한 Chat, Cowork 및 Claude Code 환경을 제공합니다: 병렬 세션, 시각적 diff 검토, 통합 터미널 및 편집기, 라이브 앱 미리보기. 전체 기능 참조는 [Claude Code Desktop 사용](/ko/desktop)을 참조하세요.

<h2 id="requirements">
  요구 사항
</h2>

* Ubuntu 22.04 이상 또는 Debian 12 이상
* x86\_64 또는 arm64

이러한 요구 사항을 충족하는 다른 Debian 기반 배포판도 작동할 수 있지만 공식적으로 테스트되지 않았습니다.

<h2 id="install">
  설치
</h2>

시스템의 정기적인 패키지 업데이트를 통해 업데이트가 도착하도록 Anthropic의 apt 저장소에서 설치하세요.

<Steps>
  <Step title="Anthropic의 apt 저장소 추가">
    Anthropic의 서명 키를 다운로드합니다:

    ```bash theme={null}
    sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
    ```

    저장소를 등록합니다:

    ```bash theme={null}
    echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
    ```
  </Step>

  <Step title="패키지 설치">
    ```bash theme={null}
    sudo apt update && sudo apt install claude-desktop
    ```
  </Step>

  <Step title="실행 및 로그인">
    애플리케이션 런처에서 **Claude**를 실행하거나 터미널에서 `claude-desktop`을 실행한 후 Anthropic 계정으로 로그인합니다.
  </Step>
</Steps>

<Accordion title="서명 키 확인">
  다운로드한 서명 키가 Anthropic에 속하는지 확인할 수 있습니다:

  ```bash theme={null}
  gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc
  ```

  지문은 `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE`여야 합니다.
</Accordion>

<h3 id="install-from-a-downloaded-file">
  다운로드한 파일에서 설치
</h3>

apt 저장소를 사용할 수 없는 경우 [claude.com/download](https://claude.com/download)에서 아키텍처(x64 또는 arm64)에 맞는 `.deb` 패키지를 다운로드한 후 소프트웨어 설치 프로그램으로 열거나 다운로드 디렉터리에서 실행합니다:

```bash theme={null}
sudo apt install ./claude-desktop_*.deb
```

이런 방식으로 설치된 `.deb`는 업데이트를 받지 않습니다. apt를 통해 업데이트를 받으려면 위에 표시된 대로 저장소를 추가하거나 패키지가 `/etc/apt/sources.list.d/claude-desktop.list`에 작성하는 자리 표시자 항목의 `deb` 줄을 주석 해제합니다.

<h2 id="update">
  업데이트
</h2>

데스크톱 앱은 Linux에서 자동으로 업데이트되지 않습니다. 업데이트는 시스템의 정기적인 패키지 업데이트와 함께 도착합니다:

```bash theme={null}
sudo apt update && sudo apt upgrade
```

배포판의 그래픽 소프트웨어 업데이터도 새 버전을 선택합니다.

<h2 id="uninstall">
  제거
</h2>

```bash theme={null}
sudo apt remove claude-desktop
```

이렇게 하면 앱과 함께 서명 키가 제거되므로 설치 중에 저장소 항목을 추가한 경우 이것도 제거합니다:

```bash theme={null}
sudo rm /etc/apt/sources.list.d/claude-desktop.list
```

<h2 id="what’s-not-in-the-linux-beta-yet">
  Linux 베타에서 아직 제공되지 않는 기능
</h2>

* **Computer Use**: [앱 및 화면 제어](/ko/desktop#let-claude-use-your-computer)는 Linux에서 사용할 수 없습니다.
* **Dictation**: 음성 입력은 Linux 데스크톱 앱에서 사용할 수 없습니다. 대신 CLI에서 [음성 받아쓰기](/ko/voice-dictation)를 사용하세요.
* **Quick Entry 전역 핫키**: X11에서 작동합니다. 기본 Wayland에서는 데스크톱 환경의 GlobalShortcuts 포털이 필요합니다.
* **Fedora 및 RHEL**: 현재 Debian 기반 배포판만 지원됩니다. 추가 배포판에 대한 지원은 향후 제공될 예정입니다.

데스크톱 앱에서 아직 사용할 수 없는 기능의 경우 [CLI](/ko/quickstart)는 동일한 Claude Code 엔진을 실행하며 더 넓은 범위의 Linux 배포판을 지원합니다. [시스템 요구 사항](/ko/setup#system-requirements)을 참조하세요.