기계 튀르크에 오신 것을 환영합니다. 저는 LLM으로 버튼 그리드를 생성합니다. 명령을 입력하거나 버튼을 눌러주세요. 대화하며 원하는 기능을 찾아드립니다. 지금 바로 시작해보세요!

현대식 자판기 안에 사람이 숨어 기계를 대신한다 — AI Turk도 같은 원리입니다. 자판기 버튼은 LLM이 생성한 버튼 그리드, 안에 숨은 사람은 백엔드 LLM 에이전트입니다.

18세기 체스 기계 "터키인"에도 안에 사람이 숨어 있었습니다. AI Turk는 이 원리를 현대에 재해석 — 기계 안에 LLM이 숨어 버튼 그리드를 생성합니다.

계산기라고 입력해보세요. LLM이 계산기인척 전자계산기를 시뮬레이션합니다.

AI Turk는 코딩 에이전트 전용 인터페이스입니다. 백엔드를 추상화하여 pi(pi --mode rpc) 와 Claude Code(claude -p stream-json) 양쪽을 지원합니다. 세션 컨텍스트 자동 관리, 도구 사용(bash, read, edit), 실시간 스트리밍을 지원합니다.

Claude Code 백엔드는 Anthropic API(순수 Claude) 또는 Ollama의 Anthropic 호환 엔드포인트(ollama launch claude --model <m> 동등) 양쪽으로 구동 가능 — .env 설정으로 선택.

pi 에이전트에게 /start 명령으로 시작하세요.

git clone https://github.com/sng2c/ai-turk.git
cd ai-turk
pi /start

에이전트가 의존성 설치, 서버 실행, 상태 확인을 자동으로 수행합니다.

git clone https://github.com/sng2c/ai-turk.git
cd ai-turk
npm install
turkctl start

접속: http://127.0.0.1:3000

여러 인스턴스를 띄우려면 --env로 .env 파일을 지정. 다중 인스턴스 참고.

.env의 TURK_BACKEND로 백엔드를 선택합니다. 기본은 pi.

전체 변수와 상세 설명은 .env.example 참고.

TURK_BACKEND=claude는 ANTHROPIC_BASE_URL이 가리키는 엔드포인트로 Anthropic Messages API 요청을 보냅니다. 두 구성을 지원합니다:

① 순수 Anthropic Claude (권장)

TURK_BACKEND=claude
TURK_CLAUDE_MODEL=claude-haiku-4-5    # claude-* 전체 이름
# ANTHROPIC_BASE_URL 비우면 기본 api.anthropic.com 사용

② Ollama Claude — Ollama 0.14+ 의 Anthropic 호환 엔드포인트 (ollama launch claude --model <m> 동등)

TURK_BACKEND=claude
TURK_CLAUDE_MODEL=glm-5.1:cloud    # Ollama에 pull 된 모델
ANTHROPIC_BASE_URL=http://localhost:11434
ANTHROPIC_AUTH_TOKEN=ollama         # 임의값 (비어두면 subscription 폴백)

필요 시 Ollama 준비: ollama serve + ollama pull glm-5.1:cloud.

전환 후 turkctl restart (또는 .env 변경 시 자동 재시작). 타이틀 옆에 백엔드 종류(pi/claude)가 작게 표시됩니다. 전체 변수는 .env.example 참고.

turkctl의 --env 옵션 또는 TURK_ENV_FILE 환경변수로 인스턴스별 .env 파일을 지정합니다. 포트 충돌을 피하려면 각 .env 파일의 TURK_PORT를 다르게 설정.

# 인스턴스별 .env 파일 생성
cp .env.example .env.8003   # TURK_PORT=8003 으로 수정
cp .env.example .env.8004   # TURK_PORT=8004 으로 수정

# 각 인스턴스 독립 구동/제어
#   방법 A: --env 플래그
turkctl --env .env.8003 start
turkctl --env .env.8003 status
turkctl --env .env.8003 stop

#   방법 B: TURK_ENV_FILE 환경변수
TURK_ENV_FILE=.env.8004 turkctl start
TURK_ENV_FILE=.env.8004 turkctl logs

--env / TURK_ENV_FILE 생략 시 기본 .env 사용 (포트 3000).

• 위키: AI Turk 프로젝트
• 위키: 기계 튀르크 아이디어
• GitHub 저장소 (branch: node-react)