Linux에서 Claude 데스크톱 앱 및 CLI 설치 방법
Ubuntu와 Debian에서 Claude 데스크톱 베타 앱을 apt로 설치하는 방법과 Claude Code CLI 사용법을 정리했습니다. Linux 환경에서 지원되지 않는 Computer Use 기능 제한 사항과 각 인터페이스별 요금제 적용 범위를 상세히 안내합니다.
현재 Linux에서 네이티브로 실행되는 Claude 구성 요소
Claude는 현재 4개의 독립적인 인터페이스로 Linux에서 실행되며, 2026년 10월 기준으로 4가지 모두 일반적인 Ubuntu 또는 Debian 환경에서 작동합니다. 데스크톱 앱은 Anthropic의 apt 저장소에서 설치하며 현재 베타 상태입니다. Claude Code CLI(명령줄 인터페이스)는 컴파일된 바이너리 형태이며, 데스크톱 앱보다 더 다양한 배포판에서 실행됩니다. claude.ai 웹 앱은 브라우저만 있으면 되며, API는 사용자의 코드에서 호출하는 HTTPS 엔드포인트입니다.
macOS와 Windows에서 제공되는 세 가지 기능은 Linux 데스크톱 베타 버전에서 누락되었거나 제한적입니다. Claude가 화면의 앱을 제어하는 Computer Use, 음성 받아쓰기, 그리고 Quick Entry 전역 단축키가 이에 해당합니다. Anthropic은 Computer Use와 받아쓰기 기능이 Linux에서 지원되지 않는다고 명시하고 있습니다. Quick Entry 단축키는 X11 세션에서는 작동하지만, 네이티브 Wayland 세션에서는 데스크톱 환경의 GlobalShortcuts 포털이 필요하므로 해당 포털이 없으면 단축키를 사용할 수 없습니다. echo $XDG_SESSION_TYPE는 x11 또는 wayland를 출력하여 현재 어떤 환경에 있는지 알려줍니다. CLI는 자체적인 음성 받아쓰기 기능을 갖추고 있으므로, 받아쓰기 기능의 부재는 Claude 자체가 아닌 데스크톱 앱에 국한된 문제입니다.
지원 여부는 변경될 수 있으므로, 이 페이지를 각 인터페이스에 대한 설명으로 참고하고 계획을 세우기 전에 현재 상태를 확인하십시오. 마지막 섹션에 확인해야 할 페이지 목록이 나열되어 있습니다.
Ubuntu 또는 Debian에 Claude 데스크톱 앱 설치하기
문서화된 요구 사항은 Ubuntu 22.04 이상 또는 Debian 12 이상이며, x86_64(dpkg에서 amd64라고 부름) 또는 arm64 아키텍처를 지원합니다. 다른 Debian 기반 배포판에서도 작동할 수 있으나 테스트되지 않았습니다. Fedora와 RHEL은 아직 패키지를 제공하지 않으므로, 해당 환경에서는 CLI나 브라우저를 사용해야 합니다.
다운로드한 .deb 파일 대신 apt 저장소에서 설치하십시오. Linux용 앱에는 자체 업데이트 기능이 없으므로, 새로운 버전은 패키지 관리자를 통해서만 제공되며 저장소를 등록해야 apt upgrade가 이를 인식할 수 있습니다.
sudo apt install curl gnupg
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc \
https://downloads.claude.ai/claude-desktop/key.asc
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.ascgpg --show-keys은 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE 지문을 출력해야 합니다. 저장소를 등록하기 전에 이를 비교하십시오. 확인하지 않은 서명 키를 사용하는 것은 맹목적으로 신뢰하는 것과 같습니다. gpg가 파일에 유효한 OpenPGP 데이터가 없다고 보고한다면 다운로드에 실패한 것이며, 이후 apt update를 실행하면 NO_PUBKEY BAA929FF1A7ECACE 오류가 발생합니다.
저장소 등록은 /etc/apt/sources.list.d/claude-desktop.list에 한 줄의 deb 명령을 작성하는 과정입니다. Anthropic의 Linux 설치 페이지인 code.claude.com/docs/en/desktop-linux에서 해당 줄을 그대로 복사하십시오. 저장소 주소는 이 절차에서 가장 자주 변경될 가능성이 높은 부분이므로, 기억에 의존해 입력하면 나중에 E: Unable to locate package claude-desktop 오류를 마주하게 됩니다. 붙여넣기 전에 해당 줄을 읽어보십시오. arch=amd64,arm64은 다른 아키텍처에서 apt가 아무것도 찾지 못하는 이유이며, signed-by=은 방금 확인한 키링 파일을 가리킵니다. 이는 해당 키를 다른 모든 apt 작업에 신뢰하는 대신 이 저장소에만 국한되도록 제한합니다.
sudo apt update && sudo apt install claude-desktop애플리케이션 실행기에서 시작하거나 터미널에서 claude-desktop를 실행하십시오. claude.ai 계정으로 로그인하거나, 회사에서 설정한 경우 조직의 SSO(Single Sign-On)를 통해 로그인하십시오. Anthropic의 Linux 설치 페이지에는 이 두 가지 로그인 방식이 명시되어 있으며, API 키 사용자는 CLI로 안내합니다. Anthropic은 동일한 앱에 대해 두 번째 배포 모드를 별도로 문서화하고 있습니다. 추론 제공자(Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry, LLM 게이트웨이 또는 Anthropic API 직접 연결)로 구성하면 로그인 화면에서 Anthropic 인증을 건너뛸 수 있으며, 제공자가 Chat, Cowork 및 Code에 대한 추론과 과금을 처리합니다. 해당 문서에는 관리형 구성을 위한 Linux 경로인 /etc/claude-desktop/managed-settings.json이 명시되어 있으며, Linux 설치 페이지는 현재 타사 배포 문서로 연결됩니다. Claude Desktop 구성이 없는 기기에서 Claude Desktop 3.1623.1 이상 버전은 표준 로그인 화면에서 'Use your Claude API account' 옵션을 제공하며, 여기서 Claude Console로 로그인하거나 사전 구성 없이 API 키를 입력할 수 있습니다. Claude Desktop 4.23118.0 이상 버전에서는 조직이 다른 계정을 차단하는 컴퓨터 로그인 환경인 경우, 기기 관리가 없더라도 해당 링크가 숨겨집니다.
사용자의 컴퓨터에서 실행되는 Cowork 작업은 가상 머신을 사용하므로 하드웨어 가상화가 활성화되어 있어야 하며, 사용자가 kvm 그룹에 포함되어야 합니다(sudo usermod -aG kvm $USER 실행 후 로그아웃했다가 다시 로그인). 모든 Cowork 작업이 로컬에서 실행되는 것은 아닙니다. 2026년 10월 6일부터 Pro, Max 및 Ultra 플랜의 새로운 Cowork 작업은 Anthropic 클라우드에서 실행되며, 이를 컴퓨터에 유지하는 설정은 없습니다. 통합 Chat 및 Cowork 환경이 활성화된 Team 및 Enterprise 조직도 클라우드에서 작업을 실행합니다. 해당 플랜에서 가상 머신은 이미 컴퓨터에서 시작된 작업에만 중요하며, Anthropic은 로컬에 유지해야 하는 새로운 작업은 데스크톱 앱 내의 Claude Code를 사용하도록 안내합니다.
E: Unable to locate package claude-desktop은 apt가 저장소를 읽지 못했음을 의미합니다. cat /etc/apt/sources.list.d/claude-desktop.list에는 작성한 deb 줄이 표시되어야 하며, dpkg --print-architecture은 amd64 또는 arm64을 출력해야 합니다. 다른 아키텍처용 패키지는 게시되지 않기 때문입니다. 이후 업데이트는 sudo apt update && sudo apt upgrade를 통해 시스템의 다른 패키지와 함께 전달됩니다.
브라우저에서만 사용할 수 있는 기능
claude.ai는 모든 배포판의 최신 브라우저에서 동작하므로 Fedora, RHEL, Arch, openSUSE 등 패키지가 제공되지 않는 환경에서도 사용할 수 있다. 브라우저에서는 Claude Code on the web도 사용할 수 있다. 이 기능의 세션은 사용자 컴퓨터가 아니라 클라우드 인프라에서 실행된다. 기본적으로 Anthropic의 인프라를 사용하며, 조직에서 세션을 자체 호스팅 환경으로 라우팅하면 해당 환경을 사용한다. 항상 사용자의 구독 인증 정보를 사용한다.
브라우저의 한계를 이해하는 것이 중요하다. 브라우저만으로는 사용자의 서버에 있는 파일을 읽거나 해당 서버에서 명령을 실행할 수 없다. 사용자 컴퓨터에 접근하는 작업에는 해당 컴퓨터에 소프트웨어가 필요하다. 즉 CLI, 데스크톱 앱 또는 구성된 self-hosted runner가 필요하다. 데스크톱 앱이 열려 있으면 Cowork 클라우드 세션에서 연결된 로컬 폴더에 접근할 수 있다.
웹 애플리케이션이 제공하지 않는 CLI만의 기능
디렉터리에서 claude를 실행하면 해당 디렉터리를 대상으로 작업이 수행됩니다. 이것이 핵심 차이점이며, 나머지 모든 기능은 여기에서 비롯됩니다.
- 작업 디렉터리의 파일을 읽고 수정하며, 수동 모드(Manual mode)에서는 수정 사항을 적용하기 전에 사용자에게 확인을 요청합니다. 자동 모드(Auto mode)는 백그라운드에서 안전성 검사를 거쳐 수정 사항을 적용하며, 설정이나 정책이 변경되지 않는 한 현재 대화형 세션의 기본값으로 내장되어 있습니다. 직접 작업을 검토하려면
claude --permission-mode default을 사용하여 시작하십시오. - 세션의 권한 모드 내에서 셸 명령을 실행하므로, 프로젝트 빌드, 테스트 스위트 실행, 로그 읽기, 서버 내 서비스 점검 등을 수행할 수 있습니다.
- 대화형 세션 없이도 실행됩니다.
claude -p "read the nginx error log and summarise it"는 하나의 답변을 출력하고 종료되는데, 이는 cron 작업이나 파이프라인에서 사용하는 방식입니다. Claude Code 2.1.302 버전 이상에서는 권한 모드가 설정되지 않은 경우 수동 모드로 시작되며, 승인이 필요한 작업은 승인 메커니즘을 제공하지 않으면 거부됩니다.--permission-mode auto를 전달하여 분류기가 해당 작업을 검토하도록 하십시오. 답변의 형식은 사용자가 설정할 수 있습니다. 출력 스타일은 모든 응답의 기반이 되는 시스템 프롬프트를 수정하므로, 대화형 세션은 상세하게 설명하게 하고 스크립트 실행은 간결하게 유지할 수 있습니다. claude mcp add를 사용하여 MCP(model context protocol) 서버를 연결하면 모델이 파일 시스템을 넘어선 도구를 사용할 수 있게 됩니다. 반복되는 작업 절차는 에이전트 스킬로 묶어 둘 수 있는데, CLI는 개인 또는 프로젝트 디렉터리에서 스킬을 읽고 데스크톱 앱은 ZIP 업로드로 받으므로 파일을 둘 위치와 로드 여부를 확인하는 방법은 Claude Code와 데스크톱 앱의 에이전트 스킬 설치 방법에서 확인하십시오.- 그래픽 데스크톱 환경이 전혀 없는 곳에서도 실행되는데, 이는 귀하가 대여하는 모든 VPS(virtual private server)에 해당합니다.
마지막 항목이 서버 가이드에서 CLI를 중요하게 다루는 이유입니다. 대여한 서버에는 SSH(secure shell) 외에는 아무것도 없으므로, 터미널만이 유일한 작업 환경입니다. 이 방식으로 실행할 때는 고유한 규칙이 따르며, VPS에서 tmux 내부의 Claude Code 실행에서 이를 상세히 다루고, 일상적인 시스템 관리 작업에 Claude 활용하기에서 Claude에게 맡길 만한 작업들을 설명합니다.
에디터 통합 기능은 이 두 가지의 중간 형태입니다. VS Code 확장 프로그램은 VS Code 1.94.0 이상이 필요하며, 에디터 내부에 diff와 계획 검토 기능을 갖춘 그래픽 패널을 제공합니다. 이 확장 프로그램은 해당 패널을 위한 CLI의 비공개 복사본을 포함하고 있으며, claude를 PATH에 추가하지 않습니다. 따라서 통합 터미널에서 claude를 입력하려면 별도의 독립형 설치가 여전히 필요합니다. VS Code 기반의 에디터들은 Open VSX 레지스트리에서 동일한 확장 프로그램을 설치하며, JetBrains 플러그인도 제공됩니다.
Linux에서 Claude Code를 실행하려면 Node.js가 필요한가요?
권장 설치 방식을 사용하면 필요하지 않습니다. 네이티브 설치 프로그램은 컴파일된 바이너리를 다운로드하며, 해당 바이너리는 Node.js 위에서 실행되지 않습니다.
curl -fsSL https://claude.ai/install.sh | bash
claude --versionclaude --version를 실행하면 2.1.211 (Claude Code)과 같은 버전 번호가 출력되어야 합니다. 문제가 있다면 claude doctor을 실행하십시오. 이 명령은 세션을 시작하지 않고 설치 상태와 설정 파일에 대한 읽기 전용 진단 정보를 출력합니다.
Node.js는 npm 경로를 사용할 때만 중요합니다. 2026년 10월 기준으로 npm 패키지는 Node.js 22 이상을 요구합니다. 이전 버전의 Node.js에서 npm은 실패 대신 EBADENGINE 경고를 출력하는데, 이는 패키지가 플랫폼별 의존성으로 동일한 네이티브 바이너리를 가져와 연결하기 때문입니다.
npm install -g @anthropic-ai/claude-codenpm 12에서는 postinstall 단계가 기본적으로 건너뛰어지므로 claude을 실행할 수 없습니다. npm --version가 12로 시작된다면, 위의 네이티브 설치 프로그램을 사용하거나 재설치하기 전에 사용자 npm 설정의 allow-scripts에 Claude Code를 추가하십시오.
sudo을 사용하여 실행하지 마십시오. 문서는 sudo npm install -g 사용을 경고합니다. 이 명령은 전역 npm 접두사 경로에 root 소유의 파일을 남기게 되어, 이후 권한이 없는 사용자가 설치하거나 업데이트할 때 권한 오류가 발생하기 때문입니다. npm 전역 디렉터리에 쓰기가 불가능하면 백그라운드 자동 업데이트가 작동하지 않으며, claude doctor에 해결 방법이 나열되어 있습니다.
Anthropic은 Debian, Fedora, RHEL, Alpine용 서명된 패키지 저장소도 제공합니다. 따라서 sudo apt install claude-code은 데스크톱 패키지와 유사하게 작동하며, https://downloads.claude.ai/keys/claude-code.asc에 자체 서명 키를 포함합니다.
사용자별 설치와 시스템 전체 설치 중 무엇을 선택해야 합니까?
기본 설치 프로그램은 사용자별 설치를 수행합니다. 이 방식은 ~/.local/bin/claude에 런처를 배치하고 ~/.local/share/claude/versions/에 심볼릭 링크를 생성하며, root 권한이 필요 없고 백그라운드에서 스스로 업데이트됩니다. 시스템의 각 사용자는 별도의 버전으로 복사본을 각각 가집니다.
패키지 관리자를 통한 설치는 시스템 전체에 적용됩니다. 하나의 바이너리가 모든 사용자에게 서비스를 제공하며, root 권한이 필요하고 Claude Code를 통한 자동 업데이트는 지원하지 않습니다. 이 경우 시스템의 다른 모든 소프트웨어를 업데이트할 때 사용하는 것과 동일한 sudo apt update && sudo apt upgrade claude-code 명령어로 업그레이드합니다.
본인 계정으로 로그인하는 머신(대부분의 VPS 작업이 해당함)에서는 사용자별 설치를 선택하십시오. 공유 서버나 머신 이미지처럼 모든 사용자에게 동일한 버전을 제공하고 사용자가 직접 업데이트 일정을 관리해야 하는 경우에는 패키지 설치를 선택하십시오. 기본 설치 시 ~/.claude/settings.json의 다음 두 설정이 업데이트 동작을 결정합니다.
{
"autoUpdatesChannel": "stable",
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}stable 채널은 출시된 지 약 1주일 정도 지난 버전을 따르며, 주요 회귀(regression)가 포함된 릴리스는 건너뜁니다. DISABLE_AUTOUPDATER는 백그라운드 확인만 중단하므로 claude update은 여전히 작동하며, 사용자는 새 버전이 적용되는 시점을 계속 제어할 수 있습니다. 이는 장시간 실행되는 작업이 무인으로 진행되는 서버에서 바이너리가 임의로 변경되지 않도록 해야 할 때 중요합니다.
SSH로 로그인하고 세션 유지하기
임대 서버에서 CLI를 처음 실행할 때 리눅스 환경에서 두 가지 문제가 발생합니다. 로그인 과정은 브라우저를 요구하지만 서버에는 브라우저가 없습니다. SSH 연결이 끊기면 실행 중이던 작업도 함께 종료됩니다.
tmux는 두 번째 문제를 해결합니다. tmux 세션은 연결이 아닌 원격 머신의 tmux 서버에 귀속되므로, 연결이 끊겨도 프로세스는 계속 실행됩니다.
tmux new -s claude
claudeCtrl-b를 누른 뒤 d를 눌러 세션에서 분리(detach)하고, 나중에 tmux attach -t claude로 다시 접속합니다.
로그인은 첫 번째 문제입니다. claude을 실행하고 터미널의 붙여넣기 프롬프트 위에 표시된 인증 URL을 복사합니다. 이 URL을 로컬 컴퓨터의 브라우저에서 엽니다. 해당 URL을 통해 로그인하면 브라우저는 localhost로 돌아가는 대신 로그인 코드를 표시합니다. 이 코드를 터미널의 Paste code here if prompted 프롬프트에 붙여넣으면 터미널에 Login successful 메시지가 출력됩니다.
아무도 지켜보지 않는 상태에서 세션을 시작해야 한다면, claude setup-token를 사용하여 동일한 브라우저 인증을 거친 뒤 1년 유효 기간의 OAuth 토큰을 터미널에 출력할 수 있습니다. 이 토큰은 어디에도 저장되지 않으므로 복사하여 필요한 곳에 설정하십시오.
export CLAUDE_CODE_OAUTH_TOKEN=your-token해당 토큰은 유료 플랜이 필요하며 모델 요청만 수행할 수 있습니다. 1년의 수명을 가진 비밀번호처럼 취급하십시오. 토큰을 어디에 보관할지, 그리고 에이전트가 이를 읽어내지 못하게 하려면 어떻게 해야 할지는 AI 에이전트가 비밀 정보에 접근하지 못하도록 관리하기에서 다룹니다.
소규모 서버는 한 가지 장벽을 더 만납니다. 설치에는 약 512 MB의 여유 메모리가 필요하며, 공식적인 하드웨어 요구 사항은 4 GB 이상의 RAM입니다. 따라서 여유 메모리가 적은 1 GB 인스턴스에서는 커널의 out-of-memory killer가 설치 프로세스를 종료시킬 수 있으며, 이때 설치 프로그램은 다음과 같이 보고합니다.
Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.스왑(swap)을 추가한 뒤 설치 프로그램을 다시 실행하십시오. 스왑은 커널이 메모리 부족 시 사용하는 디스크 공간입니다. RAM보다 훨씬 느리지만 설치를 완료하기에는 충분합니다.
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfileswapon는 이번 부팅 동안만 해당 파일을 활성화합니다. 재부팅 후에도 유지하려면 /swapfile에 대한 줄을 /etc/fstab에 추가하십시오. 에이전트가 운영 서버에서 명령을 실행하기 전에 무엇을 추가로 제한해야 하는지는 VPS에서 안전하게 Claude Code 실행하기에서 다룹니다.
Linux에서 Claude 자격 증명이 저장되는 위치
Linux에서 /login은(는) 자격 증명을 0600 파일 모드로 ~/.claude/.credentials.json에 기록합니다. macOS는 일반적으로 동일한 자격 증명을 암호화된 Keychain에 저장하지만, Keychain에서 쓰기를 거부하면 동일한 일반 파일로 대체합니다. Linux에서 이 토큰은 홈 디렉터리의 일반 파일로 존재하며, 해당 사용자로 실행 중인 모든 프로세스가 이를 읽을 수 있습니다. CLAUDE_CONFIG_DIR을(를) 설정하면 파일이 해당 디렉터리 아래로 이동합니다.
이로 인해 두 가지 결과가 발생합니다. /home의 백업에는 활성 로그인 정보가 포함되어 있으므로, 해당 백업을 공유 머신에 복사하면 파일을 읽을 수 있는 누구에게나 계정 권한이 넘어갑니다. 또한 로그인한 상태의 머신에서 생성한 머신 이미지는 해당 이미지에서 복제된 모든 인스턴스에 로그인 정보를 포함하게 됩니다. 스냅샷을 생성하기 전에 /logout을(를) 실행하십시오.
자격 증명 우선순위는 구독과 API 키를 동시에 보유한 사용자에게 영향을 미칩니다. 셸에 ANTHROPIC_API_KEY이(가) 설정되어 있으면, 사용자가 승인하는 즉시 Claude Code가 이를 사용하므로 구독은 사용되지 않고 키가 토큰당 비용을 청구하게 됩니다. /status은(는) 어떤 자격 증명이 활성화되어 있는지 보여주며, unset ANTHROPIC_API_KEY은(는) 구독 로그인 상태로 되돌려 줍니다.
로그인은 만료됩니다. 만료 3일 전부터 시작 라인에 Your login expires in 3 days이(가) 표시되며, 이 경고는 요청을 차단하지 않습니다. 만료 후 로그인을 갱신할 수 없으면 모든 모델 요청이 Login expired · Please run /login 오류와 함께 실패합니다. 무인 세션을 주말 동안 실행 상태로 두기 전에 이 점을 유의하십시오. 세션이 진행을 멈추면 스스로 복구할 수 없기 때문입니다.
Claude 구독 하나로 모든 서비스를 이용할 수 있습니까?
하나의 유료 플랜으로 동일한 계정을 사용하는 모든 환경을 이용할 수 있으며, 일부 Enterprise 플랜은 예외입니다. Pro, Max, Ultra 또는 Team 계정으로 브라우저의 claude.ai, 데스크톱 앱, CLI, VS Code 확장 프로그램에 로그인하면 모두 동일한 구독이 적용됩니다. HIPAA 대응 조직 외부의 신규 또는 셀프 서비스 플랜을 사용하는 Enterprise 계정도 마찬가지이며, 단일 Enterprise 좌석에 Claude Code가 포함됩니다. 반면 구형 Enterprise 플랜은 좌석 유형이 분리되어 있습니다. 해당 플랜에서는 Claude Code를 사용하려면 Chat + Claude Code 좌석이나 구형 좌석 기반 플랜의 Premium 좌석이 필요하며, Chat-only 또는 Standard 좌석에는 포함되지 않습니다. HIPAA 대응 Enterprise 조직 역시 Chat 좌석과 Chat + Claude Code 좌석 유형을 별도로 운영합니다. HIPAA 대응 Enterprise 플랜에서 Claude Code를 사용하려면 Chat + Claude Code 좌석이 필요하며, 터미널과 Claude Desktop의 Code 탭에 대한 BAA 적용을 위해서는 HIPAA 구성 또는 이에 준하는 데이터 보존 제로 정책이 필요합니다. VS Code 및 JetBrains 확장 프로그램과 클라우드 세션은 HIPAA 구성의 적용 대상이 아닙니다. Pro, Max, Ultra, Team 및 좌석 기반 Enterprise 플랜에서는 모든 환경에서 사용량을 공유합니다. 따라서 서버에서 CLI를 장시간 실행하면 데스크톱 앱에서 사용할 수 있는 잔여 사용량이 줄어들며, 서비스 이용이 제한될 경우 현재 도달한 제한 범위와 대응 방법을 확인해야 합니다. 사용량 기반 Enterprise 플랜은 별도의 포함된 사용량이 없으며, 모든 환경에서 첫 번째 토큰부터 API 요율로 과금됩니다. 무료 claude.ai 플랜에는 Claude Code 접근 권한이 포함되어 있지 않습니다. 유료 플랜이 없는 경우, CLI는 Claude Console 계정으로 로그인하거나 조직에서 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry를 사용하는 경우 브라우저 로그인 없이 해당 공급자를 통해 인증할 수 있습니다. claude.ai 구독이나 SSO 로그인을 사용하는 경우, 데스크톱 앱의 Claude Code 기능을 이용하려면 유료 플랜이 필요합니다. 위에서 설명한 별도로 구성된 타사 모드와 관리되지 않는 기기에서 제공되는 Claude API 계정 옵션을 사용하면 데스크톱 앱에서 Console 또는 공급자 과금 방식을 이용할 수 있습니다.
API는 별도의 과금 체계를 가진 다른 제품입니다. Console 계정은 실제 전송한 토큰 단위로 과금되며, 이는 터미널에서 직접 입력하는 방식보다 서비스를 구축하는 경우에 적합합니다. ANTHROPIC_API_KEY를 설정하면 CLI의 과금 방식이 해당 경로로 전환되며, 이는 기본값이 아닌 사용자가 직접 선택하는 방식입니다. 표준 모드에서 데스크톱 앱은 OAuth로 로그인하며, 타사 모드에서는 자체 구성에 저장된 자격 증명을 사용합니다.
가격과 플랜 제한은 수시로 변경되므로 이곳에 명시하지 않습니다. 현재 수치는 다음 두 페이지에서 확인할 수 있습니다. Claude Code의 실제 비용 및 필요한 Claude 플랜 확인. 토큰 기반 과금과 월간 플랜 중 고민 중이라면 API와 구독 플랜 비교를 통해 손익 분기점을 파악할 수 있습니다.
실제로 마주하게 될 설치 오류
bash: claude: command not found 설치 직후. 바이너리는 ~/.local/bin/claude에 위치하며 해당 디렉터리가 셸의 검색 경로에 포함되어 있지 않은 경우입니다. echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin" 명령으로 확인하십시오. 항목이 누락된 경우 아무것도 출력되지 않습니다. bash를 사용 중이라면 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc 명령으로 해결한 뒤 source ~/.bashrc을 실행하십시오. VS Code 확장을 단독으로 설치한다고 해서 해당 파일이 생성되지는 않습니다. 확장은 자체적인 CLI 복사본을 확장 디렉터리 내부에 보관하기 때문입니다.
Error loading shared library libstdc++.so.6. 설치 프로그램이 잘못된 바이너리 변형을 다운로드했거나(보통 glibc 시스템에서 musl 빌드를 받은 경우), 혹은 런타임 라이브러리가 부족한 musl 시스템을 사용 중인 경우입니다. 잘못된 변형이 설치되는 것은 musl 교차 컴파일 패키지가 존재하여 감지 과정에서 오인할 때 발생합니다. ldd --version 2>&1 | head -1를 실행하십시오. 출력 결과에 GNU libc 또는 GLIBC가 포함되어 있다면 glibc 시스템에서 잘못된 바이너리를 받은 것이므로, 설치를 제거하고 설치 프로그램을 다시 실행하십시오. Alpine이나 기타 musl 시스템에서는 반대로 apk add libgcc libstdc++ ripgrep를 실행하여 해결합니다.
한 시스템에 claude이 두 개 존재하는 경우. which -a claude은 PATH 내의 모든 일치 항목을 나열합니다. 네이티브 설치는 ~/.local/bin/claude에서 ~/.local/share/claude/versions/로 연결된 심볼릭 링크이며, 레거시 로컬 npm 설치는 ~/.claude/local/ 아래에 위치하고, npm -g ls @anthropic-ai/claude-code은 전역 npm 설치 위치를 보여줍니다. 원치 않는 항목은 제거하십시오. PATH 앞쪽에 있는 구버전 복사본 때문에 수정된 버그가 여전히 남아 있는 것처럼 보일 수 있습니다.
현재 상태 확인 위치
- Linux 데스크톱 상태, 요구 사항 및 설치 명령어: code.claude.com/docs/en/desktop-linux
- 지원되는 배포판 및 CLI 설치 방법 전체: code.claude.com/docs/en/setup
- 앱을 다운로드할 수 있는 플랫폼 확인: claude.com/download
- 요금제별 포함 사항 및 비용 확인: claude.com/pricing
Claude API 계정 로그인 정책, 무인 권한 기본값, SSH 로그인 흐름 및 자격 증명 저장 방식은 2026년 11월 7일에 확인되었습니다. 이 가이드에 포함된 다른 버전 번호와 날짜는 2026년 10월 기준의 스냅샷입니다. 전체적인 구조는 다음과 같이 유지됩니다. 4개의 인터페이스, 유료 플랜 간 통합 로그인, 그리고 CLI를 사용자 계정에 설치할지 시스템 전체에 설치할지에 대한 결정이 필요합니다.
FAQ
Linux용 Claude 데스크톱 앱이 있습니까?
네. 2026년 10월 기준으로 베타 버전이며, amd64 또는 arm64 아키텍처의 Ubuntu 22.04 이상 및 Debian 12 이상을 지원합니다. Anthropic의 apt 저장소와 서명 키를 추가한 뒤 sudo apt install claude-desktop 명령으로 설치하십시오. 이렇게 하면 일반적인 시스템 업그레이드 시 새 버전이 함께 설치됩니다. Linux 빌드는 Claude Code 탭을 포함하여 macOS 앱과 동일한 탭을 제공합니다. Computer Use와 음성 받아쓰기 기능은 아직 Linux 빌드에 포함되지 않았으며, Quick Entry 전역 단축키는 X11에서는 작동하지만 기본 Wayland 세션에서는 데스크톱 환경의 GlobalShortcuts 포털이 필요합니다. Fedora와 RHEL용 패키지는 없으므로, 해당 배포판에서는 CLI를 사용하거나 브라우저에서 claude.ai에 접속하십시오.
Linux에서 Claude Code를 실행하려면 Node.js가 필요합니까?
권장 설치 방식에서는 필요하지 않습니다. curl -fsSL https://claude.ai/install.sh | bash 명령은 런타임에 Node.js를 사용하지 않는 컴파일된 바이너리를 다운로드합니다. Node.js는 npm 패키지로 설치할 때만 중요하며, 2026년 10월 기준으로 Node.js 22 이상이 필요합니다. 이전 버전의 Node.js에서 npm을 실행하면 EBADENGINE 경고가 출력되지만, 플랫폼별 종속성으로 동일한 네이티브 바이너리를 가져오므로 설치는 완료됩니다. sudo npm install -g 명령으로 설치하지 마십시오. npm 접두사 경로에 root 소유의 파일이 남게 되어 이후 업데이트가 실패합니다.
SSH를 통해 Claude Code에 로그인하려면 어떻게 해야 합니까?
claude 명령을 실행하고 터미널의 붙여넣기 프롬프트 위에 표시된 별도의 인증 URL을 복사하십시오. 해당 URL을 서버가 아닌 사용자의 로컬 컴퓨터 브라우저에서 여십시오. URL을 통해 로그인하면 브라우저가 localhost로 돌아가는 대신 로그인 코드를 표시합니다. 해당 코드를 Paste code here if prompted 프롬프트에 붙여넣으십시오. 사용자가 직접 조작할 수 없는 세션의 경우 claude setup-token을 실행하고 출력된 토큰을 필요한 곳에 CLAUDE_CODE_OAUTH_TOKEN로 설정하십시오.
Linux에서 Claude Code는 로그인 정보를 어디에 저장합니까?
~/.claude/.credentials.json 경로에 파일 모드 0600으로 저장하거나, 해당 변수를 설정한 경우 CLAUDE_CONFIG_DIR 아래에 저장합니다. Linux에서는 키체인을 사용하지 않습니다. macOS는 일반적으로 암호화된 키체인을 사용하지만, 키체인 쓰기가 거부되면 동일한 일반 파일로 대체합니다. 사용자의 권한으로 실행되는 모든 프로세스는 이 Linux 자격 증명 파일을 읽을 수 있습니다. 따라서 /home 백업이나 머신 이미지는 활성 로그인 정보를 포함하게 됩니다. 시스템을 스냅샷으로 찍거나 복사하기 전에 /logout을 실행하십시오. 환경 변수에 ANTHROPIC_API_KEY가 설정되어 있다면, 승인 후 저장된 구독 로그인보다 우선 적용되며 /status 명령으로 현재 활성화된 계정을 확인할 수 있습니다.
Claude Pro 구독으로 웹 앱뿐만 아니라 CLI도 이용할 수 있습니까?
네. Pro, Max, Ultra 또는 Team 플랜은 하나의 계정으로 claude.ai, 데스크톱 앱, CLI, VS Code 확장에 로그인할 수 있습니다. Enterprise 플랜도 마찬가지이나, 구형 플랜이나 HIPAA 대응 Enterprise 플랜은 Chat + Claude Code 좌석과 같이 해당 권한이 포함된 좌석에서만 Claude Code를 사용할 수 있습니다. HIPAA 대응 조직은 별도의 Chat 및 Chat + Claude Code 좌석 유형을 사용하며, Chat + Claude Code 좌석만 Claude Code를 포함합니다. 무료 claude.ai 플랜은 Claude Code를 포함하지 않으므로, 터미널 CLI를 사용하려면 유료 플랜, Claude Console 계정 또는 조직에서 사용하는 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry와 같은 클라우드 공급자가 필요합니다. 데스크톱 앱은 구독 또는 SSO 로그인과 구성된 타사 추론 서비스를 지원합니다. Claude Desktop 설정이 없는 장치에서 버전 3.1623.1 이상은 사전 구성 없이 Console 로그인이나 API 키를 허용하는 Claude API 계정 옵션도 제공합니다. 버전 4.23118.0 이상에서는 장치 관리가 없더라도 조직이 다른 계정을 차단하는 컴퓨터 로그인 환경에서 해당 링크가 숨겨집니다. API는 구독과는 다른 제품인 Console 계정을 통해 토큰별로 별도 청구됩니다.