AI CLI 설치 가이드

AI 댓글 기능에 필요한 AI CLI 도구 설치 방법을 안내합니다.

빠른 시작

대부분의 사용자는 Claude Code를 설치하세요 - 설정이 가장 쉽고 팩트체크와 용어집 기능에 필요한 웹 검색 기능이 포함되어 있습니다.

지원되는 AI CLI 도구

도구	제공업체	최적 용도	웹 검색
Claude Code	Anthropic	일반 분석, 리서치	지원
Gemini CLI	Google	빠른 응답	미지원
Codex	OpenAI	코드 관련 콘텐츠	지원

Claude Code (권장)

Claude Code는 웹 검색 기능이 내장된 Anthropic의 공식 CLI 도구입니다.

• 공식 페이지: claude.com/product/claude-code
• 문서: code.claude.com/docs

macOS / Linux

# 공식 스크립트로 설치
curl -fsSL https://claude.ai/install.sh | bash

설치 후:

1. 새 터미널 창 열기
2. claude 실행하여 인증 시작
3. Anthropic 계정으로 로그인

설치 확인:

claude --version

Windows

PowerShell을 열고 실행:

# 공식 스크립트로 설치
irm https://claude.ai/install.ps1 | iex

설치 후:

1. PowerShell 재시작
2. claude 실행하여 인증 시작
3. Anthropic 계정으로 로그인

설치 확인:

claude --version

대체 설치 방법

• npm: npm install -g @anthropic-ai/claude-code (Node.js 18+ 필요)
• WSL: WSL 내에서 Linux 설치 방법 사용

자세한 설명은 공식 문서를 참조하세요.

문제 해결

설치 후 claude 명령어를 찾을 수 없는 경우:

1. 터미널/PowerShell 재시작
2. 설치 경로가 PATH 환경 변수에 있는지 확인
3. 시스템 요구사항은 공식 문서 참조

---

Gemini CLI

빠른 AI 응답을 위한 Google의 Gemini CLI입니다.

• 저장소: github.com/google-gemini/gemini-cli

macOS / Linux

# npm으로 설치 (Node.js 18+ 필요)
npm install -g @google/gemini-cli

# 또는 Homebrew로 설치
brew install gemini-cli

인증:

gemini auth

설치 확인:

gemini --version

Windows

# npm으로 설치 (Node.js 18+ 필요)
npm install -g @google/gemini-cli

인증:

gemini auth

설치 확인:

gemini --version

---

Codex (OpenAI)

기술 콘텐츠에 특히 좋은 OpenAI의 Codex CLI입니다.

• 저장소: github.com/openai/codex

macOS / Linux

# npm으로 설치 (Node.js 18+ 필요)
npm install -g @openai/codex

# OpenAI API 키 설정
export OPENAI_API_KEY="your-api-key"

설치 확인:

codex --version

Windows

# npm으로 설치 (Node.js 18+ 필요)
npm install -g @openai/codex

# OpenAI API 키 설정 (영구)
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "your-api-key", "User")

# 환경 변수 설정 후 PowerShell 재시작

설치 확인:

codex --version

---

Social Archiver에서 설정 확인

최소 하나의 AI CLI 도구 설치 후:

1. Obsidian 재시작 - 새로 설치된 CLI 도구 감지에 필요
2. 타임라인 뷰 열기 - 아카이브된 포스트로 이동
3. AI 댓글 배너 확인 - 아카이브된 포스트 아래에 표시되어야 함
4. 설정 확인 - 설정 > Social Archiver > AI Comments에서 기본값 구성

감지 문제

AI 댓글 배너가 나타나지 않는 경우:

• version 명령어로 CLI 설치 확인
• CLI 인증 확인
• CLI가 시스템 PATH에 있는지 확인
• Obsidian 완전 재시작 (리로드만으로는 안 됨)

다음 단계

AI CLI 설정이 완료되면 AI 댓글 사용법을 알아보세요:

AI 댓글 가이드 - 댓글 유형, 설정, 모범 사례를 알아보세요.