⚙️ AI 설정

마지막 수정 2026-09-12

flyocto보다 AI를 먼저 준비하세요.

유료 AI 플랜 가입 → 해당 CLI 설치·로그인 → flyocto 설치·AI 선택

개인 사용자는 ChatGPT Plus 또는 Claude Pro부터 시작하는 것을 권장합니다. 작업이 길거나 사용량이 많으면 ChatGPT Pro 또는 Claude Max 5x를 고려하세요. 둘 중 하나만 준비해도 시작할 수 있습니다.

별도 API 키는 필요하지 않습니다. 플랜별 사용 한도와 추가 크레딧 정책은 각 제공업체 기준을 따릅니다. 공식 안내: OpenAI Codex 플랜 · Anthropic Claude Code 플랜

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

이 페이지에서AI 엔진은 내 구독 그대로 설치 전 확인 1단계 · Node.js 설치 2단계 · 쓰고 싶은 AI 하나를 설치 3단계 · 설치 확인 4단계 · 마이 AI에서 선택 폰·노트북에서 PC의 AI 쓰기 설치했는데 인식이 안 될 때 사용자 정의 엔진 (절대경로·로컬 LLM)다음 단계

AI 엔진은 내 구독 그대로

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

쓰던 정액제 구독(Claude·ChatGPT·Gemini)을 그대로 씁니다. 호출한 만큼 돈이 나가는 API 요금제가 필요 없습니다.
직접 돌리는 로컬 LLM도 사용자 정의 엔진으로 등록해 쓸 수 있습니다.
이 컴퓨터뿐 아니라 내 네트워크 안 다른 컴퓨터(예: GPU 서버)에서 돌아가는 LLM도 네트워크 주소로 연결하면 됩니다. 밖에서는 보이지 않는 나만의 AI 서버가 됩니다.

설치 전 확인

순서 ① 유료 AI 플랜 가입 → ② 해당 CLI 설치·로그인 → ③ flyocto 설치 후 마이 AI에서 선택. flyocto를 먼저 설치해도 되지만, AI 도구가 준비되지 않으면 마이 AI에서 선택할 엔진이 보이지 않습니다.

반드시 PC나 Mac에서 아래 설치는 PC나 Mac에서만 됩니다. 모바일 기기에서는 실행되지 않습니다.

flyocto 앱을 실행하는 바로 그 사용자 계정으로 설치·로그인하세요. 앱은 그 사용자의 AI 도구를 실행합니다.
macOS에서 앱을 sudo(관리자)로 실행하지 마세요. 신원과 경로가 root 것이 되어 오히려 AI를 못 찾습니다.

1단계 · Node.js 설치

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

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

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

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

AI 도구	설치 명령	설치 후
Claude Code (Anthropic)	`npm install -g @anthropic-ai/claude-code`	`claude` 실행 → 브라우저로 로그인. 안내 문서
Codex CLI (OpenAI)	`npm install -g @openai/codex`	`codex` 실행 → 로그인
Gemini CLI (Google)	`npm install -g @google/gemini-cli`	`gemini` 실행 → 로그인

에러가 나면 에러 메시지 전체를 복사해서 평소 웹에서 쓰는 AI(Claude·ChatGPT·Gemini)에 붙여 넣으세요. 대부분 그 답대로 따라하면 해결됩니다.

3단계 · 설치 확인

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

# Windows (PowerShell)
where claude

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

4단계 · 마이 AI에서 선택

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

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

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

폰에서 「AI 호스트 고르기」를 엽니다.
「내 다른 기기」를 누르면 지금 켜져 있는 내 PC가 보입니다.
그 PC를 선택하고 「적용」을 누릅니다.

호스트 PC 쪽 조건그 PC가 켜져 있고 온라인이어야 합니다. 노트북이 켜 있어도 PC를 대신하지 않습니다. 클라우드는 PC 한 대이니 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에만 있으면 못 찾을 수 있습니다. 해결책 둘 중 하나를 고르세요.

표준 위치로 링크 걸기(가장 간단): sudo ln -sf "$(command -v claude)" /usr/local/bin/claude
앱에 절대경로로 지정: command -v claude 결과를 「사용자 정의 엔진」에 넣습니다.

"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

다음 단계

AI로 무엇을 할 수 있는지 → 마이 AI
대화를 문서로 남기려면 → 마이 프로젝트 · 협업
AI가 답을 안 하면 → 자주 묻는 질문