SETTINGS · 에이전트

에이전트 백엔드와 모델

지원되는 에이전트 CLI를 설치하고 로그인한 뒤, 9Miho 서버에서 백엔드와 모델의 사용 가능 상태를 확인합니다.

에이전트 설정이 연결하는 것

에이전트 영역에서는 다음 Agent 턴에 사용할 백엔드와 모델을 선택합니다. 9Miho는 서버에 어떤 백엔드가 설치되어 있고 로그인되었는지 물어본 뒤, 서버가 보내 준 상태와 해결 방법을 그대로 보여 줍니다.

이 설정은 프로바이더와 별개입니다. 에이전트는 현재 제작 맥락을 읽고 작업을 함께 설계하거나 저작을 돕습니다. 프로바이더 프로필은 이미지·영상·오디오 생성을 실행할 권한을 제공합니다. ChatGPT나 Claude를 연결해도 생성 API 비용을 쓸 권한이 생기지는 않습니다.

현재 등록된 백엔드 계열은 Claude, ChatGPT(Codex CLI), OpenCode, Cursor, Ollama입니다. 실제 목록은 실행 중인 서버의 Agent 화면을 기준으로 봅니다.

이 페이지는 9Miho가 애플리케이션 안에서 실행하는 Agent를 설명합니다. 반대로 Claude Code나 Codex에서 시작해 실행 중인 9Miho를 다루려면 Claude·Codex MCP 연동을 보세요. 두 방식은 같은 제작 계약을 사용하지만 연결 설정은 서로 다릅니다.

서버가 실행되는 곳에 설치합니다

아래 명령은 9Miho 서버와 같은 컴퓨터, 같은 운영체제 계정에서 실행하세요. 브라우저가 원격 서버에 연결되어 있다면 지금 보고 있는 컴퓨터에 CLI를 설치해도 서버에서는 사용할 수 없습니다.

Codex CLI를 통한 ChatGPT

# macOS
brew install codex
# 또는 macOS / Linux / Windows 공통
npm install -g @openai/codex

codex login

Windows에서는 codex login을 실행한 계정과 같은 Windows 계정의 PowerShell에서 9Miho를 실행하세요.

Claude

npm install -g @anthropic-ai/claude-code
claude
# Claude Code 안에서 /login 실행

Windows에서는 먼저 로그인한 뒤 9Miho 서버를 재시작하는 편이 안전합니다. 이미 실행 중이던 서버 프로세스는 사용자 범위 OAuth 환경을 보지 못할 수 있습니다.

OpenCode

npm install -g opencode-ai
opencode providers login
# 또는 opencode 실행

Cursor

Cursor 공식 CLI 설치 안내에 따라 설치합니다. Settings에 운영체제별 한 줄 설치 명령이 보일 수 있지만, 네트워크에서 받은 스크립트를 실행하기 전 현재 공식 문서의 명령과 일치하는지 확인하세요. 설치 후에는 실행 파일과 로그인 상태를 확인합니다.

agent --version
agent login

인증 방식은 Cursor의 CLI 인증 문서에서도 확인할 수 있습니다.

Ollama

ollama.com/download에서 Ollama를 설치한 뒤 모델을 받습니다.

ollama pull qwen3-coder

Ollama는 9Miho 서버가 실행되는 곳에서 계속 켜져 있어야 합니다. 설정에 보이는 모델 목록은 서버 백엔드가 보고한 값입니다.

백엔드와 모델 선택

  1. Settings → 에이전트를 엽니다.
  2. 백엔드를 선택합니다.
  3. 사용 가능 상태와 인증 안내를 읽습니다.
  4. 필요하면 운영체제 탭에 나온 설치·로그인 명령을 터미널에서 실행합니다.
  5. Connect 또는 Reconnect를 누릅니다. 두 버튼 모두 /api/agent/backends를 다시 읽을 뿐, 로그인 자체는 터미널에서 진행됩니다.
  6. 해당 백엔드가 보고한 모델 중 하나를 고릅니다.

선택값은 이 브라우저에 저장되어 다음 턴부터 적용됩니다. 다른 브라우저나 다른 서버 설치판으로 자동 복사되지는 않습니다.

프롬프트 보조

프롬프트 보조를 켜면 지원되는 Storyteller·생성 화면에서 선택한 에이전트가 저작을 도울 수 있습니다. 그렇다고 에이전트가 Canon을 승인하거나, 유료 Run을 허가하거나, 검증을 건너뛸 수 있는 것은 아닙니다. 에이전트 제안은 창작자가 검토하는 입력으로 남습니다.

Canvas의 Agent 패널과 Assistant node도 구분해야 합니다. 패널은 Flow를 함께 만들고 살피는 화면이고, Assistant node는 그래프 안에서 실행되는 노드입니다. Canvas 개요와 Direction과 모델 Dialect에서 차이를 확인할 수 있습니다.

계속 사용할 수 없다고 나올 때

  • 서버 계정의 새 터미널에서 CLI가 실제로 실행되는지 확인합니다.
  • 실행 파일이 그 계정의 PATH에 있는지 확인합니다.
  • 각 백엔드의 공식 로그인 흐름을 마칩니다. 로그인 토큰을 Canvas에 붙여넣지 마세요.
  • 로그인으로 사용자 범위 환경이 바뀌었다면 9Miho 서버를 재시작합니다.
  • Connect 또는 Reconnect를 다시 누르고 새로 표시된 서버 안내를 읽습니다.