가이드

작성자 Matt Connor 2026-08-07 · 업데이트됨 2026-08-26

Linux에서 Claude 데스크톱 앱 및 CLI 설치 방법

Q: Linux에서 Claude Code를 실행하려면 Node.js가 필요합니까?

권장 설치 방식에서는 필요하지 않습니다. curl -fsSL https://claude.ai/install.sh | bash 명령은 런타임에 Node.js를 사용하지 않는 컴파일된 바이너리를 다운로드합니다. Node.js는 npm 패키지로 설치할 때만 중요하며, 버전 2.1.198 기준으로 Node.js 22 이상을 요구합니다. 이전 버전의 Node.js에서 npm을 실행하면 EBADENGINE 경고가 출력되지만, 플랫폼별 종속성으로 동일한 네이티브 바이너리를 가져오므로 설치는 완료됩니다. sudo npm install -g 명령으로 설치하지 마십시오. 이 방식은 npm 접두사 경로에 root 소유 파일을 남겨 추후 업데이트를 방해합니다.

Q: SSH를 통해 Claude Code에 로그인하려면 어떻게 해야 합니까?

claude 명령을 실행하면 인증 URL이 출력됩니다. 서버가 아닌 본인의 컴퓨터 브라우저에서 해당 URL을 여십시오. 로그인 후 브라우저는 리다이렉트 대신 로그인 코드를 표시합니다. 이는 원격 머신의 루프백 주소에서 Claude Code가 시작한 콜백 리스너에 브라우저가 접근할 수 없기 때문입니다. 해당 코드를 Paste code here if prompted 프롬프트에 붙여넣으십시오. 사용자가 직접 조작할 수 없는 세션의 경우 claude setup-token를 실행하고 출력된 토큰을 필요한 곳에 CLAUDE_CODE_OAUTH_TOKEN으로 설정하십시오.

Q: Linux에서 Claude Code는 로그인 정보를 어디에 저장합니까?

~/.claude/.credentials.json 경로에 파일 모드 0600로 저장되거나, 해당 환경 변수를 설정한 경우 CLAUDE_CONFIG_DIR 아래에 저장됩니다. macOS와 달리 Linux에서는 키체인을 사용하지 않으므로, 동일한 사용자로 실행 중인 모든 프로세스가 해당 파일을 읽을 수 있습니다. 따라서 /home 백업이나 머신 이미지를 생성하면 로그인 정보도 함께 포함됩니다. 시스템 스냅샷을 찍거나 복사하기 전에 /logout을 실행하십시오. 환경 변수에 ANTHROPIC_API_KEY가 설정되어 있다면, 승인 후 저장된 구독 로그인 정보보다 우선 적용되며 /status 명령으로 현재 활성화된 정보를 확인할 수 있습니다.

Ubuntu와 Debian에서 Claude 데스크톱 베타 앱을 apt로 설치하는 방법과 Claude Code CLI 사용법을 정리했습니다. Linux 환경에서 지원되지 않는 Computer Use 기능 제한 사항과 각 인터페이스별 요금제 적용 범위를 상세히 안내합니다.

현재 Linux에서 기본적으로 실행되는 Claude 구성 요소

Claude는 현재 4개의 개별 인터페이스를 통해 Linux에서 실행되며, 2026년 8월 기준으로 4가지 모두 일반적인 Ubuntu 또는 Debian 시스템에서 작동합니다. 데스크톱 앱은 Anthropic의 apt 저장소를 통해 설치하며 현재 베타 버전입니다. Claude Code CLI(명령줄 인터페이스)는 컴파일된 바이너리 형태이며, 데스크톱 앱보다 더 다양한 배포판에서 실행됩니다. claude.ai 웹 앱은 브라우저만 있으면 되며, API는 사용자의 코드에서 호출하는 HTTPS 엔드포인트입니다.

macOS와 Windows에서 제공되는 두 가지 기능이 Linux 데스크톱 베타 버전에는 포함되어 있지 않습니다. Claude가 화면의 앱을 제어하는 Computer Use 기능과 음성 받아쓰기 기능입니다. Anthropic은 이 두 기능이 아직 Linux에서 지원되지 않는다고 명시하고 있습니다. 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.asc

