Windows (WSL)

WSL로 Windows에서 aicippy-code를 더 편하게 사용하세요.

aicippy-code는 Windows에서 직접 실행할 수 있지만, 가장 좋은 사용 경험을 위해 Windows Subsystem for Linux (WSL) 사용을 권장합니다. WSL은 aicippy-code 기능과 자연스럽게 동작하는 Linux 환경을 제공합니다.

설정

WSL 설치하기

아직 설치하지 않았다면 Microsoft 공식 가이드를 따라 WSL을 설치하세요.
WSL에 aicippy-code 설치하기

WSL 설정이 끝나면 WSL terminal을 열고 설치 방법 중 하나로 aicippy-code를 설치하세요.
Terminal window
```
curl -fsSL https://code.aicippy.com/install | bash
```
WSL에서 aicippy-code 실행하기

프로젝트 디렉터리로 이동한 뒤(aicippy-code에서 Windows 파일은 /mnt/c/, /mnt/d/ 등으로 접근) aicippy-code를 실행하세요.
Terminal window
```
cd /mnt/c/Users/YourName/project
aicippy-code
```

aicippy-code 데스크톱 앱을 쓰면서 서버는 WSL에서 실행하고 싶다면 다음처럼 진행하세요.

WSL에서 서버 시작하기

외부 연결을 허용하려면 --hostname 0.0.0.0 옵션을 사용하세요.
Terminal window
```
aicippy-code serve --hostname 0.0.0.0 --port 4096
```
데스크톱 앱 연결하기

http://localhost:4096로 연결하세요.

--hostname 0.0.0.0을 사용할 때는 AICIPPY_CODE_SERVER_PASSWORD를 설정해 서버를 보호하세요.

AICIPPY_CODE_SERVER_PASSWORD=your-password aicippy-code serve --hostname 0.0.0.0

Windows에서 웹 사용 경험을 가장 좋게 하려면:

PowerShell 대신 WSL terminal에서 aicippy-code web 실행하기
Terminal window
```
aicippy-code web --hostname 0.0.0.0
```
Windows 브라우저에서 접속하기

http://localhost:<port>로 접속하세요(aicippy-code가 URL을 출력합니다).

WSL에서 aicippy-code web를 실행하면 올바른 파일 시스템 접근과 terminal 통합을 유지하면서도 Windows 브라우저에서 바로 사용할 수 있습니다.

WSL에서는 /mnt/ 디렉터리를 통해 Windows 파일 전체에 접근할 수 있습니다.

예시:

cd /mnt/c/Users/YourName/Documents/project
aicippy-code