환경 변수

명시 CLI와 검증 프로필 구성을 우선합니다. 환경 변수는 프로세스 기본값, 무인 설치, 터미널 호환, 비밀 참조에 유용합니다.

프로필과 런타임 결정

변수	효과
ANYY_HOME	더 구체 플래그 없을 때 명시 홈
ANYY_DEFAULT_HOME	프로필 관리자·이름 프로필 기본 홈 변경
ANYY_TIMEZONE	구성 미설정 시 이식 IANA 시간대
TZ	구성 미설정·ANYY_TIMEZONE 유효값 없을 때 호스트 대체
ANYY_OFFLINE	1, true, yes는 누락 관리 rg/fd 다운로드만 방지. 기존은 사용하며 모델·웹·MCP 등 네트워크는 끄지 않음

우선순위는 명령별이지만 숨은 export보다 명시 --home·--profile이 명확합니다. anyy config로 결과를 보세요.

선택기를 무심코 섞지 마세요

이름 프로필, --profile-root, 명령별 --home, 환경을 섞으면 두 터미널이 다른 데이터로 갈 수 있습니다. 일상에는 전략 하나를 고르세요.

터미널 표시와 호환

변수	값	효과
NO_COLOR	비어 있지 않음	CLI·설정 색 끄기
FORCE_COLOR	비어 있지 않음	비TTY·CI·TERM=dumb에도 강제. --no-color·NO_COLOR 우선
TERM	dumb	기본 색 끄기·ASCII
CI	비어 있지 않음	기본 색 끄기. FORCE_COLOR 재정의 가능
ANYY_TUI_SPLASH	0	시작 화면 끄기
ANYY_TUI_BRACKETED_PASTE	off	비호환 터미널의 bracketed paste 끄기
ANYY_SKIP_VERSION_CHECK	비어 있지 않음	TUI 업데이트 확인 건너뛰기

단일 명령에는 --no-color를 권장합니다.

자격 증명 참조

지원 필드는 env:NAME으로 참조합니다. 이름은 통합별이며 런타임에 해석하고 비밀을 config.yaml에 복사하지 않습니다.

상주 프로세스가 실제 변수를 받아야 정상입니다. 대화형 셸 export가 서비스에 자동 들어가지 않습니다.

구성 참조가 이름을 선택합니다. 예를 들어 OPENAI_API_KEY export가 모든 공급자를 자동 구성하지 않습니다. 지원 credential_ref를 env:MY_MODEL_KEY로 하고 Gateway에 MY_MODEL_KEY를 전달하세요. MCP 구성 값의 $NAME·${NAME} 환경 확장은 env:NAME 자격 증명 참조와 별개입니다. 셸 표현식도 자체 값 해석 규칙을 따릅니다. MCP 값을 참조하세요.

설치 변수

네이티브 스크립트용:

변수	기본값	목적
ANYY_HOME	일반 $HOME/.anyy, root /root/.anyy	설치 홈
VERSION	최신 공개	사용 가능 태그 고정
ANYY_INSTALL_COMPACT	0	1이면 롤백 보존 축소
ANYY_RELEASE_BASE_URL	https://anyy.ai/releases	신뢰 호환 미러
ANYY_LATEST_URL	<ANYY_RELEASE_BASE_URL>/latest	VERSION 생략 시 마커

예:

curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.107 sh
curl -fsSL https://anyy.ai/install.sh | ANYY_INSTALL_COMPACT=1 sh

제어·독립 검증 미러만 쓰세요. 호환 바이너리·체크섬 엔드포인트가 필요합니다.

보안 지침

• 장기 비밀은 관리 저장소를 권장합니다.
• 환경 비밀은 의도 프로세스만 상속하게 하세요.
• 지원 번들·이슈에 전체 환경을 출력하지 마세요.
• 노출 의심 시 공급자에서 교체하세요.
• 값 없이 참조 상태는 anyy config로 보세요.

문제 해결

증상	확인 사항
잘못된 프로필	ANYY_HOME·ANYY_DEFAULT_HOME, 활성 프로필, 명시 플래그
일정 시간 오류	구성·ANYY_TIMEZONE에 유효 IANA
붙여넣기 이상	ANYY_TUI_BRACKETED_PASTE=off
Gateway env:NAME 미해결	로그인 셸뿐 아니라 상주 서비스 환경에 추가

프로필·저장은 구성을 참조하세요.