gpg --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)를 통해 로그인하십시오. 데스크톱 앱은 Claude Console API 키를 허용하지 않습니다. 키 기반 인증은 CLI 전용 기능입니다.

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를 사용할 수 있는데, 이 경우 세션은 사용자의 로컬 머신이 아닌 Anthropic 클라우드에서 실행되며 항상 사용자의 구독 자격 증명을 사용합니다.

브라우저의 한계를 이해하는 것이 중요합니다. 클라우드 세션은 사용자의 서버에 있는 파일을 읽거나 서버에서 명령어를 실행할 수 없습니다. 사용자의 머신에 접근해야 하는 모든 작업에는 해당 머신에 설치된 소프트웨어가 필요하며, 이는 곧 CLI나 데스크톱 앱을 사용해야 함을 의미합니다.

웹 애플리케이션이 제공하지 않는 CLI만의 장점

디렉터리에서 claude을 실행하면 해당 디렉터리를 대상으로 작업이 수행됩니다. 이것이 핵심적인 차이이며, 나머지 모든 기능은 여기에서 비롯됩니다.

작업 디렉터리의 파일을 읽고 수정하며, 수정 사항을 적용하기 전에 사용자에게 먼저 보여줍니다.
사용자가 승인한 셸 명령을 실행하므로 프로젝트 빌드, 테스트 스위트 실행, 로그 읽기, 서버 내부 서비스 점검 등을 수행할 수 있습니다.
대화형 세션 없이도 실행됩니다. claude -p "read the nginx error log and summarise it"은 하나의 답변을 출력하고 종료되므로 cron 작업이나 파이프라인에서 사용하기 적합합니다. 답변의 형식은 사용자가 설정할 수 있습니다. 출력 스타일은 모든 응답의 기반이 되는 시스템 프롬프트를 수정할 수 있어, 스크립트 실행 시에는 간결하게 유지하고 대화형 세션에서는 상세한 설명을 제공하도록 조정할 수 있습니다.
claude mcp add를 통해 MCP(Model Context Protocol) 서버를 연결하여 모델이 파일 시스템을 넘어선 도구를 사용할 수 있게 합니다.
그래픽 데스크톱 환경이 전혀 없는 환경에서도 실행됩니다. 이는 대여하는 모든 VPS(가상 사설 서버)에 해당합니다.

마지막 항목이 서버 가이드에서 CLI를 중요하게 다루는 이유입니다. 대여한 서버에는 SSH(Secure Shell) 외에는 아무것도 없으므로, 터미널이 유일한 작업 환경입니다. 이러한 방식으로 실행할 때는 고유한 규칙이 따르며, VPS에서 tmux 내부의 Claude Code 실행하기에서 전체 내용을 다루고, 일상적인 시스템 관리 업무에 Claude 활용하기에서 위임할 만한 작업들을 설명합니다.

에디터 통합 기능은 이 두 방식의 중간에 위치합니다. VS Code 확장은 VS Code 1.94.0 이상이 필요하며, 에디터 내부에 그래픽 패널을 제공하여 diff 확인과 계획 검토를 지원합니다. 이 확장은 패널을 위한 CLI의 비공개 복사본을 포함하고 있으며 claude을 PATH에 추가하지 않으므로, 통합 터미널에서 claude를 입력하려면 별도의 독립형 설치가 여전히 필요합니다. VS Code 기반의 에디터들은 Open VSX 레지스트리에서 동일한 확장을 설치하며, JetBrains 플러그인도 제공됩니다.

FAQ

Linux에서 Claude Code를 실행하려면 Node.js가 필요한가요?

권장 설치 방식을 사용한다면 필요하지 않습니다. 기본 설치 프로그램은 컴파일된 바이너리를 다운로드하며, 해당 바이너리는 Node.js 위에서 실행되지 않습니다.

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

claude --version 명령은 2.1.211 (Claude Code)과 같은 버전 번호를 출력해야 합니다. 무언가 잘못된 것 같다면 claude doctor을 실행하십시오. 이 명령은 세션을 시작하지 않고 설치 상태와 설정 파일에 대한 읽기 전용 진단 정보를 출력합니다.

