Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Alysis Code는 사용자가 제시한 계획을 검토하고 PR 준비가 완료된 코드로 변환해주는 로컬 CLI 코딩 에이전트입니다. 사용자 모델(BYOM) 지원과 샌드박스 환경에서 작동하며, Python 3.11 이상 환경에서 macOS, Linux, Windows 등 다양한 OS를 지원합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Alysis Code는 Python 3.11 이상을 요구하며 macOS, Linux, Windows에서 실행됩니다.
1 — 설치(Install)
Windows에서는 PowerShell에 다음 내용을 붙여넣으세요:
irm https://raw.githubusercontent.com/AlysisAi/AlysisCode/main/scripts/install.ps1 | iex
Linux, macOS 또는 WSL/Ubuntu 터미널 내부에서는 다음을 실행하세요:
curl -LsSf https://raw.githubusercontent.com/AlysisAi/AlysisCode/main/scripts/install.sh | sh
설치 프로그램은 필요할 때 uv와 Python 3.12를 제공합니다. 기존의 Python이나 pipx는 필요하지 않습니다.
PowerShell에서는 alysis를 즉시 사용할 수 있습니다. 셸 설치 후, 해당 PATH 지침을 따르거나 새 터미널을 여십시오. 이미 pipx를 사용하고 있다면, pipx install alysis-code도 작동합니다. 명령어가 누락된 경우 pipx ensurepath를 실행하고 터미널을 다시 시작하십시오.
2 — 계정 연결하기
alysis login
Alysis 크레딧을 사용하려면 브라우저에서 코드를 승인해야 합니다. 클라우드 환경 변수는 필요하지 않습니다. 기존 0.15.1 사용자는 먼저 alysis update로 업그레이드해야 합니다.
3 — 프로젝트에서 실행하기
cd your-project
alysis-code
첫 실행 시 안내 설정 마법사(guided setup wizard)가 열립니다: API 키 사용(Use an API key) 또는 **AI 구독 사용(Use an AI subscription)**을 선택하고, 제공업체를 연결하며, 기본 모델을 선택합니다. 언제든지 alysis-code setup으로 다시 실행할 수 있습니다. (alysis도 짧은 별칭으로 작동합니다.)
개발 시작하기
alysis-code chat # 대화형 코딩 세션
alysis-code run "Fix the failing tests" # 일회성 작업
지원되는 모든 제공업체로부터 직접 키를 가져오거나 — Alysis Code를 로컬 엔드포인트(Ollama, LM Studio, vLLM)로 지정하여 완전히 오프라인으로 실행할 수 있습니다. /config 선택기에는 모든 사전 설정이 나열되어 있습니다. 전체 워크스루: Quickstart guide.
web_search 기능.fullaccess 모드에서도 rm -rf /, curl | sh, sudo를 거부하는 항상 켜져 있는 블랙리스트와 함께 Docker 또는 Bubblewrap 격리를 제공합니다.셸 및 검증 명령어는 기본적으로 엄격한 격리 환경(sandboxing)을 따릅니다. 검증은 `verify_sandbox.mode=
**권한(Permissions)은 강제 실행 계층입니다. --mode로 명령어마다 하나를 선택하거나, /permissions 또는 Shift+Tab으로 채팅에서 다음 메시지의 레벨을 선택하거나, alysis-code config set default_mode <mode>로 기본값을 설정할 수 있습니다. 선택된 내용은 다음 사용자 메시지가 시작될 때 적용되며, 이미 진행 중인 턴(turn)에는 영향을 주지 않습니다:
| 모드 (Mode) | 동작 방식 (Behavior) |
|---|---|
readonly | 검사 및 최상위 읽기 전용 위임 — 파일 쓰기, 셸, MCP, 후보 적용/폐기 또는 중첩 위임 불가. |
| ... | |
**페르소나(Personas)는 그 위에 레이어링되는 작업 자세입니다. /persona로 전환하거나 TUI에서 Tab을 눌러 순환할 수 있습니다: |
| 페르소나 (Persona) | 자세 (Posture) |
|---|---|
code | 구현 — 기본값이며, 전체 코딩 워크플로우입니다. |
| ... | |
페르소나는 관례일 뿐, 결코 권한이 아닙니다. 실행 모드를 유지하거나 낮출 수는 있지만, 절대 높일 수는 없습니다. .alysis_personas/*.md에 직접 정의할 수 있습니다.더 알아보기 |
채팅에서 계획을 세우려면 /persona architect를 사용하고, 계획 기반 실행 워크플로우를 원하면 /forge를 사용하세요. 이전의 채팅 /plan 명령어는 제거되었으며, Forge는 계획 보기와 편집기를 유지합니다. 진행 중인 턴 중에 변경된 페르소나는 해당 턴이 완료된 후에 적용됩니다.
Apache-2.0. 귀하는 기여와 라이선스 고지 사항을 유지하는 한, 이 코드를 상업적으로 포함하여 사용, 수정 및 배포할 자유가 있습니다. LICENSE 및 NOTICE를 참조하세요.
공유 편집기 사이드바에는 Kilo Code/OpenCode의 MIT 라이선스가 적용된 적응형 부분이 포함되어 있으므로, 해당 제3자 고지 사항(third-party notices)을 유지해야 합니다.
Alysis Code는 포크(fork)가 아닙니다. 에이전트 런타임, Forge 오케스트레이션, 서브에이전트 시스템, 터미널 인터페이스, 그리고 샌드박스 레이어는 Alysis AI 팀에 의해 처음부터 설계되고 구축되었습니다.
</details> <details> <summary><b>Alysis Code가 정말 오픈 소스인가요?</b></summary>네. 전체 CLI는 Apache-2.0 라이선스를 따릅니다. 지원되는 모든 제공업체에서 자체 API 키를 가져와 사용하거나, 로컬 엔드포인트에 대해 완전 오프라인으로 실행할 수 있습니다. 에이전트의 어떤 부분도 유료 계정을 요구하지 않습니다.
</details>더 궁금한 점이 있으신가요? 전체 FAQ를 확인하세요.
커뮤니티에 참여하기 — X | GitHub Issues
VS Code는 공유 Alysis 사이드바와 Python IDE 브리지를 사용합니다.
JetBrains는 더 적은 기능 세트를 가진 개발 미리보기 버전입니다.
VS Code 마켓플레이스의 사전 릴리스는 프로덕션 서명 및 승인을 기다리고 있으니, 컴포넌트 패키지를 설치하기 전에 IDE 출시 상태를 확인하세요.