AI 앱 연결

Mac과 Windows에서는 Claude Code나 Claude Desktop 같은 AI 앱이 Pyxen에서 열어 둔 프로젝트 안에서 작업할 수 있습니다. 코드를 읽고, 검사하고, 게임을 실행해 테스트하고, 변경합니다. 모든 변경 사항은 일어나는 즉시 Pyxen에 표시되며 실행 취소할 수 있습니다.

AI 앱 연결은 Mac과 Windows용 Pyxen 정식 라이선스에 포함됩니다. 직접 켜기 전까지는 꺼져 있습니다.

켜기

Pyxen › 설정…(Windows에서는 편집 › 설정…)을 열고 AI를 선택한 다음 이 컴퓨터의 AI 앱이 Pyxen을 사용하도록 허용을 켭니다. 상태 행에 현재 상황이 표시됩니다. AI 앱을 기다리는 중, 앱이 Pyxen과 통신하기 시작하면 …에 연결됨.

Pyxen은 이 설정이 켜져 있고 Pyxen이 열려 있는 동안에만 연결을 기다립니다. 끄면 모든 연결이 닫힙니다.

AI 앱에 Pyxen 추가하기

설정 › AI가 필요한 내용을 모두 채운 설정을 복사해 줍니다.

Claude Code

  1. Claude Code용 명령 복사를 선택합니다.
  2. 터미널(Windows에서는 PowerShell 또는 Windows 터미널)에 명령을 붙여넣고 Return 키를 누릅니다. 작업하는 모든 폴더에서 Claude Code에 Pyxen이 추가됩니다.
  3. Claude Code에서 /mcp를 입력하면 pyxen과 그 도구가 표시됩니다.
  4. 게임에 대해 물어보세요: “Pyxen에 열려 있는 게임에 2단 점프를 추가하고 테스트해 줘.”

Claude Desktop

  1. Claude Desktop용 설정 복사를 선택합니다.
  2. Claude Desktop에서 Settings › Developer › Edit Config를 열고 파일에 줄을 붙여넣습니다. 이미 서버가 있다면 그 옆에 pyxen 부분을 추가합니다.
  3. Claude Desktop을 종료했다가 다시 엽니다.

Claude Desktop은 열려 있는 앱에 연결하기 위해 Pyxen을 직접 실행하므로 파일에는 토큰이 없습니다. 설정을 켠 채로 Pyxen을 열어 두세요.

다른 AI 앱

주소로 연결하는 앱: 주소와 토큰 복사를 선택해 앱에 주소와 토큰을 알려 주세요. 토큰은 Authorization: Bearer …로 보냅니다. 서버를 명령으로만 실행하는 앱: Claude Desktop 설정처럼 Pyxen 자체 뒤에 --mcp를 붙여 알려 주세요.

앱이 처음 연결할 때

Mac에서는 AI 앱이 처음으로 프로젝트에서 작업하려고 하면 Pyxen이 자체 창에서 묻습니다. Claude이(가) Pyxen에서 작업하려고 합니다와 함께 할 수 있게 되는 일이 표시됩니다. 허용을 선택하면 Pyxen이 기억하고 그 앱에 대해 다시 묻지 않습니다. 허용 안 함을 선택하면 거절했다는 사실이 앱에 전달되고, 다음에 연결할 때 다시 묻습니다. 질문은 2분 동안 답을 기다린 뒤 앱에 다시 시도하라고 알립니다. Pyxen이 다른 앱 뒤에 있으면 Dock의 아이콘이 튑니다.

Windows에서는 Pyxen이 아직 묻지 않습니다. 설정한 앱은 설정을 켜는 즉시 연결됩니다.

AI 앱이 할 수 있는 일

Windows에서는 Pyxen 창에 열려 있는 프로젝트에서만 작업하며, 닫힌 프로젝트는 아직 열 수 없습니다.

작업 지켜보기

Mac에서는 앱이 프로젝트에서 작업하는 동안 그 윈도우의 도구 막대에 Claude · 작업 중과 정지가 표시됩니다. 이름을 클릭하면 어시스턴트 패널이 열리며, 앱이 거친 각 단계(main.py을(를) 읽었습니다, 확인: 문제 없음, 따로 실행했습니다: 90프레임)와 변경한 파일과 줄이 담긴 각 변경을 볼 수 있습니다.

변경 사항은 작업하는 대로 프로젝트에 반영됩니다. 변경된 파일을 보여 주는 코드 패널에는 즉시 나타나며, 그 패널에서 편집 › 실행 취소(Ctrl+Z)로 되돌릴 수 있습니다. 실행 중인 게임에는 코드가 변경됨 · 새로고침이 표시됩니다.

Windows에는 도구 막대의 이름, 어시스턴트 패널, Claude의 변경 실행 취소가 아직 없습니다.

프로젝트를 변경하기 전에 묻기. Mac에서는 무언가 바뀌기 전에 결정하고 싶다면 설정 › AI › 프로젝트를 변경하기 전에 묻기를 켭니다(기본값은 끔). 그러면 앱의 변경은 바꿀 파일과 줄과 함께 하나의 제안, 승인을 기다리는 변경으로 어시스턴트 패널에서 기다립니다. 선택할 때까지 프로젝트는 그대로이고, 그동안 앱은 자신의 제안을 읽고 실행합니다. 승인하면 하나의 변경으로 프로젝트에 들어가며, 다른 변경처럼 실행 취소하거나 되돌릴 수 있습니다. 거절하면 버려지고, 앱에 전달됩니다. 그사이에 그 파일 중 하나를 편집하면 거절만 남습니다. 앱에 다시 요청하세요.

AI 앱이 할 수 없는 일

Pyxen 창에 열려 있는 프로젝트 안에서만 작업합니다. 프로젝트 밖의 파일, 네트워크, Pyxen 자체 설정, 라이선스에는 절대 접근하지 않습니다. Mac에서는 닫힌 프로젝트는 이름만 목록에 나옵니다. 열도록 허락하기 전까지는 읽지 않습니다. Windows에서는 열려 있는 프로젝트만 목록에 나옵니다.

개인정보 보호

연결은 이 컴퓨터 안에서만 이루어집니다. Pyxen은 이 컴퓨터에서만 연결을 기다리고, 모든 요청에는 토큰이 필요하며, 웹 페이지의 요청은 거부됩니다. Windows에서는 토큰을 내 Windows 계정만 읽을 수 있도록 보관합니다. Pyxen은 저희에게 아무것도 보내지 않습니다. AI 앱에 요청한 내용은 해당 앱의 약관을 따릅니다.

설정 › AI의 새 토큰은 새 토큰을 만들고 이전 토큰을 사용하는 앱의 연결을 끊습니다. Claude Code에는 새 명령이 필요하지만, Claude Desktop 설정은 그대로 작동합니다.

팁