Node.js는 npm 경로를 통해 설치할 때만 중요합니다. 패키지 버전 2.1.198 기준으로 npm 패키지는 Node.js 22 이상을 요구합니다. 이전 버전의 Node.js를 사용하면 npm은 실패하는 대신 EBADENGINE 경고를 출력합니다. 이는 패키지가 플랫폼별 의존성으로 동일한 네이티브 바이너리를 가져와 연결하기 때문입니다.

npm install -g @anthropic-ai/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
claude

Ctrl-b를 누른 뒤 d를 눌러 세션에서 분리(detach)하고, 나중에 tmux attach -t claude으로 다시 접속하십시오.

첫 번째 문제는 로그인입니다. claude를 실행하면 인증 URL이 출력됩니다. 이 URL을 로컬 컴퓨터의 브라우저에서 여십시오. 로그인을 완료하면 브라우저는 리다이렉트 대신 로그인 코드를 표시합니다. 이는 로컬 노트북의 브라우저가 원격 머신의 루프백 주소에서 실행 중인 콜백 서버에 접근할 수 없기 때문입니다. 해당 코드를 터미널의 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 인스턴스에서는 커널의 OOM(Out-of-Memory) 킬러가 설치 프로세스를 종료시킵니다.

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 /swapfile

swapon은 이번 부팅 동안만 파일을 활성화합니다. 재부팅 후에도 유지하려면 /etc/fstab 파일에 /swapfile 관련 행을 추가하십시오. 에이전트가 운영 서버에서 명령을 실행하기 전에 보안을 강화하는 방법은 VPS에서 안전하게 Claude Code 실행하기에서 다룹니다.

Linux에서 Claude 자격 증명이 저장되는 위치

Linux에서 /login은(는) 자격 증명을 0600 파일 모드로 ~/.claude/.credentials.json에 기록합니다. macOS는 동일한 자격 증명을 암호화된 Keychain에 저장하므로, Mac에서 익힌 습관을 그대로 적용해서는 안 됩니다. 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 구독 하나로 모든 서비스를 이용할 수 있습니까?

하나의 유료 플랜으로 동일한 계정을 사용하여 모든 인터페이스에 접근할 수 있습니다. Pro, Max, Team 또는 Enterprise 계정으로 브라우저의 claude.ai, 데스크톱 앱, CLI, VS Code 확장 프로그램에 로그인할 수 있으며, 모두 동일한 구독이 적용됩니다. 또한 모든 인터페이스에서 사용량을 공유하므로, 서버에서 CLI를 장시간 실행하면 데스크톱 앱에서 사용할 수 있는 잔여 사용량이 줄어듭니다. 인터페이스 중 하나에서 작업 수행을 거부한다면 현재 도달한 제한 범위와 대응 방법을 확인해야 합니다. 무료 claude.ai 플랜에는 Claude Code 접근 권한이 포함되어 있지 않으므로, CLI 및 데스크톱 앱의 Claude Code 기능을 사용하려면 유료 플랜이나 Claude Console 계정이 필요합니다.

API는 별도의 과금 체계를 가진 다른 제품입니다. Console 계정은 실제 전송한 토큰 단위로 요금이 청구되며, 이는 터미널에서 직접 입력하는 방식보다 서비스 구축에 적합합니다. ANTHROPIC_API_KEY 설정을 변경하면 CLI의 과금 방식이 API 기반으로 전환되는데, 이는 기본값이 아닌 사용자의 선택 사항입니다.

가격과 플랜별 제한 사항은 자주 변경되므로 여기에 명시하지 않습니다. 현재 기준 수치는 다음 두 페이지에서 확인할 수 있습니다. Claude Code 실제 비용 및 필요한 Claude 플랜 확인. 토큰 단위 과금과 월간 플랜 중 고민 중이라면, API와 구독 모델 비교를 통해 손익분기점을 파악할 수 있습니다.

실제로 마주하게 되는 설치 오류

bash: claude: command not found 설치 직후 발생하는 오류. 바이너리는 ~/.local/bin/claude에 위치하지만, 해당 디렉터리가 셸의 검색 경로(PATH)에 포함되어 있지 않습니다. 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 교차 컴파일 패키지가 존재하여 감지 과정에서 오판할 때 발생합니다. 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

이 가이드에 명시된 모든 버전 번호와 날짜는 2026년 8월 기준의 스냅샷입니다. 서비스의 형태는 다음과 같이 유지됩니다: 4개의 인터페이스, 유료 플랜 간 통합 로그인, 그리고 CLI를 사용자 계정에 설치할지 시스템 전체에 설치할지에 대한 결정이 필요합니다.

