Spirit Agent
다운로드

빠른 시작

Spirit Agent를 설치하고, 공급자 하나를 연결하고, 작고 승인된 편집을 적용하세요.

이 페이지는 새 설치에서 유용한 변경 하나까지 안내합니다. 이후 페이지에서는 모든 공급자와 호스트를 다루지만, 이 경로가 없으면 해당 페이지들이 붙을 곳이 없습니다.

1. Desktop 또는 CLI 설치

호스트 하나를 선택하세요. 둘 다 동일한 로컬 데몬을 공유하므로, 나중에 다른 하나를 추가할 수 있습니다.

다운로드 페이지에서 플랫폼에 맞는 빌드를 다운로드한 후 실행하세요.

  • macOS: .dmg (Intel 또는 Apple silicon)
  • Windows: .exe 설치 프로그램 (x64 또는 ARM64)
  • Linux: .AppImage (x64 또는 ARM64)

자세한 내용: Desktop 설치.

2. 작업 공간 열기

에이전트는 작업 공간 루트에서 파일을 읽고 편집합니다. 변경하려는 프로젝트를 여세요.

사이드바에서 작업 공간 폴더 열기를 사용하고 폴더를 선택하세요. 최근 작업 공간은 목록에 유지됩니다.

3. 공급자 하나 연결

이미 사용 중인 공급자의 API 키가 필요합니다. Spirit은 해당 키를 운영 체제 키링(SpiritAgent)에 저장합니다.

  1. 설정 → 모델을 여세요.
  2. 공급자를 선택하고 연결 마법사를 따라가세요.
  3. 키를 붙여넣으세요. 추가 필드(지역, 사이트, 계획 엔드포인트)는 해당 공급자가 필요로 할 때만 나타납니다.
  4. 활성 모델로 채팅 모델을 선택하세요.

4. 작은 변경을 요청한 후 승인하기

첫 실행에서는 Agent 모드와 기본 승인 상태를 유지하세요. 에이전트에게 아는 파일을 읽고, 작고 명확한 편집을 하도록 요청하세요.

예:

Read README.md and add a one-line project summary at the top. Do not change anything else.

에이전트는 파일을 읽고 편집을 제안한 후 대기합니다. 프롬프트에서 파일 변경(및 모든 셸 명령)을 승인하세요. 완료 후 파일을 열어 편집을 확인하세요.

이것이 전체 루프입니다: 설치 → 작업 공간 → 공급자 하나 → 읽기 → 편집 → 승인. 이 문서의 다른 모든 내용은 이 경로에 기반합니다.

다음

  • Desktop 설치CLI 설치가 필요하다면 다른 호스트 또는 고정 버전을 설치하세요.
  • 공급자로 다른 하우스를 연결하거나, 모델이 가져오지 않은 사이트/플랜/클라우드 필드를 확인하세요.