다운로드
도움말 › AI › AI 설정

⚙️ AI 설정

마지막 수정 2026-09-12

AI는 항상 켜 놓는 컴퓨터 한 대에만 설치하면 됩니다. 집이나 회사 PC 한 대에 AI를 설치하면, 내가 로그인한 모든 기기가 그 컴퓨터에 연결해서 AI를 씁니다. 폰에는 아무것도 설치하지 않습니다.

AI 엔진은 내 구독 그대로

flyocto는 AI 엔진을 제공하지 않습니다. 지금 쓰고 있는 AI 엔진(Claude, Codex, 로컬 LLM 등)을 직접 연결해서 씁니다.

설치 전 확인

반드시 PC나 Mac에서 아래 설치는 PC나 Mac에서만 됩니다. 모바일 기기에서는 실행되지 않습니다.
  • flyocto 앱을 실행하는 바로 그 사용자 계정으로 설치·로그인하세요. 앱은 그 사용자의 AI 도구를 실행합니다.
  • macOS에서 앱을 sudo(관리자)로 실행하지 마세요. 신원과 경로가 root 것이 되어 오히려 AI를 못 찾습니다.

1단계 · Node.js 설치

모든 AI 도구의 공통 준비물입니다.

  1. nodejs.org 다운로드에서 LTS 버전을 설치합니다. Mac에서 Homebrew를 쓴다면 brew install node도 됩니다.
  2. 설치가 끝나면 cmd 프롬프트(Windows) 또는 터미널(Mac)을 새로 엽니다.

2단계 · 쓰고 싶은 AI 하나를 설치

cmd 프롬프트(Windows)나 터미널(Mac)에 아래 한 줄을 복사해 붙여 넣고 엔터를 누릅니다. 설치가 끝나면 그 도구를 한 번 실행해 로그인합니다. 해당 회사의 본인 구독·계정으로 로그인하는 것입니다.

AI 도구설치 명령설치 후
Claude Code (Anthropic)npm install -g @anthropic-ai/claude-codeclaude 실행 → 브라우저로 로그인. 안내 문서
Codex CLI (OpenAI)npm install -g @openai/codexcodex 실행 → 로그인
antigravity (Google)curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmdagy 실행 → 로그인
antigravity 설치 명령은 Windows(cmd) 기준입니다. Mac 설치 방법은 antigravity.google의 안내를 따르세요.
에러가 나면 에러 메시지 전체를 복사해서 평소 웹에서 쓰는 AI(Claude·ChatGPT 등)에 붙여 넣으세요. 대부분 그 답대로 따라하면 해결됩니다.

3단계 · 설치 확인

앱은 로그인 셸의 PATH에서 AI 도구를 찾습니다. 아래 명령이 경로를 출력하면 정상입니다.

# Windows (cmd)
where claude

# macOS (앱과 같은 방식으로, 로그인 셸 기준)
$SHELL -lc 'command -v claude'

4단계 · 마이 AI에서 선택

  1. flyocto 왼쪽 메뉴의 「마이 AI」로 갑니다.
  2. 「+」를 눌러 방을 하나 만듭니다.
  3. 방 최상단의 AI 칸을 누르면 방금 설치한 AI가 선택 가능한 상태로 보입니다. 고르면 끝입니다.
  4. "안녕?" 하고 인사해 보세요. 답이 오면 연결된 것입니다.

폰·노트북에서 PC의 AI 쓰기

폰에는 AI를 설치하지 않아도 됩니다. PC 한 대에 flyocto와 AI를 준비해 두면, 폰의 flyocto는 그 PC의 AI와 동기화되어 사용합니다. 밖에서 폰이나 노트북으로 봐도 그 PC의 대화와 작업을 그대로 이어서 보고·지시하고·승인할 수 있습니다.

  1. 폰에서 「AI 호스트 고르기」를 엽니다.
  2. 「내 다른 기기」를 누르면 지금 켜져 있는 내 PC가 보입니다.
  3. 그 PC를 선택하고 「적용」을 누릅니다.
