Flaq AI 에이전트 가이드

Flaq AI API 서비스와 오픈 소스 AI 에이전트 스킬로 Claude Code CLI를 사용하는 실전 가이드

Flaq AI의 Claude Code 호환 엔드포인트를 사용하면 Claude Code CLI를 Flaq에 맞게 빠르게 설정하고 터미널에서 모델 서비스에 접근할 수 있습니다. API 키를 설정한 뒤 이 가이드의 예제를 따라 현재 지원되는 모델을 선택하고 설정을 검증하세요. 재사용 가능한 오픈 소스 Claude Code 스킬을 살펴보고 AI 에이전트 기능을 확장해 더 다양한 워크플로를 지원할 수도 있습니다.

에이전트 가이드

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1

설치

Claude Code CLI 설치

시스템에 맞게 Claude Code CLI를 설치한 다음, Flaq AI 자격 증명을 추가하기 전에 claude 명령이 작동하는지 확인합니다.

1

Claude Code CLI 설치

시스템에 맞는 설치 관리자를 선택한 다음 아래 설치 명령을 실행합니다.

공식 설치 스크립트

curl -fsSL https://claude.ai/install.sh | bash
2

Claude Code CLI 확인

Flaq AI 자격 증명을 추가하기 전에 claude 명령을 사용할 수 있는지 확인합니다.

설치 확인

claude --version

설정

Claude Code CLI를 Flaq AI에 연결

Flaq Claude Code 엔드포인트에서 현재 지원되는 모델을 선택하고, Flaq API 키를 Anthropic 인증 토큰으로 추가한 뒤 Claude Code CLI가 Flaq API 기본 URL을 바라보도록 설정합니다. 오픈 소스 Claude Code 스킬은 코딩, 배포, 테스트, 문서, 창작 작업을 비롯한 여러 작업을 위한 재사용 가능한 워크플로를 제공합니다.

더 강한 추론, 아키텍처 작업, 복잡한 코드 변경에 권장되는 Claude 모델입니다.

현재 터미널 세션에서 임시 환경 변수를 사용합니다. Flaq을 가장 빠르게 시험해 보는 방법입니다. ~/.claude/settings.json 또는 셸 프로필은 변경하지 않습니다.

  • 이 export 값은 현재 터미널 세션에만 적용됩니다.
  • ~/.claude/settings.json 또는 셸 프로필을 수정하지 않습니다.

이 터미널에 Flaq 환경 설정

export ANTHROPIC_AUTH_TOKEN="Your_Flaq_Api_Key"export ANTHROPIC_BASE_URL="https://api.flaq.ai/cc-api"export ANTHROPIC_MODEL="claude-opus-4-6"

일회성 실행의 경우 ANTHROPIC_MODEL을 생략하고 대신 claude --model claude-opus-4-6을 사용할 수 있습니다.

검증

Claude Code CLI에서 Flaq 검증

터미널에서 간단한 프롬프트를 실행합니다. 정상 응답이 오면 Claude Code CLI가 Flaq AI를 통해 모델을 호출할 수 있다는 뜻입니다.

인터랙티브 모드 시작

claude

빠른 테스트 명령

claude -p "What is 2+2?"

진단 실행

claude doctor

스킬

오픈 소스 AI 에이전트 스킬로 Claude Code 확장

Claude Code 스킬은 반복 작업 전반에서 AI 에이전트 기능을 확장하는 명령, 워크플로, 스크립트, 참조 파일의 재사용 가능한 패키지입니다. 세션마다 같은 명령을 반복하지 않고 코딩, 배포, 테스트, 문서, 창작 작업을 비롯한 워크플로용 스킬을 활용할 수 있습니다. 사용하기 전에 각 스킬의 소스, 필수 도구, 권한을 검토하세요.

Awesome Claude Code Skills

이 다국어 저장소에서 범주별 Claude Code 스킬 링크, 사용 안내, 소스 참조, 설치 세부 정보를 확인하세요.

문제 해결

Claude Code FAQ

이 가이드의 설정으로 사용할 경우 token 사용량이 크게 늘어날 수 있습니다.