빠른 시작

깨끗한 macOS·Linux에서 작동하는 설정과 첫 Dashboard 대화까지 진행하고 Dashboard 프로세스를 재시작해도 대화가 유지됨을 확인합니다.

대상 사용자

다음에 해당하면 사용하세요.

macOS·Linux에서 개인용으로 실행하려는 경우.
일상에는 Dashboard를 선호하지만 배후 터미널 명령도 원하는 경우.
API 키, 지원 구독, 로컬 Ollama·LM Studio가 있는 경우.
메시징·자동화·스킬·외부 도구 전에 신뢰할 채팅 하나를 원하는 경우.

가장 빠른 경로

목표	첫 동작	다음 동작
전체 시각 인터페이스	설치	`anyy setup` 후 `anyy dashboard`
터미널 채팅	설치·구성	`anyy`
스크립트 프롬프트	상주 Gateway 시작	`anyy chat "..."`
Telegram 등 연결	로컬 채팅 확인	`anyy setup channel`

작동하는 채팅 하나로 시작하세요

대체 라우팅, 메시징, Cron, MCP 전에 공급자 하나와 일반 대화 하나를 완료하세요. 첫 문제를 작고 진단하기 쉽게 유지합니다.

1. Anyy 설치

macOS 또는 Linux

표준 네이티브 설치:

curl -fsSL https://anyy.ai/install.sh | sh

셸 명령 확인:

anyy --version

네이티브 릴리스를 받아 CHECKSUMS.sha256로 검증하고 홈 아래 활성화하며 안전하면 명령 진입점을 만듭니다.

지원 설치 대상

macOS·Linux의 amd64/x86_64, arm64/aarch64입니다. Gateway 시작·프로필 생성은 설치가 아닌 설정에서 필요할 때 수행합니다.

anyy가 PATH에 없으면 출력 Binary:로 검증하고 정확한 PATH 안내 디렉터리를 추가하세요. 일반 비root 진입점은 가능하면 $HOME/.local/bin입니다.

2. 공급자 선택

대화형 마법사:

anyy setup

가장 짧은 경로:

Quick setup 선택.
공급자·인증 선택.
검색 카탈로그에서 선택하거나 요구 시 수동 ID 입력.
**Set up model fallback routing?**에 지금은 No.
메시징에 Skip.
공급자·모델·엔드포인트·비밀 수 검토 후 Write these changes? 확인.

지원 연결:

보유 항목	설정 선택
OpenAI API 키	OpenAI → OpenAI API key
ChatGPT 구독	OpenAI → ChatGPT subscription (Codex)
Anthropic 키	Anthropic → Anthropic API
Claude Code 구독	Anthropic → Claude Code subscription
로컬 Ollama·LM Studio	Ollama·LM Studio, 서버 먼저 시작
다른 호환 서비스	OpenAI-compatible·Anthropic-compatible, 엔드포인트 제공

그 밖의 현재 공급자도 나옵니다. 설치 버전의 기준 목록입니다.

성공 setup complete 후:

anyy config

활성 프로필, 홈, 구성, DB, 공급자, 모델, 엔드포인트, 각 비밀 참조 해결 여부를 보여 주며 값은 출력하지 않습니다.

설정 저장 방식

프로필은 자체 완결적입니다.

공급자·모델은 <PROFILE_HOME>/config.yaml.
관리 비밀은 별도 <PROFILE_HOME>/secrets/, 모드 0600.
세션·런타임은 <PROFILE_HOME>/state.db.

일반 비root <PROFILE_HOME>은 $HOME/.anyy, root는 /root/.anyy입니다. ANYY_HOME·이름 프로필은 추측 대신 anyy config를 보세요.

설정은 검토가 먼저입니다

변경을 준비하고 최종 검토합니다. Write these changes? 전 취소하면 구성은 기록되지 않습니다.

3. 첫 채팅 실행

채팅, 세션, 공급자, 도구, 메모리, 역할, 프로필, 채널, 스킬, MCP, Cron을 함께 제공하므로 첫 인터페이스로 Dashboard를 권장합니다.

대화형 터미널:

anyy dashboard

상주 Gateway가 없으면 Gateway required와 다음을 묻습니다.

Start Anyy Gateway now? [Y/n]:

Enter로 수락하세요. 필요하면 서비스 설치·시작 후 준비를 기다리고 Dashboard를 엽니다. Dashboard 종료 뒤에도 Gateway는 유지됩니다.

기본 포트 8767의 This machine과 가능한 Local network URL을 출력합니다. 대화형은 전자를 자동 열며 출력만 원하면 --no-open을 쓰세요:

anyy dashboard --no-open

자동 LAN 대신 루프백 하나만 바인딩:

anyy dashboard --listen 127.0.0.1:8767

Dashboard URL을 비공개로 유지하세요

임시 토큰이 들어 있습니다. 채팅·로그·이슈·스크린샷에 붙이지 마세요. 리스너 중지는 터미널 Ctrl+C입니다.

첫 메시지 보내기

Dashboard에서:

Chat 열기.
New session 선택.
다음 전송:

Introduce yourself as Anyy in one sentence, then list three things you can help me do.

응답이 나타나고 세션 패널에 등록되면 작동합니다.

실제 모델 요청입니다

공급자 할당량·비용이 들 수 있습니다. 프롬프트에 API 키·접근 토큰·비밀을 넣지 마세요.

4. 세션 작동 검증

한 응답에서 멈추지 말고 지속성을 검증하세요.

같은 세션에 후속 전송.
Dashboard 터미널 Ctrl+C.
anyy dashboard 재실행.
Chat에서 이전 세션 선택.
두 턴 확인 후 추가 후속 전송.

