Terminal — Linux용 Claude Desktop 확장 프로그램

로컬 Linux 머신에서 Claude에게 터미널, 파일 시스템 및 백그라운드 작업 액세스 권한을 부여하는 Claude Desktop 확장 프로그램입니다.

이 확장 프로그램은 claude_desktop_config.json 방식의 MCP 서버가 로드되지 않는 Linux Claude Desktop의 공백을 해결합니다(해당 메커니즘은 macOS/Windows 전용입니다). Linux에서는 설치 가능한 확장 프로그램을 통해서만 도구를 추가할 수 있습니다.

⚠️ 보안 — 읽어주세요

이 확장 프로그램을 설치하면 Claude에게 사용자 계정에 대한 제한 없는 셸 액세스 권한이 부여됩니다. 사용자가 터미널에서 할 수 있는 모든 작업(사용자가 읽을 수 있는 파일 읽기, 수정 가능한 모든 것 수정, 소프트웨어 설치, 네트워크 연결 열기 등)을 Claude가 이 도구를 통해 수행할 수 있습니다.

이 설치를 누군가에게 내 머신에 대한 SSH 세션을 제공하는 것과 동일하게 취급하십시오. Claude가 보지 않았으면 하는 민감한 데이터가 있는 머신이나 공유 시스템에는 설치하지 마십시오.

명백히 파괴적인 몇 가지 한 줄 명령(rm -rf /, rm -rf ~, 포크 폭탄, 원시 디스크 장치에 대한 dd/mkfs, shutdown/reboot)을 거부하는 최소한의 내장 안전 거부 목록이 있습니다. 이는 최후의 수단인 안전망일 뿐, 샌드박스가 아닙니다. 의도적인 명령은 이를 쉽게 우회할 수 있습니다. 이는 잠시 부주의하더라도 홈 디렉토리가 삭제되지 않도록 하기 위해 존재합니다.

제한을 강화하려면 server.js 상단의 DENYLIST 배열을 편집하고 다시 빌드하십시오. 완전히 제거하려면 DENYLIST = []로 설정하고 다시 빌드하십시오.

Related MCP server: claude-linux-mcp

기능

Claude에게 8가지 도구를 제공합니다:

실행 상태(기록, 작업 임시 파일)는 /tmp/claude-term-mcp/ 아래에 저장되며 재부팅 시 삭제됩니다.

설치

1. Releases 페이지에서 최신 Terminal.mcpb를 다운로드합니다.

2. Claude Desktop → Settings → Extensions를 엽니다.

3. 하단의 Extension Developer 섹션으로 스크롤합니다. Install Extension을 클릭하고 다운로드한 Terminal.mcpb 파일을 선택합니다.

4. Claude Desktop에 "developer info not verified by Anthropic"이라는 빨간색 경고와 함께 확장 프로그램 세부 정보가 표시됩니다. 소스를 신뢰하는지 확인한 후 Install을 클릭합니다.

5. 설치 시 Claude Desktop에서 Default working directory를 묻습니다. 이는 Claude가 별도로 지정하지 않을 때 셸 명령이 실행되는 위치입니다. 주요 프로젝트 폴더를 선택하거나 비워두어 홈 디렉토리를 기본값으로 설정하십시오.

6. All extensions에서 Terminal이 켜져 있는지 확인합니다.

7. 채팅에서 커넥터/도구 선택기를 열고 해당 대화에 Terminal을 활성화합니다.

기본 작업 디렉토리는 나중에 Settings → Extensions → Terminal에서 변경할 수 있습니다.

요구 사항

• Linux용 Claude Desktop ≥ 0.10.0 (macOS에서도 테스트됨)

• Node.js ≥ 16 (Claude Desktop은 확장 프로그램 실행에 사용하는 최신 Node를 번들로 제공하므로 시스템 Node는 필요하지 않습니다)

• PATH에 bash 필요

npm install 단계가 없습니다. 이 확장 프로그램은 의존성이 없는 순수 Node입니다.

구성

모든 구성은 설치 시 또는 Settings → Extensions → Terminal에서 Claude Desktop의 UI를 통해 수행됩니다.

거부 목록이나 기타 동작을 사용자 지정하려면 server.js를 편집하고 다시 빌드하십시오(아래 참조).

알려진 문제

노란색 배너: "Tool result could not be submitted. The request may have expired or the connection was interrupted." 이 메시지는 Claude의 동적 도구 로딩 단계를 트리거하는 모든 턴에서 발생합니다. 404 오류는 Anthropic 백엔드에 대한 도구 검색 결과 제출 시 발생하는 것이며 MCP 도구 자체의 오류가 아닙니다. 도구 호출은 배너 직후에 올바르게 실행되고 반환됩니다. 이는 시각적인 문제입니다. 동일한 문제가 기본 파일 시스템 확장 프로그램에서도 발생합니다. 향후 Claude Desktop 릴리스에서 수정될 클라이언트↔백엔드 프로토콜 불일치로 보입니다.

소스에서 빌드

git clone https://github.com/LukeLamb/claude-terminal-mcp
cd claude-terminal-mcp

# Edit whatever you want in server.js / manifest.json.
# If you change the tool surface, update both places.

# Bump the version in manifest.json so Claude Desktop treats the install as an update.

# Build the bundle:
zip -j Terminal.mcpb manifest.json package.json server.js

# Then install Terminal.mcpb via Claude Desktop → Settings → Extensions → Install Extension.

제거

Settings → Extensions → All extensions → Terminal → Remove.

개인정보 보호정책

데이터는 머신을 떠나지 않습니다. 이 확장 프로그램은 완전히 로컬에서 실행됩니다:

• 데이터 수집: 없음. 확장 프로그램은 외부로 데이터를 전송하거나, 원격 측정을 수행하거나, 자체적으로 네트워크 요청을 하지 않습니다. 관찰되는 모든 네트워크 호출은 사용자가 Claude에게 실행하도록 요청한 것(예: curl, wget, git push)입니다.

• 데이터 사용 및 저장: 명령 기록(stdin 제외, stdout + stderr + exit code)은 /tmp/claude-term-mcp/runs/<timestamp>.log에 기록되어 Claude가 나중에 동일한 대화에서 참조할 수 있습니다. 백그라운드 작업 상태(명령, pid, stdout/stderr 로그 파일, exit code, 상태)는 /tmp/claude-term-mcp/jobs/<job-id>/에 기록됩니다.

• 제3자 공유: 없음. 이 확장 프로그램에 의해 Anthropic, 확장 프로그램 작성자 또는 제3자에게 전송되는 데이터는 없습니다. (Claude Desktop 자체는 일반적인 채팅 흐름의 일부로 도구 입력/출력을 Anthropic에 전송합니다. 이는 사용자와 Anthropic 간의 관계이며 이 확장 프로그램과는 무관합니다.)

• 보관: /tmp/claude-term-mcp/는 재부팅할 때마다 삭제됩니다. 수동으로 삭제하려면 rm -rf /tmp/claude-term-mcp를 실행하십시오.

• 권한 범위: 명령은 터미널에 직접 입력하는 것과 동일하게 사용자의 권한으로 실행됩니다.

• 문의 / 질문: https://github.com/LukeLamb/claude-terminal-mcp/issues에서 이슈를 생성하십시오.

라이선스

MIT. 자유롭게 사용하십시오. 출처 표기를 권장하며 보증은 제공되지 않습니다.