토니 파이썬 다운로드를 찾는다면 Thonny 공식 사이트에서 운영체제와 CPU에 맞는 5.0.0 설치 파일을 고르세요. Windows x64·ARM용 EXE와 Intel·Apple Silicon Mac용 PKG가 공식 릴리스에 무료로 제공됩니다. Thonny는 초보자가 Python 코드를 쓰고 실행 결과를 바로 확인하기 좋은 편집기이며, 이 설치판에는 Python 3.14가 포함됩니다.
공식 화면에서 보이는 편집기와 Shell을 기준으로 첫 hello.py 파일을 저장하고 실행 결과를 확인하는 순서를 알아보겠습니다. 기존 Python 설치가 없어도 포함된 인터프리터로 첫 코드를 시작할 수 있습니다.
Thonny는 파이썬을 어떻게 배우게 해 주나요?
Thonny는 편집기에 코드를 쓰고 아래쪽 Shell에서 실행 결과를 보는 파이썬 통합 개발 환경입니다. 공식 사이트의 전체 화면에는 편집기, Variables 창, Shell이 함께 보입니다. 처음부터 복잡한 프로젝트 설정을 하지 않아도 짧은 .py 파일을 저장하고 F5로 실행할 수 있어, 명령이 실제로 어떤 결과를 만드는지 확인하기 쉽습니다.
공식 사이트는 View → Variables 메뉴로 변수 값을 보고, Ctrl+F5로 프로그램을 단계별로 실행하는 방법을 안내합니다. 한 단계씩 살펴볼 때 F6는 큰 단계, F7은 작은 단계로 이동합니다. 예를 들어 `name = "Thonny"` 다음 줄에서 name의 값이 생기는 시점을 보면, 출력 문장만 읽는 것보다 변수의 흐름을 이해하기 좋습니다.
설치판에 포함된 Python 3.14와 별도로 설치한 Python은 다를 수 있습니다. 수업이나 기존 프로젝트가 다른 버전을 요구하면 Thonny의 오른쪽 아래 인터프리터 선택을 확인해야 합니다. 공식 릴리스 안내도 이전 버전 설정을 이어받아 시작 오류가 날 때 이 선택기를 사용하라고 설명합니다. 첫 예제는 내장 Python으로 진행하고, 외부 환경은 필요한 때 따로 고르는 편이 혼란이 적습니다.
공식 화면에서 본 편집기, Shell, Variables와 디버깅
Thonny 공식 사이트의 정적 기능 예시입니다. 전체 화면은 편집기·Variables·Shell의 배치를 보여 주고, 작은 기능 그림은 출력·변수·단계별 실행을 보여 줍니다. 이미지에 버전 표기가 없어 5.0.0의 설치 화면으로 보지 않습니다.
| 프로그램 | Thonny(토니) |
|---|---|
| 확인 릴리스 | 5.0.0 · 공식 GitHub 릴리스 |
| Windows x64 | Python 3.14 포함 EXE · Windows 10·11 |
| Windows ARM | 별도 ARM64 EXE |
| Mac | Intel x64 또는 Apple Silicon ARM64 PKG · macOS 10.15 이상 |
| 라이선스 | MIT · 공식 파일 무료 다운로드 |
Windows와 Mac에서 맞는 파일 고르기
Windows 설정의 시스템 종류가 x64 기반 Intel·AMD이고 운영체제가 Windows 10 또는 11이면 `thonny-5.0.0-x64.exe`를 받으세요. ARM 기반 Windows PC에는 별도의 `thonny-5.0.0-arm64.exe`가 있습니다. 공식 안내는 x64 파일의 Windows 10·11 조건을 명시하지만 ARM판의 지원 Windows 버전을 같은 문장으로 확정하지 않으므로, ARM 사용자는 공식 릴리스의 현재 요구 사항을 함께 확인해야 합니다.
Mac에서는 ‘이 Mac에 관하여’에서 칩 종류와 macOS 버전을 확인하세요. Intel Mac에는 `thonny-5.0.0-x64.pkg`, Apple Silicon(M 시리즈)에는 `thonny-5.0.0-arm64.pkg`를 고릅니다. 5.0.0 릴리스는 이 PKG 설치판의 최소 macOS 버전을 10.15 Catalina로 안내합니다. 파일명에 있는 x64와 arm64는 설치 파일에 포함된 Python의 아키텍처도 구별합니다.
공식 사이트에는 Windows 휴대용 ZIP과 기존 Python을 쓰는 고급 설치 방법도 보입니다. 처음 배우는 사람은 Python 3.14가 포함된 일반 EXE 또는 PKG를 고르면 됩니다. Windows 7·8과 32비트 Windows에는 5.0.0 일반 설치판이 발행되지 않았습니다.
- 설정에서 운영체제 버전과 CPU가 x64 또는 ARM인지 확인합니다.
- Windows는 알맞은 EXE, Mac은 Intel 또는 Apple Silicon용 PKG를 고릅니다.
- 받은 파일의 이름과 공식 thonny/thonny 릴리스를 대조합니다.
Thonny 설치와 첫 실행 확인
Windows에서는 공식 EXE를 받은 뒤 파일명과 시스템 종류를 다시 보고 설치를 진행하세요. Mac에서는 알맞은 PKG를 열어 화면의 설치 안내를 따릅니다. 기존 Thonny 4를 쓰고 있다면 5.0.0 릴리스가 먼저 이전 버전을 제거할 것을 권장하므로 현재 저장된 .py 파일의 위치를 확인하고 업그레이드하세요. 파일 다운로드 자체에 결제나 계정 생성은 요구되지 않습니다.
설치가 끝난 후 Thonny를 열면 편집기와 Shell을 확인하세요. 화면 아래의 인터프리터 표시가 이전 Python 경로를 가리켜 시작 오류가 난다면, 오른쪽 아래 인터프리터 선택에서 내장 Python을 다시 고릅니다. 공식 릴리스가 이전 설정으로 인한 이 오류와 해결 위치를 직접 안내합니다. 처음 설치한 PC라면 기본 포함 Python으로 아래 예제를 실행하면 됩니다.
첫 실행 화면의 구성이 공식 사이트의 작은 예시 그림과 완전히 같지 않아도 편집기와 Shell이 보이는지 먼저 확인하세요. 기능 패널은 View 메뉴에서 켤 수 있습니다. 디버깅이나 패키지 관리처럼 지금 쓰지 않을 기능을 먼저 열 필요 없이, 파일 저장과 한 번의 실행 결과 확인부터 끝내면 설치가 실제로 쓸 수 있는 상태인지 알 수 있습니다.
- 공식 EXE 또는 PKG의 아키텍처를 확인하고 설치 안내를 완료합니다.
- Thonny를 열어 편집기와 Shell이 보이는지 확인합니다.
- 이전 인터프리터 경로 오류가 있으면 오른쪽 아래 선택기에서 내장 Python을 고릅니다.
hello.py를 저장하고 Shell 출력 보기
Thonny의 편집기에서 새 파일을 열고 `name = "Thonny"`와 `print("Hello, " + name + "!")`를 두 줄로 입력하세요. 파일 메뉴에서 저장을 선택해 `hello.py`라는 이름으로 작업 폴더에 보관합니다. 파일 확장자가 .py인지 확인하면 텍스트 문서와 구별하기 쉽습니다. 이름과 문자열을 바꾸고 싶다면 큰따옴표의 짝과 괄호가 맞는지도 함께 보세요.
F5로 현재 스크립트를 실행하세요. 키보드에서 F5가 음량·밝기 조절로 동작하면 Thonny의 실행 메뉴나 실행 도구에서 현재 스크립트를 고르면 됩니다. 아래 Shell에 `Hello, Thonny!`가 출력되면 작성·저장·실행이 한 번 이어진 것입니다. 편집기의 글자와 Shell의 출력은 역할이 다릅니다. 실행 전에 편집 내용을 고쳤다면 다시 저장한 뒤 새 출력이 바뀌었는지 비교하세요.
한 줄을 더 추가해 `print(2 + 3)`을 실행하면 Shell에 5가 이어집니다. 이 예제는 입력이 숫자 계산으로도 처리되는지 확인하기 위한 짧은 연습입니다. 새 파일을 만들 필요 없이 hello.py를 고쳐 다시 실행할 수 있습니다. 파일을 어디에 저장했는지 기억해 두면 나중에 File → Open으로 같은 .py 파일을 열어 계속 작업할 수 있습니다.
- 편집기에 name 대입문과 print 문을 쓰고 hello.py로 저장합니다.
- F5로 현재 스크립트를 실행합니다.
- Shell의 Hello, Thonny! 출력과 수정 후 출력 변화를 확인합니다.
Variables와 단계별 실행으로 값의 흐름 보기
첫 출력이 확인됐다면 View → Variables를 열고 hello.py의 `name` 값을 살펴보세요. 공식 사이트의 Variables 예시는 변수명과 값을 표로 보여 줍니다. `name`에 다른 문자열을 넣어 다시 실행하면 표의 값과 Shell 출력이 함께 달라지는지 확인할 수 있습니다. 변수 창은 편집기에서 쓴 이름이 실행 중 어떤 값을 가졌는지 보는 기능입니다.
Ctrl+F5로 단계별 실행을 시작한 뒤 F6 또는 F7로 이동하면 현재 실행 위치가 표시됩니다. 먼저 name 대입문을 지난 다음 Variables에서 값이 생기는지, print 문을 지난 다음 Shell에 문장이 나오는지 순서대로 보세요. F6와 F7의 자세한 차이는 공식 사이트가 각각 큰 단계와 작은 단계로 설명합니다. 처음에는 두 줄짜리 코드에서 한 단계마다 어디가 바뀌는지만 관찰해도 충분합니다.
코드가 길어졌을 때도 같은 방법이 통합니다. `print` 결과만으로 어느 줄에서 값이 달라졌는지 알기 어렵다면 Variables와 디버거가 그 사이를 보여 줍니다. 공식 기능 이미지는 작아 글자를 확대해야 보일 수 있으나, 실제 프로그램에서는 창 크기를 조정하고 현재 자신의 파일을 열어 같은 패널을 확인하세요.
- View → Variables를 켜고 name의 현재 값을 확인합니다.
- Ctrl+F5로 단계별 실행을 시작합니다.
- F6 또는 F7로 이동하며 변수 값과 Shell 출력이 나타나는 시점을 비교합니다.
첫 실행에서 생기는 문제 해결
Thonny가 시작하자마자 이전 Python 경로를 찾지 못한다면 4.x에서 남은 인터프리터 설정을 의심하세요. 5.0.0 릴리스 안내대로 오른쪽 아래 인터프리터 선택기를 열고 새 내장 Python 위치를 고릅니다. 프로그램을 다시 설치하기 전에 선택된 인터프리터가 오래된 경로인지 확인하면 원인을 좁힐 수 있습니다.
F5를 눌렀는데 예상한 문장이 없으면 실행 대상이 hello.py인지, 수정한 내용을 저장했는지, Shell에 오류가 적혀 있는지 차례대로 보세요. `SyntaxError`는 괄호나 따옴표를 닫지 않은 경우가 많고, Thonny는 이런 문법 실수를 편집기에서 강조합니다. 위 두 줄을 다시 비교하고 고친 뒤 저장해 실행하세요. `NameError`가 나오면 name을 먼저 대입했는지와 철자가 같은지 확인합니다.
Mac에서 파일을 열거나 저장할 때 권한 오류가 발생한다면 해당 폴더에 Thonny의 접근 권한이 있는지 확인하세요. 공식 Mac 안내는 Catalina 이후 Desktop·Documents 같은 위치의 권한 요청이 나타날 수 있다고 설명합니다. 다른 폴더에 새 hello.py를 저장해 볼 수도 있습니다. 문제를 해결하려고 출처가 불분명한 Python 설치 파일을 다시 받을 필요는 없습니다.
패키지를 추가해야 하는 다음 단계에서는 공식 사이트가 안내하는 Tools → Manage packages를 사용할 수 있습니다. 다만 hello.py의 print 예제는 외부 패키지가 전혀 필요하지 않습니다. 패키지 설치 오류를 첫 실행 문제와 섞지 말고, 이 예제가 내장 Python과 Shell에서 정상 작동하는지 먼저 확인하세요.
자주 묻는 질문
Thonny는 무료로 받을 수 있나요?
예. 공식 사이트와 GitHub 릴리스의 설치 파일을 무료로 받을 수 있으며, 프로젝트의 라이선스는 MIT입니다.
Python을 먼저 설치해야 하나요?
일반 Windows·Mac 5.0.0 설치판에는 Python 3.14가 포함돼 있어 첫 코드를 위한 별도 Python 설치가 필요하지 않습니다.
Windows x64와 ARM 중 어느 파일을 고르나요?
Intel·AMD Windows 10·11 x64는 x64.exe, ARM 기반 Windows PC는 별도 arm64.exe를 선택합니다.
Mac에서 Intel과 Apple Silicon 파일은 어떻게 구별하나요?
이 Mac에 관하여에서 칩 종류를 확인해 Intel은 x64.pkg, M 시리즈는 arm64.pkg를 받습니다. 설치판은 macOS 10.15 이상을 요구합니다.
실행 결과가 보이지 않으면 어디를 확인하나요?
hello.py를 저장했는지와 현재 스크립트를 실행했는지 확인하고, 아래 Shell의 출력 또는 오류 메시지를 읽으세요.
첫 파일의 결과를 본 뒤 변수 흐름도 확인하세요
Thonny는 공식 Windows·Mac 설치판으로 무료로 시작할 수 있는 파이썬 입문 도구입니다. CPU 종류에 맞는 파일을 고른 뒤 편집기에 hello.py를 쓰고 저장하세요. F5 실행 후 Shell에 `Hello, Thonny!`가 나오면 설치부터 첫 코드 실행까지 확인한 것입니다.
다음에는 name 값을 바꿔 출력의 차이를 보고, View → Variables와 Ctrl+F5로 값이 만들어지는 순서를 살펴보세요. 설치판에 포함된 Python으로 이 작업을 먼저 끝내면 다른 인터프리터나 패키지를 추가해야 할 때도 무엇이 달라졌는지 비교하기 쉽습니다.
공식 자료와 확인일
Thonny 공식 사이트·운영체제별 설치판 · Thonny 5.0.0 공식 릴리스와 설치 조건 · Thonny 공식 Windows 설치 안내 · Thonny 공식 Mac 설치 안내 · Thonny 공식 MIT 라이선스 | 2026-10-04T19:09:33.590440+00:00
