클로드 코드 노드 파이썬: 설치에는 필요 없는데 왜 깔라고 하나

Claude Code(클로드 코드)와 Codex CLI(코덱스 CLI)는 컴퓨터 안의 파일을 읽고 명령을 실행하며 일을 맡기는 터미널용 AI 도구입니다. 그런데 설치 안내를 찾다 보면 Node.js(노드)와 Python(파이썬)을 먼저 깔라는 말을 만납니다. 둘 다 프로그래밍을 배워야만 쓸 수 있는 프로그램처럼 보입니다.

이 글은 지인의 질문에서 시작했습니다. 회사에서 반복하는 업무를 자동으로 만들어 보려던 사람인데, 왜 이걸 깔아야 하는지 물었습니다. 스킬이라는 걸 쓰려면 모두가 이걸 설치한 것인지도요. 도와주던 저도 설명하다 헷갈렸습니다.

헷갈린 이유는 안내문이 두 가지를 한 문장에 섞어 놓았기 때문입니다. 설치할 때 필요한 것과 도구가 일하면서 불러다 쓰는 것입니다. 아래 그림이 그 둘입니다. 그림에 나오는 npm은 Node.js를 설치하면 같이 따라오는 설치 도구입니다. 그래서 npm으로 무언가를 깔려면 Node.js가 먼저 있어야 합니다. MCP(Model Context Protocol)는 AI 도구를 바깥 프로그램이나 서버에 연결하는 규격입니다. 둘 다 본문에서 다시 설명합니다.

필요한지 아닌지는 설치 경로, AI가 쓴 코드 실행, MCP 연결, 웹 프로젝트 네 경우로 갈립니다. 그다음에 터미널과 파워셸, 홈브루가 각각 무엇인지, 회사 컴퓨터에서 설치가 막혔을 때 무엇을 확인해야 하는지가 이어집니다.

공식 스크립트로 깔면 둘 다 필요 없습니다

먼저 설치 이야기부터 바로잡겠습니다. Claude Code와 Codex CLI는 맥과 윈도우에서 공식 설치 스크립트 한 줄로 설치할 수 있습니다. 사전에 Node.js나 Python을 갖춰야 하는 절차가 아닙니다.

Claude Code 맥 설치 방법도 터미널에서 공식 명령어를 실행하고 로그인하는 순서입니다. Codex CLI도 공식 설치 안내에서 같은 방식의 설치 경로를 제공합니다. npm 경로를 고를 때 필요한 준비물과 공식 스크립트로 설치할 때의 준비물이 다른데, 이 둘을 섞어 말하면 "노드와 파이썬부터 설치하세요"라는 안내만 남습니다.

갈리는 네 경우: 설치, 실행, 확장, 프로젝트

Node.js와 Python이 필요한지는 도구 이름이 아니라 하려는 일로 결정됩니다. 설치 경로, 코드 실행, MCP 연결, 웹 프로젝트는 서로 다른 경우이고 조건도 각각 다릅니다.

첫 번째 행과 나머지 행을 나눠 읽는 것이 중요합니다. 공식 스크립트로 설치하는 동안에는 조건이 없고, 그 뒤에 패키지(다른 사람이 만들어 둔 코드 묶음)를 받거나 MCP 서버를 붙이고 나서야 조건이 생깁니다.

스킬을 쓴다는 사실만으로 Node.js와 Python이 결정되지는 않습니다. 스킬이 실제 코드를 실행하거나 MCP 서버를 연결하도록 구성돼 있는지가 기준입니다. 그래서 "스킬을 쓰는 사람은 모두 파이썬과 노드를 설치했나"라는 질문에는 아니라고 답해야 합니다.

노드가 필요한 세 경우: npm, MCP 서버, 웹 프로젝트

Node.js는 자바스크립트로 쓴 코드를 실행하는 환경입니다. 노드 자체가 어떤 업무를 처리해 주지는 않습니다. 다른 도구와 패키지를 받아 실행하는 쪽에서 요구되기 때문에 안내문에 자주 등장합니다.

첫째는 npm 설치 경로입니다. Claude Code와 Codex CLI를 npm으로 설치하려면 Node.js가 먼저 필요합니다. 공식 스크립트가 아닌 이 경로를 고른 사람에게 노드를 설치하라는 안내가 붙는 이유가 여기에 있습니다.

둘째는 MCP 서버입니다. 공식 레퍼런스 서버 일곱 개를 확인하면 everything, filesystem, memory, sequentialthinking 네 개가 package.json을 가진 노드 서버입니다. package.json은 노드로 만든 프로그램이 무엇을 받아 써야 하는지 적어 두는 파일이라, 이 파일이 있으면 노드로 만들어졌다는 표시입니다. 이 서버들을 설정 파일에서 실행할 때 보게 되는 npx는 패키지를 미리 깔아 두지 않고 필요할 때 받아 실행해 주는 심부름꾼입니다.

셋째는 내 프로젝트입니다. AI에게 웹 프로젝트를 고치거나 실행해 달라고 부탁한다면 그 프로젝트가 Node.js를 실행 환경으로 요구할 수 있습니다. 이때 노드는 Claude Code의 준비물이 아니라 프로젝트가 요구하는 준비물입니다. 같은 컴퓨터에서 일어나는 일이지만 이유는 다릅니다.

