가이드

커넥터 연결, 골렘 생성 등 단계별 가이드.

🧬

AI 프로필 설정

LLM provider와 인증을 설정하여 골렘이 AI를 사용할 수 있게 합니다.

0/4

1. 프로필 이해

AI 프로필은 골렘이 사용할 LLM을 정의해요:

- Provider: claude-cli, codex-cli, anthropic-api, openai-api, gemini-api

- Auth Method: CLI 구독 (subscription_cli) 또는 API 키 (api_key)

- Device: 어떤 머신에서 실행될지

프로필은 meta/ai-profiles//.yaml 에 저장돼요.

2. CLI 구독 프로필 (권장)

Claude Code 또는 Codex 구독이 있으면:

1. 해당 CLI가 로그인된 상태 확인 (claude auth status)

2. 프로필의 env에 CLAUDE_CONFIG_DIR 을 비워두면 기본 ~/.claude/ 사용

3. 별도 비용 없이 구독으로 실행

💡CLAUDE_CONFIG_DIR을 명시하면 오히려 키체인 인증을 못 찾을 수 있어요. 비워두세요.

3. API 키 프로필

API 키로 직접 호출:

1. 프로필 → ✏️ 편집 탭

2. Provider: anthropic-api / openai-api / gemini-api

3. Auth Method: api_key

4. API 키 입력 → fleet/secret/ 에 자동 보관

5. 저장

4. 골렘에 프로필 연결

골렘 상세 → ✏️ 편집 탭 → AI 프로필 드롭다운에서 선택 → 저장.

디바이스도 프로필과 맞춰주세요.