메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.cloud.vessl.ai/llms.txt

Use this file to discover all available pages before exploring further.

이 명령어들은 CLI 설정, 인증, 계정 결제, 유틸리티 작업을 처리해요.

​
설정 명령어

​
config show

현재 CLI 설정을 표시해요. 설정 파일 경로, 인증 상태, 해석된 컨텍스트(조직, 팀, API URL)와 그 출처를 포함해요. 
vesslctl config show
출력 예시: 
Config File:       ~/.config/vesslctl/config.yaml
Auth Status:       logged in

default_org (config):    vessl-ai
default_team (config):   ml-research
API URL (resolved):      https://api.cloud.vessl.ai (from default)
Output (resolved):       table (from default)
Org (resolved):          vessl-ai (from config)
Team (resolved):         ml-research (from config)

​
config set

설정 값을 지정해요. 
vesslctl config set <key> <value>
키설명
default_org모든 명령어의 기본 조직
default_team모든 명령어의 기본 팀
output_format출력 형식(table, json, 또는 csv)
api_urlVESSL Cloud API 엔드포인트 URL
예시: 
vesslctl config set output_format json
vesslctl config set default_org vessl-ai

​
인증 명령어

​
auth login

VESSL Cloud에 인증해요. 기본 플로우는 브라우저로 OAuth를 열고, 브라우저를 사용할 수 없을 때 이메일과 비밀번호 로그인으로 폴백해요. 
vesslctl auth login
플래그약어설명
--web브라우저 OAuth만 사용(비밀번호 폴백 비활성화)
--password브라우저 OAuth 대신 이메일/비밀번호 로그인 사용
예시: 
# 기본 브라우저 OAuth (비밀번호 폴백 포함)
vesslctl auth login

# 비밀번호 기반 로그인
vesslctl auth login --password
VESSL Cloud Workspace 내부에서는 VESSLCTL_ACCESS_TOKEN이나 SIDECAR_INITIAL_ACCESS_TOKEN이 설정돼 있을 때 vesslctl auth login이 인터랙티브 로그인을 건너뛰고 안내 메시지만 출력해요. 워크로드 토큰을 무시하고 새로 로그인하려면 --web 또는 --password를 명시적으로 넘겨 주세요.

​
auth logout

로컬 머신에서 저장된 자격 증명을 제거해요. 
vesslctl auth logout

​
auth status

현재 인증 상태를 표시해요. 사용자 이름, 이메일, 토큰 유효성, 조직/팀 컨텍스트, 조직 목록을 포함해요. 
vesslctl auth status
출력 예시: 
Username:       wayne
Email:          wayne@vessl.ai
Token:          Valid (expires 2026-05-01)
Organization:   vessl-ai
Team:           ml-research

ORGANIZATIONS
  vessl-ai (current)
  personal

​
결제 명령어

​
billing show

현재 크레딧 잔액, 소모율, 예상 잔여 시간을 표시해요. 
vesslctl billing show

​
유틸리티 명령어

​
version

vesslctl 버전을 출력해요. 
vesslctl version
루트 명령어의 --version 플래그를 사용할 수도 있어요: 
vesslctl --version

​
install

현재 vesslctl 바이너리를 PATH에 있는 디렉터리에 복사해요. 설치 스크립트로 처음 다운로드한 후 영구적으로 사용하려면 이 명령어를 실행해 주세요. 
vesslctl install
플래그설명
--dir대상 디렉터리(기본값: /usr/local/bin 또는 ~/.local/bin)
예시: 
# 기본 위치에 설치
vesslctl install

# 커스텀 디렉터리에 설치
vesslctl install --dir ~/bin
기본 디렉터리에 루트 권한이 필요한 경우 sudo vesslctl install을 사용해 주세요.