AI 엔진 설치 안내

쏙은 글을 짓고 판단하는 일을 내 PC 에 설치한 AI 에게 맡깁니다. 그래야 만드는 내용이 밖으로 나가지 않고, 쏙이 따로 이용료를 받지 않아도 됩니다. 아래 넷 중 하나만 설치하시면 됩니다.

하나만 고르세요. 넷을 다 깔 필요가 없습니다. 쏙은 한 번에 하나만 씁니다. 이미 쓰고 계신 구독이 있다면 그것을 고르는 것이 가장 좋습니다 — 넷 모두 각자의 유료 구독이 있어야 동작합니다.

어떤 것을 고를까요

쓰고 계신 구독으로 고르시면 됩니다. 정하기 어려우시면 Claude 를 권합니다.

엔진	필요한 구독	사진 읽기	이런 분께
Claude CLI기본	Claude	됩니다	처음이시라면 이것부터
Codex CLI	ChatGPT	됩니다	ChatGPT 를 쓰고 계신 분Node.js 를 함께 깔아야 합니다 →
Grok CLI	xAI (Grok)	됩니다	그림·영상까지 같은 구독으로 쓰고 싶은 분
Antigravity CLI	Google	안 됩니다	구글 계정을 쓰고 계신 분

사진 읽기는 쏙이 만든 그림을 직접 보고 판단하는 기능입니다 — 자막을 어디에 놓을지 고르거나, 가수 설정을 사진에 맞추는 일에 쓰입니다. Antigravity 를 고르시면 그 기능들은 건너뜁니다. 나머지는 모두 정상 동작합니다.

설치하기

윈도우 명령은 PowerShell 에 붙여넣고 Enter 를 누르시면 됩니다. (시작 단추 오른쪽 클릭 → 터미널 또는 Windows PowerShell)

Claude CLI

claude

Anthropic 의 Claude. 쏙이 기본으로 쓰는 엔진이고, 그림도 읽습니다.

설치

Windows · PowerShell

irm https://claude.ai/install.ps1 | iex

macOS · Linux

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

설치 끝에 “…\.local\bin is not in your PATH” 라는 줄이 뜨면, 깔리기는 했는데 윈도우가 그 자리를 못 찾는 상태입니다. 아래 한 줄을 넣고 PowerShell 을 껐다 다시 여세요.

[Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path','User') + ';' + "$env:USERPROFILE\.local\bin", 'User')

로그인

터미널을 새로 열고 아래를 칩니다. 브라우저가 열리면 Claude 계정으로 로그인하세요.

claude

확인

claude --version

번호가 나오면 설치된 것입니다.

Codex CLI

codexNode.js 필요

OpenAI 의 Codex. 쓰고 계신 ChatGPT 구독으로 그대로 돌아갑니다.

1 · Node.js

넷 중 이것만 Node.js 가 필요합니다. 이미 깔려 있는지부터 보세요 — 아래를 쳤을 때 v20 이상의 번호가 나오면 넘어가셔도 됩니다.

node --version

없거나 번호가 낮으면, 둘 중 편한 방법으로 설치하세요.

방법 ㉮ · 명령 한 줄 (PowerShell)

winget install OpenJS.NodeJS.LTS

방법 ㉯ · 내려받아 설치

nodejs.org 에서 LTS 라고 적힌 단추를 눌러 받고, 실행해서 다음만 계속 누르시면 됩니다. 중간에 바꿀 것이 없습니다.

설치가 끝나면 PowerShell 을 껐다 다시 여세요. 열어 둔 창은 새로 깔린 것을 알아보지 못합니다. 다시 연 창에서 node --version 이 번호를 뱉으면 된 것입니다.

2 · 설치

Windows · macOS · Linux

npm install -g @openai/codex

3 · 로그인

codex login

브라우저가 열리면 ChatGPT 계정으로 로그인하세요.

확인

codex --version

Grok CLI

grok

xAI 의 Grok. 한 번 로그인해 두면 그림과 영상 생성까지 키 없이 같은 구독으로 돌아갑니다 (설정의 이미지·영상 항목에서 Grok 을 고르시면 됩니다).

설치

Windows · PowerShell

irm https://x.ai/cli/install.ps1 | iex

macOS · Linux

curl -fsSL https://x.ai/cli/install.sh | bash

로그인

grok login

쏙에서 설정 → AI 엔진 → Grok CLI → 터미널에서 로그인 을 누르셔도 같은 창이 열립니다.

확인

grok --version

Antigravity CLI

agy

구글의 Antigravity (Gemini CLI 의 뒤를 이은 것입니다). 실행 파일 이름이 agy 라는 점만 다르고 쓰는 법은 같습니다.

설치

Windows · PowerShell

irm https://antigravity.google/cli/install.ps1 | iex

macOS · Linux

curl -fsSL https://antigravity.google/cli/install.sh | bash

로그인

이것만 손이 조금 더 갑니다. 쏙에서 설정 → AI 엔진 → Antigravity CLI → 터미널에서 로그인 을 누르면 검은 창이 열립니다.

창에 뜬 주소를 복사해 브라우저에 붙여넣고 구글 계정으로 로그인
화면에 나온 코드를 복사
검은 창에 붙여넣고 Enter

기다리는 시간이 60초입니다. 넘기면 창에 agy 를 다시 치고 처음부터 하시면 됩니다.

확인

agy --version

쏙에서 고르기

설치와 로그인을 마치셨으면, 쏙에게 어느 것을 쓸지 알려 주면 끝입니다.

설정 → AI 엔진 에서 설치한 엔진의 스위치를 켭니다. 하나만 켜집니다.
그 아래 명령어와 인자 칸은 처음부터 맞게 들어 있습니다 — 그대로 두세요. 혹시 지워졌다면 아래 값으로 되돌리시면 됩니다.

엔진	명령어	인자
Claude CLI	`claude`	`-p`
Codex CLI	`codex`	`exec`
Grok CLI	`grok`	`-p {prompt}`
Antigravity CLI	`agy`	`-p {prompt}`

잘 안 될 때

대부분 아래 셋 중 하나입니다.

증상

“명령어를 찾을 수 없습니다”

해결

설치한 뒤에 연 터미널이라야 새 명령을 알아봅니다. 터미널과 쏙을 모두 껐다 켜 보세요. 그래도 안 되면 PC 를 한 번 재시작하시면 확실합니다.

증상

어제까지 잘 되다가 갑자기 응답이 없습니다

해결

로그인이 풀린 것입니다. 쏙이 대신 로그인해 드릴 수는 없습니다 — 터미널에서 그 엔진의 로그인을 한 번 더 해 주세요 (claude · codex login · grok login · agy).

증상

자막 자리나 가수 설정을 알아서 못 맞춥니다

해결

Antigravity 를 쓰고 계실 겁니다. 그 엔진은 그림 파일을 열지 못해 사진을 보고 판단하는 기능이 건너뛰어집니다. 그 기능이 필요하시면 Claude · Codex · Grok 중 하나로 바꾸세요.

설치 명령은 각 회사의 공식 주소입니다 — 쏙이 따로 배포하는 것이 아닙니다.
그래도 막히시면 화면을 캡처해 help@ssokon.com 으로 보내 주세요.