파이썬은 일을 처리하는 언어입니다

Python은 파일 변환, 데이터 정리, 자동화처럼 정해진 일을 수행하는 코드를 작성할 때 쓰는 언어입니다. AI에게 이런 스크립트를 만들어 달라고 부탁했을 때 그 파일을 실행하려면 Python 실행 환경이 필요합니다. 코드를 누가 작성했는지가 아니라 어떤 언어로 작성됐는지가 기준입니다.

MCP 서버도 한쪽 언어만 쓰지 않습니다. 공식 레퍼런스 서버 일곱 개 가운데 fetch, git, time 세 개는 pyproject.toml과 uv.lock을 가진 파이썬 서버입니다. 이 둘은 파이썬 쪽에서 같은 역할을 하는 파일입니다. 이 서버들의 설정에서 보게 되는 uvx는 파이썬 패키지를 미리 설치하지 않고 필요할 때 받아 실행해 주는 심부름꾼입니다.

여기서 한 가지가 더 헷갈립니다. fetch는 파이썬으로 만든 서버인데 README는 Node.js를 설치하면 더 견고한 HTML 단순화기를 사용한다고 안내합니다. 파이썬 서버를 쓰면서도 결과를 다듬는 선택지 때문에 노드가 등장할 수 있다는 뜻입니다. 그러니 "MCP는 파이썬 서버니까 파이썬만 있으면 된다"고 단정할 수 없습니다.

공식 레퍼런스 서버 일곱 개는 모두 Dockerfile도 함께 둡니다. 컨테이너(프로그램과 그 실행 환경을 통째로 묶어 두는 방식)에 넣어 돌리는 세 번째 경로가 있다는 뜻입니다. 다만 Docker를 새로 배우고 설치하는 일이 Python이나 Node.js를 설치하는 것보다 가볍지는 않습니다. 처음부터 선택지를 늘리기보다 연결하려는 서버의 공식 안내를 기준으로 고르는 편이 낫습니다.

노드도 파이썬도 "AI를 쓰니까" 미리 깔아 두는 물건이 아닙니다. npm으로 설치할 것인지, 연결할 서버가 어느 쪽으로 만들어졌는지, 실행할 코드가 어느 언어인지를 확인한 뒤 그 환경만 들이면 됩니다.

터미널, 파워셸, 홈브루, WSL의 역할 구분

여기서 한 단계 앞의 혼동을 먼저 풀어야 합니다. 터미널, PowerShell, Homebrew, Python, Node.js, WSL은 같은 종류의 프로그램이 아닙니다.

WSL(Windows Subsystem for Linux)은 윈도우 안에 리눅스 환경을 추가하는 층입니다. 우리 윈도우 설치 글에서 확인한 것처럼 Claude Code와 Codex CLI는 공식 스크립트를 PowerShell 한 줄로 실행할 수 있습니다. WSL을 먼저 설치하라는 안내를 만났다면 예전 설치 경로를 보고 있을 가능성이 큽니다.

PowerShell의 실행 정책도 같은 맥락입니다. irm https://claude.ai/install.ps1 | iex에서 irm은 주소에서 내용을 받아오는 명령이고 iex는 받은 내용을 바로 실행하는 명령입니다. .ps1 파일을 저장해 두고 실행하는 방식이 아니라서 .ps1 파일에 걸리는 실행 정책의 제한을 받지 않습니다. Codex CLI의 윈도우 설치 명령이 앞에 -ExecutionPolicy ByPass를 붙이는 것도 같은 원리 위에 얹은 안전장치이고, 이번 설치 한 번에만 적용되며 컴퓨터의 기본 정책을 바꾸지 않습니다. 두 도구가 실행 정책을 대하는 방식은 같습니다. 다만 회사 보안 정책이 외부 다운로드나 스크립트 실행 자체를 막아 두었다면 두 방식 모두 별도로 차단될 수 있습니다.

실행 환경보다 이름이 먼저 막는 경우도 있습니다. 해외 커뮤니티에는 MCP를 붙이려다 막힌 비개발자의 기록이 올라와 있는데, 막힌 곳이 노드나 파이썬이 아니었습니다. 마켓플레이스에서 유용해 보이는 것을 찾아도 어떻게 내려받는지 몰랐고, 앱과 터미널이 같은 이름으로 불리는 것에 걸렸다는 내용입니다. 그래서 무엇을 설치할지 정하기 전에 지금 보고 있는 것이 앱인지 터미널인지부터 갈라 두는 편이 낫습니다.

안 깔아도 되는 경우

웹이나 데스크톱 앱에서 AI를 대화형으로만 쓴다면 Python과 Node.js를 설치할 필요가 없습니다. Claude Code와 Codex CLI를 공식 스크립트로 설치한 뒤 AI에게 시키는 일이 글쓰기나 문서 정리뿐인 경우에도 두 환경을 미리 준비하지 않아도 됩니다. 지금까지의 이야기는 터미널에서 도구를 돌리기 시작할 때부터 해당됩니다.