호스트 PC 쪽 조건그 PC가 켜져 있고 온라인이어야 합니다. 노트북이 켜 있어도 PC를 대신하지 않습니다. 클라우드는 PC 한 대이니 PC를 켜 두세요.

Genspark 연결하기

Genspark는 flyocto에 기본으로 들어 있지 않습니다. 내 AI에게 시켜서 내 Genspark 계정으로 직접 붙이는 방식입니다. 한 번 붙이면 방에서 AI에게 "Genspark로 조사해 줘"처럼 시킬 수 있습니다.

  1. 방에서 AI에게 "Genspark 연결해 줘"라고 말합니다.
  2. AI가 호스트 PC에 Genspark 공식 CLI(@genspark/cli, 명령 이름 gsk)를 설치하고(npm install -g @genspark/cli), gsk login으로 로그인 링크를 만들어 대화창에 줍니다.
  3. 그 링크를 열어 내 Genspark 계정으로 승인합니다. 링크는 약 10분 안에 승인해야 합니다.
  4. 이제 "Genspark로 조사해 줘"처럼 시키면 됩니다.
알아 둘 것
  • 크레딧은 링크에서 승인한 본인 Genspark 계정에서 나갑니다. 무료 계정은 100크레딧입니다. 기능마다 크레딧이 얼마나 드는지는 아직 재 보지 않았습니다.
  • 메일·전화·문자 보내기, SNS 게시처럼 밖으로 나가는 기능은 AI가 먼저 묻고 승인을 받은 뒤에 씁니다.
  • 호스트 PC에 Node.js가 있어야 합니다(위 1단계). Node.js가 없는 PC에서는 아직 확인하지 않았습니다.
  • 여러 사람이 함께 쓰는 호스트에서는 Genspark 연결이 호스트 PC에 하나뿐이라, 호스트 주인 계정의 크레딧이 쓰입니다. 멤버마다 따로 연결하게 할지는 아직 정해지지 않았습니다(미결정).

설치했는데 인식이 안 될 때

가장 흔한 문제입니다. 터미널에서는 되는데 앱이 못 찾는 경우로, 거의 항상 PATH 때문입니다.

Windows

설치 후 flyocto 앱을 완전히 종료했다가 다시 실행하면 새 PATH가 반영됩니다. 그래도 안 되면 where claude가 출력한 경로를 아래 「사용자 정의 엔진」에 절대경로로 넣으세요.

macOS

GUI 앱은 터미널과 다른 PATH로 시작합니다. flyocto는 로그인 셸 PATH와 흔한 설치 경로(/opt/homebrew/bin, /usr/local/bin, ~/.local/bin, ~/.npm-global/bin)를 자동으로 보강하지만, nvm 같은 버전 관리자로 설치해 PATH가 ~/.zshrc에만 있으면 못 찾을 수 있습니다. 해결책 둘 중 하나를 고르세요.

"illegal hardware instruction" (Apple Silicon)

claude 실행 시 zsh: illegal hardware instruction이 뜨면 CPU 아키텍처가 맞지 않는 바이너리가 깔린 것입니다. 재설치로 해결됩니다.

npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code
claude

그래도 반복되면 node -p process.arch 결과가 arm64인지 확인하세요. x64라면 arm64용 Node.js로 다시 설치합니다.

사용자 정의 엔진 (절대경로·로컬 LLM)

PATH 문제를 우회하는 가장 확실한 방법이자, 로컬 LLM이나 내 네트워크 안 GPU 서버의 LLM을 붙이는 방법입니다. AI 선택에서 「사용자 정의」를 고르고 실행 명령을 절대경로로 넣습니다. 프롬프트는 표준입력(stdin)으로 전달됩니다.

# 예: nvm으로 설치한 Claude Code를 절대경로로 지정 (경로는 command -v claude 로 확인)
/Users/<나>/.nvm/versions/node/v22.3.0/bin/claude -p --output-format stream-json --verbose --dangerously-skip-permissions

다음 단계