Flaq AI 에이전트 가이드

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

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

에이전트 가이드

Claude Code/cc-api OpenAI Codex/codex-api/v1 Hermes Agent/api/v1

설치

Codex CLI 설치

공식 Codex CLI 패키지 또는 앱을 설치한 다음, Flaq AI를 설정하기 전에 codex 명령을 사용할 수 있는지 확인합니다. npm을 사용할 때는 Node.js 22+가 필요합니다.

Codex CLI 설치

시스템에 맞는 설치 방법을 선택한 다음 아래 명령을 실행합니다.

공식 설치 스크립트

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Codex CLI 확인

Flaq 공급자를 설정하기 전에 codex 명령을 사용할 수 있는지 확인합니다.

설치 확인

codex --version

Codex CLI 설치

시스템에 맞는 설치 방법을 선택한 다음 아래 명령을 실행합니다.

npm 전역 설치

npm install -g @openai/codex

Codex CLI 확인

Flaq 공급자를 설정하기 전에 codex 명령을 사용할 수 있는지 확인합니다.

설치 확인

codex --version

설정

Codex CLI를 Flaq AI에 연결

Flaq Codex 엔드포인트에서 현재 지원되는 모델을 선택하고, Flaq을 Codex 모델 공급자로 정의한 뒤 Flaq API 키를 OPENAI_API_KEY로 제공합니다. 오픈 소스 Codex 스킬은 코딩, 배포, 테스트, 문서, 창작 작업을 비롯한 여러 작업을 위한 재사용 가능한 워크플로를 제공합니다.

Flaq AI를 통한 Codex 코딩 워크플로의 기본 GPT 5.6 모델입니다.

현재 터미널 세션에서 임시 OPENAI_API_KEY를 사용합니다. 이렇게 하면 API 키를 ~/.codex/auth.json에 넣지 않아도 되지만, Codex에는 여전히 ~/.codex/config.toml의 Flaq 공급자 항목이 필요합니다.

Codex 공급자 설정

공급자 구성을 만들거나 업데이트하고 wire_api를 responses로 유지합니다. Windows에서는 %USERPROFILE%\.codex\config.toml을 사용합니다.

Codex 공급자 설정

~/.codex/config.toml

model = "gpt-5.4" model_provider = "flaq" [model_providers.flaq]name = "flaq gpt"base_url = "https://api.flaq.ai/codex-api/v1"wire_api = "responses"requires_openai_auth = true

Codex 공급자 설정

~/.codex/config.toml

model = "gpt-5.5" model_provider = "flaq" [model_providers.flaq]name = "flaq gpt"base_url = "https://api.flaq.ai/codex-api/v1"wire_api = "responses"requires_openai_auth = true

Codex 공급자 설정

~/.codex/config.toml

model = "gpt-5.6-sol" model_provider = "flaq" [model_providers.flaq]name = "flaq gpt"base_url = "https://api.flaq.ai/codex-api/v1"wire_api = "responses"requires_openai_auth = true

Codex 공급자 설정

~/.codex/config.toml

model = "gpt-5.6-terra" model_provider = "flaq" [model_providers.flaq]name = "flaq gpt"base_url = "https://api.flaq.ai/codex-api/v1"wire_api = "responses"requires_openai_auth = true

Codex 공급자 설정

~/.codex/config.toml

model = "gpt-5.6-luna" model_provider = "flaq" [model_providers.flaq]name = "flaq gpt"base_url = "https://api.flaq.ai/codex-api/v1"wire_api = "responses"requires_openai_auth = true

이 터미널에 Flaq API 키 설정

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

이 터미널에 Flaq API 키 설정

export OPENAI_API_KEY="Your_Flaq_Api_Key"

현재 PowerShell 세션에서 임시 OPENAI_API_KEY를 사용합니다. 이렇게 하면 API 키를 %USERPROFILE%\.codex\auth.json에 넣지 않아도 되지만, Codex에는 여전히 %USERPROFILE%\.codex\config.toml의 Flaq 공급자 항목이 필요합니다.

Codex 공급자 설정

공급자 구성을 만들거나 업데이트하고 wire_api를 responses로 유지합니다.

Codex 공급자 설정