설치와 준비 — Noea Code 문서

Noea 데스크톱 앱을 설치하고 코딩 에이전트를 하나 이상 준비하세요. 앱에서 설치, 로그인, 연결 확인 과정을 안내합니다.

설치 파일 선택하기

Noea 다운로드 섹션에서 운영체제와 프로세서에 맞는 버전을 선택하세요.

시스템	선택할 버전
macOS	Apple silicon, macOS 13 이상. 현재 Intel Mac용 설치 파일은 제공하지 않습니다.
Windows	Intel 또는 AMD 프로세서는 x64, Windows on ARM 기기는 ARM64를 선택합니다.
Linux	프로세서에 맞는 x86_64 또는 ARM64를 선택합니다. AppImage와 `.deb` 패키지를 제공합니다.

macOS에서는 디스크 이미지를 열어 앱을 설치합니다. Windows에서는 설치 프로그램을 실행합니다. 관리자 권한 없이 현재 사용자용으로 설치됩니다. Linux에서는 배포판에 맞게 AppImage 또는 .deb를 사용합니다.

Noea 시작 시 준비된 에이전트가 없으면 설정 안내가 열립니다.

Noea는 현재 Codex, Claude Code, OpenCode, CodeBuddy Code를 지원합니다. 처음에는 하나만 준비해도 됩니다. 다른 에이전트는 나중에 설정 → 에이전트에서 추가할 수 있습니다.

Noea가 에이전트에 필요한 실행 환경을 다운로드하므로 Node.js를 미리 설치할 필요가 없습니다. 다운로드와 준비 진행 상황은 앱에 표시됩니다.

로그인 과정에서 브라우저, 앱 내 터미널, 시스템 터미널이 열리거나 API 키를 요청할 수 있습니다. 선택한 에이전트의 안내를 따르세요.

Codex는 macOS와 Windows에서 브라우저 로그인을, Linux에서 기기 코드 로그인을 우선 사용합니다. OpenCode는 모델 제공업체를 연결해 설정합니다. 제공업체 계정, API 키, 사용자 지정 엔드포인트는 에이전트, 모델 및 사용량을 참고하세요.

Noea는 로그인 후 연결을 다시 확인합니다. 여전히 로그인을 요청하거나 실패를 알리면 에이전트 상세 패널에서 이유를 확인하세요.

다른 터미널 도구에서 이미 에이전트를 사용하고 있더라도, 여기서 사용할 준비가 되었는지는 Noea 목록의 상태를 기준으로 판단하세요.

다운로드와 에이전트 요청은 시스템의 HTTP(S) 프록시 설정을 사용합니다. 프록시 환경 변수가 설정되어 있으면 우선 적용됩니다. 이 방식은 SOCKS 프록시를 지원하지 않습니다.

다운로드가 실패하면 네트워크와 프록시 설정을 확인하고 같은 위치에서 다시 시도하세요. 잠시 데이터 수신이 멈췄을 때 준비 상태가 표시된다고 해서 반드시 다운로드가 실패한 것은 아닙니다.

설치는 성공했지만 연결 확인이 실패했다면 에이전트 상세 패널에서 다시 로그인하거나 제공업체 설정 또는 네트워크 문제를 해결하세요. 도움을 요청할 때 진단 정보를 복사할 수 있습니다. 문제 해결을 참고하세요.

작업 공간에서 폴더 열기…를 선택하고 코드 폴더를 지정하세요. Noea가 연결된 프로젝트를 열거나 생성합니다. 첫 튜토리얼을 따라 하는 데 완성된 요구사항 문서, MCP 서버, 스킬은 필요하지 않습니다.