초기 설정 및 환경 구축

Nexus Agent Platform을 처음 설치한 후, 올바른 구동을 위한 초기 셋업을 진행합니다.

디렉토리 초기화

터미널에 다음 명령어를 입력하세요:

nexus-agent init

프로젝트 구동에 필요한 설정 디렉토리(~/.nexus-agent/)가 사용자 홈 위치에 초기화됩니다. 디렉토리 내부 구성은 다음과 같습니다:

~/.nexus-agent/
├── .env              # API 키 설정 파일
├── settings.json     # LLM 설정 (모델, 온도, 프롬프트 등)
├── mcp.json          # 등록된 MCP 서버 설정 파일
├── skills.json       # Agent Skills 활성화 상태
├── pages.json        # Custom Pages 메타데이터
├── workspaces.json   # 등록된 워크스페이스(Workspace) 정보
├── jobs.json         # 등록된 Scheduled Tasks 정보
├── memories.json     # 추출된 장기 기억(Memory) 데이터
├── skills/           # Agent Skills 스크립트 저장 기본 경로
└── pages/            # 업로드된 HTML 등 Custom Pages 저장 경로

API 키 설정

Nexus Agent는 LiteLLM을 기반으로 다양한 프로바이더(Google Gemini, OpenAI, Anthropic, xAI)를 지원합니다. ~/.nexus-agent/.env 파일에 사용하실 프로바이더의 API 키를 입력하세요. (전부 설정할 필요는 없습니다. 사용하실 키 1개만 설정하셔도 됩니다.)

~/.nexus-agent/.env

# Google Gemini — https://aistudio.google.com/apikey
GOOGLE_API_KEY=AIzaSy...

# OpenAI — https://platform.openai.com/api-keys
OPENAI_API_KEY=sk-proj-...

# Anthropic (Claude) — https://console.anthropic.com/settings/keys
ANTHROPIC_API_KEY=sk-ant-...

# xAI (Grok) — https://console.x.ai
XAI_API_KEY=xai-...

운영체제별 적용 팁

macOS / Linux

하나만 등록하는 경우:

echo "GOOGLE_API_KEY=your-api-key-here" > ~/.nexus-agent/.env

여러 프로바이더를 일괄 등록하는 경우:

cat > ~/.nexus-agent/.env << 'EOF'
GOOGLE_API_KEY=AIzaSy...
OPENAI_API_KEY=sk-proj-...
ANTHROPIC_API_KEY=sk-ant-...
XAI_API_KEY=xai-...
EOF

Windows (PowerShell)

Set-Content "$env:USERPROFILE\.nexus-agent\.env" "GOOGLE_API_KEY=your-api-key-here"

참고: 나중에 웹 UI 화면(/settings)에서 사용하는 모델을 지정하면, Nexus Agent가 알아서 해당 프로바이더의 API 키를 참조해 동작합니다.

시스템 환경 변수

만약 CLI의 업데이트 기능인 nexus-agent update를 사용하시려면 GITHUB_TOKEN 환경변수가 필요할 수 있습니다. (설정하지 않으셨다면, GitHub CLI gh auth login을 통해서도 권한이 보장됩니다.)

환경 변수	용도
GITHUB_TOKEN 또는 GH_TOKEN	nexus-agent update 명령 실행 시 Private 리포지토리 접근 인증