> ## Documentation Index
> Fetch the complete documentation index at: https://doc.howen.ink/llms.txt
> Use this file to discover all available pages before exploring further.

# 日本語文章解析

> 일본어 문장을 단어 하나하나 이해하세요. 일본어를 입력하거나 붙여넣으면 단어 분리, 후리가나, 품사, 뜻과 문장 전체 번역을 볼 수 있습니다.

일본어 문장 분석(日本語文章解析)은 AI 기반 일본어 문장 분석 웹 앱입니다. 일본어 문장을 입력하거나 붙여넣으면 단어마다 가나 읽기, 로마자, 품사를 표시하고 아래에 문장 전체 번역을 보여 줍니다. 아무 단어나 누르면 이 문장에서의 뜻, 용법, 활용과 예문을 볼 수 있습니다.

<Info>
  먼저 체험해 보고 싶다면 [온라인 데모](https://nihongodemo.howen.ink/)를 여세요. 배포하지 않고 바로 분석을 시작할 수 있습니다.
</Info>

![분석 결과와 사전식 뜻풀이](https://raw.githubusercontent.com/cokice/japanese-analyzer/master/docs/images/app-home.png)

## 기능 한눈에 보기

### 문장 읽기

<CardGroup cols={3}>
  <Card title="문장 분석" icon="spell-check" href="/ko/features/analysis">
    단어마다 가나 읽기, 로마자, 품사를 표시하고 문장 전체 번역을 자동으로 생성합니다.
  </Card>

  <Card title="단어 상세 설명" icon="book-open" href="/ko/features/word-detail">
    단어를 누르면 이 문장에서의 뜻, 기본형, 활용과 예문을 볼 수 있습니다.
  </Card>

  <Card title="여러 단어 선택" icon="highlighter" href="/ko/features/word-detail#여러-단어-선택">
    문형과 관용 표현을 하나로 묶어 설명합니다. 잘못 나뉜 단어는 한 번에 합칠 수 있습니다.
  </Card>
</CardGroup>

### 더 편리하게

<CardGroup cols={2}>
  <Card title="오늘의 문장과 최근 기록" icon="calendar-days" href="/ko/features/daily-sentence">
    홈 화면에 매일 한 문장을 보여 주며 일본 시간 기준으로 바뀝니다. 최근 분석 기록은 브라우저에 저장됩니다.
  </Card>

  <Card title="이미지 인식" icon="image" href="/ko/features/image-recognition">
    스크린샷을 업로드하거나 바로 붙여넣어 일본어 글자를 추출합니다.
  </Card>

  <Card title="원문 듣기" icon="volume-high" href="/ko/features/text-to-speech">
    Edge TTS 또는 Gemini TTS로 읽어 주며 속도와 목소리를 조절할 수 있습니다.
  </Card>

  <Card title="AI 일본어 도우미" icon="comments" href="/ko/features/ai-assistant">
    현재 문장을 바탕으로 문법, 어휘, 학습 관련 질문을 이어서 할 수 있습니다.
  </Card>
</CardGroup>

### 화면

* 简体中文, 繁體中文, English, 한국어를 지원합니다. 화면, 번역, 뜻풀이가 함께 바뀝니다.
* 라이트, 다크, 시스템 설정 따르기의 세 가지 테마를 지원합니다. 데스크톱과 휴대폰에서 모두 사용할 수 있습니다.
* 긴 글은 자동으로 나누어 분석합니다. 웹 페이지나 Markdown을 붙여넣으면 서식과 링크를 자동으로 제거합니다.

<Columns cols={2}>
  <Frame caption="다크 모드">
    <img src="https://raw.githubusercontent.com/cokice/japanese-analyzer/master/docs/images/app-dark.png" alt="다크 모드의 분석 화면" />
  </Frame>

  <Frame caption="휴대폰의 AI 일본어 도우미">
    <img src="https://raw.githubusercontent.com/cokice/japanese-analyzer/master/docs/images/mobile-chat.png" alt="휴대폰의 AI 일본어 도우미" />
  </Frame>
</Columns>

## 모델

| 용도                  | 기본값                       | 선택 가능                                                     |
| ------------------- | ------------------------- | --------------------------------------------------------- |
| 분석, 번역, 뜻풀이, AI 도우미 | DeepSeek `deepseek-flash` | Gemini `gemini-flash-latest` / `gemini-flash-lite-latest` |
| 이미지 인식              | 선택한 텍스트 모델과 동일            | —                                                         |
| 음성 읽기               | Edge TTS                  | Gemini TTS(Gemini API 키 필요)                               |

서버에 설정한 API 키는 모든 방문자가 함께 사용합니다. 사용자는 **설정**에서 자신의 키를 입력할 수도 있습니다. 이 키는 사용자의 브라우저에 저장되며, 요청 시 앱 서버를 거쳐 모델 제공업체로 전달됩니다. 자세한 내용은 [API 키와 개인정보](/ko/privacy)를 참고하세요.

## 기술 스택

* Next.js 15(App Router)와 React 19
* Tailwind CSS
* OpenAI 호환 API로 DeepSeek와 Gemini 호출
* 라이선스: [AGPL-3.0-only](/ko/license)

## 다음 단계

<Columns cols={2}>
  <Card title="빠른 시작" icon="rocket" href="/ko/quickstart">
    로컬에 의존성을 설치하고 몇 분 안에 앱을 실행합니다.
  </Card>

  <Card title="배포" icon="server" href="/ko/deployment">
    Vercel에 배포하거나 Docker로 자신의 서버에서 실행합니다.
  </Card>

  <Card title="AI 에이전트로 배포" icon="robot" href="/ko/ai-deploy">
    한 문장만 전달하면 Claude Code, Codex 같은 AI 코딩 도우미가 배포를 마칩니다.
  </Card>

  <Card title="구성" icon="sliders" href="/ko/configuration">
    각 환경 변수, 모델, 접속 비밀번호를 알아봅니다.
  </Card>
</Columns>
