⚙️ AI 설정
AI는 항상 켜 놓는 컴퓨터 한 대에만 설치하면 됩니다. 집이나 회사 PC 한 대에 AI를 설치하면, 내가 로그인한 모든 기기가 그 컴퓨터에 연결해서 AI를 씁니다. 폰에는 아무것도 설치하지 않습니다.
AI 엔진은 내 구독 그대로
flyocto는 AI 엔진을 제공하지 않습니다. 지금 쓰고 있는 AI 엔진(Claude, Codex, 로컬 LLM 등)을 직접 연결해서 씁니다.
- 쓰던 정액제 구독(Claude·ChatGPT·antigravity)을 그대로 씁니다. 호출한 만큼 돈이 나가는 API 요금제가 필요 없습니다.
- 직접 돌리는 로컬 LLM도 사용자 정의 엔진으로 등록해 쓸 수 있습니다.
- 이 컴퓨터뿐 아니라 내 네트워크 안 다른 컴퓨터(예: GPU 서버)에서 돌아가는 LLM도 네트워크 주소로 연결하면 됩니다. 밖에서는 보이지 않는 나만의 AI 서버가 됩니다.
설치 전 확인
- flyocto 앱을 실행하는 바로 그 사용자 계정으로 설치·로그인하세요. 앱은 그 사용자의 AI 도구를 실행합니다.
- macOS에서 앱을 sudo(관리자)로 실행하지 마세요. 신원과 경로가 root 것이 되어 오히려 AI를 못 찾습니다.
1단계 · Node.js 설치
모든 AI 도구의 공통 준비물입니다.
- nodejs.org 다운로드에서 LTS 버전을 설치합니다. Mac에서 Homebrew를 쓴다면
brew install node도 됩니다. - 설치가 끝나면 cmd 프롬프트(Windows) 또는 터미널(Mac)을 새로 엽니다.
2단계 · 쓰고 싶은 AI 하나를 설치
cmd 프롬프트(Windows)나 터미널(Mac)에 아래 한 줄을 복사해 붙여 넣고 엔터를 누릅니다. 설치가 끝나면 그 도구를 한 번 실행해 로그인합니다. 해당 회사의 본인 구독·계정으로 로그인하는 것입니다.
| AI 도구 | 설치 명령 | 설치 후 |
|---|---|---|
| Claude Code (Anthropic) | npm install -g @anthropic-ai/claude-code | claude 실행 → 브라우저로 로그인. 안내 문서 |
| Codex CLI (OpenAI) | npm install -g @openai/codex | codex 실행 → 로그인 |
| antigravity (Google) | curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd | agy 실행 → 로그인 |
3단계 · 설치 확인
앱은 로그인 셸의 PATH에서 AI 도구를 찾습니다. 아래 명령이 경로를 출력하면 정상입니다.
# Windows (cmd)
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를 선택하고 「적용」을 누릅니다.
Genspark 연결하기
Genspark는 flyocto에 기본으로 들어 있지 않습니다. 내 AI에게 시켜서 내 Genspark 계정으로 직접 붙이는 방식입니다. 한 번 붙이면 방에서 AI에게 "Genspark로 조사해 줘"처럼 시킬 수 있습니다.
- 방에서 AI에게 "Genspark 연결해 줘"라고 말합니다.
- AI가 호스트 PC에 Genspark 공식 CLI(
@genspark/cli, 명령 이름gsk)를 설치하고(npm install -g @genspark/cli),gsk login으로 로그인 링크를 만들어 대화창에 줍니다. - 그 링크를 열어 내 Genspark 계정으로 승인합니다. 링크는 약 10분 안에 승인해야 합니다.
- 이제 "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에만 있으면 못 찾을 수 있습니다. 해결책 둘 중 하나를 고르세요.
- 표준 위치로 링크 걸기(가장 간단):
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가 답을 안 하면 → 자주 묻는 질문