세션 저장, Dashboard 재연결, 상주 Gateway 계속 실행이라는 세 경로를 확인합니다.

터미널은 anyy·/sessions에서 고릅니다. ID를 알면:

anyy --resume SESSION_ID

5. 주요 기능 사용

Dashboard 제어

방금 설정을 탐색하세요.

Overview는 런타임 상태·프로필.
Models는 연결·인증·가능 모델·활성 모델.
Chat은 일반·백그라운드 분리.
Roles, Memory는 정체성·지속 컨텍스트.
Tools, Skills, MCP, Channel, Cron은 기본 채팅 안정 후 기능 추가.

Send는 하나이며 실행 중 입력은 위 대기열에 나타나고 Steer로 방향 조정합니다. 줄 바꿈 Shift+Enter, 중단 Escape, 메뉴 /입니다. 채팅 제어를 참조하세요.

터미널 인터페이스

TUI 열기:

anyy

유용 명령:

/help       Show commands and keyboard shortcuts
/new        Start a new session
/sessions   Open recent sessions
/status     Show the current conversation state
/model      Inspect or change the active model
/provider   Inspect providers and provider authentication
/usage      Show provider usage and context
/skills     Insert an available Skill command

Enter는 유휴 전송·작업 중 방향 조정, Alt+Enter는 후속 대기, Shift+Enter·Ctrl+J는 줄 바꿈입니다. /quit 종료와 중단·반환은 TUI를 참조하세요.

일회성 CLI

Gateway 실행 중 전체 UI 없이:

anyy chat "Give me a five-line summary of what Anyy can do."

기계 출력은 --json입니다. 활성 도구가 직접 실행하므로 작업·경로·대상 계정을 제출 전에 확인하세요.

6. 다음 계층 추가

다음에 필요한 것만 추가하세요.

기능	시작	추가 내용
메시징	`anyy setup channel`	지원 연결·접근 정책
대체 모델	`anyy setup model fallback`	순서 백업 체인
웹·이미지·동영상·음성	`anyy tools`	선택 서비스
스킬	`anyy skills list`	추가 전 설치 항목 확인
MCP	`anyy mcp --help`	추가·인증·점검·활성·호출
예약	`anyy cron --help`	일정·전달 설정으로 반복 관리

Dashboard와 Gateway 수명은 다릅니다

Dashboard는 필요 시 웹 사이드카, Gateway는 상주입니다. Ctrl+C는 웹만 닫으며 서비스 Gateway는 멈추지 않습니다.

일반 실패

증상	원인	해결
`anyy: command not found`	`PATH` 누락	정확 안내 후 새 셸에서 `anyy --version` 확인
빈 API 키 후 종료	빈 값은 첫 키 설정 취소	`anyy setup model` 재설정·유효 키 또는 구독/로컬
로컬 모델 불가	서버 미실행·주소 오류	시작 후 `anyy setup model` 재실행
Gateway required	상주 접근 불가	수락 또는 `anyy gateway start` 후 `anyy dashboard`
`127.0.0.1:8767` 사용 중	다른 프로세스	`anyy dashboard --status`·`anyy dashboard --stop` 또는 `--listen 127.0.0.1:8768`
열리지만 전송 불가	공급자·모델·인증·상태	`anyy config`·`anyy status`·`anyy doctor` 후 필요하면 `anyy setup model`
`anyy chat` 연결 불가	Gateway 자동 시작 안 함	먼저 `anyy gateway start`
저장 세션 없음	다른 프로필·홈	Dashboard Profile·Home과 `anyy config` 비교

복구 도구

변경 전에 문제를 좁히도록 순서를 따르세요.

런타임·프로필 확인:
```
anyy status
anyy config
```
진단:
```
anyy doctor
```
Gateway 비정상이며 활성 턴 없으면:
```
anyy gateway restart
```
인증·모델만 잘못됐으면 해당 계층만 복구:
```
anyy setup model
```
리스너 문제면 이전 프로세스 확인·중지 후 새 시작:
```
anyy dashboard --status
anyy dashboard --stop
anyy dashboard
```
여러 프로필이면 활성 확인:
```
anyy profile list
```

빠른 참조

명령	목적
`anyy`	대화형 터미널
`anyy dashboard`	시작·This machine URL 열기
`anyy dashboard --no-open`	브라우저 없이 시작
`anyy chat "PROMPT"`	상주 Gateway로 프롬프트 하나
`anyy --resume SESSION_ID`	기존 TUI 세션
`anyy status`	런타임·Gateway 상태
`anyy doctor`	구성·런타임 진단
`anyy config`	경로·공급자·모델·비밀 상태
`anyy gateway start`	상주 서비스 설치·시작
`anyy gateway restart`	서비스 재시작
`anyy setup model`	공급자·인증·모델·선택 대체
`anyy setup channel`	메시징
`anyy update --check`	새 네이티브 릴리스 확인

다음 단계

Dashboard에서 시각 제어 학습.
모델 구성에서 공급자 추가·변경.
TUI에서 명령·키보드 학습.
메시징에서 플랫폼 연결.
기능에서 제품 전반 탐색.
CLI 참조에서 정확 플래그 조회.

대상 사용자​

가장 빠른 경로​

1. Anyy 설치​

macOS 또는 Linux​

2. 공급자 선택​

설정 저장 방식​

3. 첫 채팅 실행​

첫 메시지 보내기​

4. 세션 작동 검증​

5. 주요 기능 사용​

Dashboard 제어​

터미널 인터페이스​

일회성 CLI​

6. 다음 계층 추가​

일반 실패​

복구 도구​

빠른 참조​

다음 단계​