FAQ

Linux용 Claude 데스크톱 앱이 있습니까?

네. 2026년 8월 기준으로 베타 버전이며, amd64 또는 arm64 아키텍처의 Ubuntu 22.04 이상 및 Debian 12 이상을 지원합니다. Anthropic의 apt 저장소와 서명 키를 추가한 후 sudo apt install claude-desktop 명령으로 설치하십시오. 이렇게 하면 시스템 업그레이드 시 새 버전이 자동으로 함께 업데이트됩니다. Linux 빌드는 macOS 앱과 동일한 탭(Claude Code 탭 포함)을 제공합니다. Computer Use 및 음성 받아쓰기 기능은 아직 Linux 빌드에 포함되지 않았으며, Fedora 및 RHEL용 패키지는 제공되지 않으므로 해당 배포판에서는 CLI를 사용하거나 브라우저에서 claude.ai에 접속하십시오.

Linux에서 Claude Code를 실행하려면 Node.js가 필요합니까?

권장 설치 방식에서는 필요하지 않습니다. curl -fsSL https://claude.ai/install.sh | bash 명령은 런타임에 Node.js를 사용하지 않는 컴파일된 바이너리를 다운로드합니다. Node.js는 npm 패키지로 설치할 때만 중요하며, 버전 2.1.198 기준으로 Node.js 22 이상을 요구합니다. 이전 버전의 Node.js에서 npm을 실행하면 EBADENGINE 경고가 출력되지만, 플랫폼별 종속성으로 동일한 네이티브 바이너리를 가져오므로 설치는 완료됩니다. sudo npm install -g 명령으로 설치하지 마십시오. 이 방식은 npm 접두사 경로에 root 소유 파일을 남겨 추후 업데이트를 방해합니다.

SSH를 통해 Claude Code에 로그인하려면 어떻게 해야 합니까?

claude 명령을 실행하면 인증 URL이 출력됩니다. 서버가 아닌 본인의 컴퓨터 브라우저에서 해당 URL을 여십시오. 로그인 후 브라우저는 리다이렉트 대신 로그인 코드를 표시합니다. 이는 원격 머신의 루프백 주소에서 Claude Code가 시작한 콜백 리스너에 브라우저가 접근할 수 없기 때문입니다. 해당 코드를 Paste code here if prompted 프롬프트에 붙여넣으십시오. 사용자가 직접 조작할 수 없는 세션의 경우 claude setup-token를 실행하고 출력된 토큰을 필요한 곳에 CLAUDE_CODE_OAUTH_TOKEN으로 설정하십시오.

Linux에서 Claude Code는 로그인 정보를 어디에 저장합니까?

~/.claude/.credentials.json 경로에 파일 모드 0600로 저장되거나, 해당 환경 변수를 설정한 경우 CLAUDE_CONFIG_DIR 아래에 저장됩니다. macOS와 달리 Linux에서는 키체인을 사용하지 않으므로, 동일한 사용자로 실행 중인 모든 프로세스가 해당 파일을 읽을 수 있습니다. 따라서 /home 백업이나 머신 이미지를 생성하면 로그인 정보도 함께 포함됩니다. 시스템 스냅샷을 찍거나 복사하기 전에 /logout을 실행하십시오. 환경 변수에 ANTHROPIC_API_KEY가 설정되어 있다면, 승인 후 저장된 구독 로그인 정보보다 우선 적용되며 /status 명령으로 현재 활성화된 정보를 확인할 수 있습니다.

Claude Pro 구독으로 웹 앱뿐만 아니라 CLI도 이용할 수 있습니까?

네. Pro, Max, Team 또는 Enterprise 플랜을 사용하면 하나의 계정으로 claude.ai, 데스크톱 앱, CLI 및 VS Code 확장에 로그인할 수 있습니다. 무료 claude.ai 플랜에는 Claude Code가 포함되어 있지 않으므로, 터미널 CLI를 사용하려면 유료 플랜이나 Claude Console 계정이 필요합니다. API는 구독과는 별개의 제품인 Console 계정을 통해 토큰 단위로 별도 과금됩니다.

#claude #linux #claude-code #cli#desktop