필요해지는 순간은 따로 있습니다. npm으로 패키지를 설치할 때, MCP 서버의 공식 안내가 특정 런타임을 요구할 때, AI가 만든 스크립트를 실행할 때, 웹 프로젝트를 직접 실행할 때입니다. 이때는 오류 메시지나 설치 안내에 적힌 언어를 확인하고 그 환경만 추가하면 됩니다.

회사 컴퓨터에서 설치가 막혀 있다면

회사 컴퓨터에서 Python이나 Node.js 설치가 막히는 것은 둘이 표준 개발 도구이기 때문입니다. 코드를 실행하고 외부에서 패키지를 내려받을 수 있어서 회사 정책의 관리 대상이 되기 쉽습니다.

막히는 이유는 흔히 세 방향으로 이야기됩니다.

• 관리자 권한 잠금: 회사 계정에 프로그램 설치나 시스템 경로 변경 권한이 없는 경우입니다.
• 다운로드 차단: 회사 보안 정책이 외부에서 파일을 내려받는 행위 자체를 막아 둔 경우입니다.
• 사내 자료 연결 제한: MCP 서버나 실행 스크립트가 사내 파일에 접근하거나 외부와 통신할 수 있어 그 연결을 회사가 막아 둔 경우입니다.

이 세 가지는 프로그램이 위험해서가 아니라 관리 범위에 들어가서 생기는 제한입니다. 회사가 허용한 설치 경로와 패키지 저장소가 따로 있을 수 있고, MCP 연결에는 승인된 서버만 허용할 수도 있습니다. PowerShell 명령이 실행 정책을 통과하는 것과 회사의 네트워크 정책이나 보안 프로그램(회사가 직원 컴퓨터에 깔아 두는 감시와 차단용 프로그램)을 통과하는 것은 별개입니다.

따라서 회사 컴퓨터에서는 정책을 피해 설치하기보다 IT 담당자에게 필요한 도구 이름과 사용 목적을 먼저 알리는 편이 안전합니다. 회사 안의 자료를 읽거나 사내 시스템에 연결하는 일을 하려면 런타임 설치 여부보다 어떤 파일을 읽고 어디로 보내는지가 더 중요한 확인 대상입니다.

무엇을 깔아야 하는지 몰라서 시작을 미루고 계셨다면, 공식 스크립트로 도구만 먼저 설치하고 실제로 시키고 싶은 일을 한 번 맡겨 보시길 권합니다. 노드든 파이썬이든 정말 필요해지는 순간에는 오류 메시지가 어느 쪽인지 알려 줍니다. 그때 하나씩 들이면 내 컴퓨터에 무엇이 왜 들어왔는지 스스로 설명할 수 있게 됩니다.

자주 묻는 질문

Claude Code와 Codex CLI를 설치하려면 Node.js와 Python이 모두 필요한가요?▸

아닙니다. 공식 설치 스크립트를 쓰면 둘을 미리 설치하지 않아도 됩니다. npm으로 설치하거나 실행할 코드와 MCP 서버가 특정 환경을 요구할 때만 해당 런타임을 준비하면 됩니다.

MCP 서버는 Node.js와 Python 중 무엇을 설치해야 하나요?▸

연결하려는 서버가 정합니다. 공식 레퍼런스 서버 일곱 개를 보면 노드 서버가 네 개, 파이썬 서버가 세 개입니다. 서버 README와 설정 예시의 실행 환경을 먼저 확인하세요.

터미널과 PowerShell은 따로 설치해야 하나요?▸

보통 필요 없습니다. 터미널은 명령을 입력하는 창이고 PowerShell은 윈도우에 포함된 명령 환경입니다. Homebrew나 WinGet은 설치를 편하게 해 주는 선택 도구이며, 공식 스크립트를 쓰면 생략할 수 있습니다.

WSL을 먼저 설치해야 하나요?▸

Claude Code와 Codex CLI를 공식 PowerShell 스크립트로 설치하는 데 WSL은 필요하지 않습니다. 리눅스 환경이 꼭 필요한 프로젝트를 따로 다룰 때 선택하는 층입니다.

회사 PC에서 설치가 막히면 실행 정책을 바꾸면 되나요?▸

먼저 회사 정책을 확인해야 합니다. PowerShell의 파일 실행 정책과 회사의 다운로드 차단, 관리자 권한, 외부 연결 제한은 서로 다른 문제입니다. 정책을 우회하기보다 IT 담당자에게 허용된 설치 경로와 MCP 서버를 확인하는 편이 안전합니다.

출처 (5)펼쳐서 전체 출처 보기▸

• Model Context Protocol 공식 레퍼런스 서버 저장소, 일곱 서버의 런타임 파일과 Dockerfile
• Model Context Protocol fetch 서버 README, Python 서버의 실행 방법과 Node.js 선택 사항
• Model Context Protocol filesystem 서버 README, Node.js 서버의 설치와 실행 예시
• Claude Code 공식 설치 문서, 공식 스크립트와 npm 설치 경로
• OpenAI Codex CLI 공식 문서, 맥과 윈도우 설치 스크립트