> For the complete documentation index, see [llms.txt](https://g4iwnl.gitbook.io/carrot-wip-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://g4iwnl.gitbook.io/carrot-wip-guide/readme.md).

# 🥕 CarrotPilot 시작 가이드

**차량 연결부터 설정, 로그 분석까지. 이유를 이해하며 사용하는 carrot-wip 설명서.**

> **2026.10 에디션** · 원본 설명서 전체를 복제한 뒤 현재 코드와 사용자 문서를 기준으로 개편했습니다. 원본 CarrotPilot 사이트는 그대로 유지합니다.

### 처음이라면 이 순서로

| 순서 | 할 일               | 바로 가기                                                                                                                                                                                                  |
| -- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 01 | 내 차량·하네스·제어 방식 확인 | [차량 구성과 롱컨 이해하기](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/longcontrol/whylong)                                                                                            |
| 02 | 현재 설치 주소와 첫 실행 확인 | [설치와 첫 실행](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/basic-settings/carrotapp)                                                                                             |
| 03 | 휴대폰·PC에서 장치 열기    | [Carrot Web 사용법](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/basic-settings/fleet)                                                                                           |
| 04 | 설정을 저장하고 하나씩 이해하기 | [설정 지도](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/carrotman/basic) · [백업과 복원](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/basic-settings/backup) |
| 05 | 이상 동작을 기록하고 분석하기  | [로그 전송](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/basic-settings/log) · [문제 해결](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/basic-settings/faq)  |

### 이번 설명서에서 달라진 것

* **설치 주소**: 옛 tr16-e 예제 대신 현재 README의 `i.carrotpilot.app/carrot-wip`을 안내합니다.
* **설정 화면**: CarrotMan·CarrotLink 대신 **Carrot Web**을 사용합니다. 접속은 `http://장치-IP:7000`입니다.
* **실제 동작 중심**: 크루즈 버튼, 차간거리, 감속 소스와 레이더 모드를 구분합니다.
* **설정값의 의미**: 기본값과 현재 값, 배율과 적용 조건을 나눠 설명합니다.
* **진단까지 연결**: 화면녹화와 주행 로그의 차이, 업데이트·백업·지원 요청을 정리했습니다.

### CarrotPilot은 무엇인가요?

openpilot 기반의 독립적인 운전자 보조 소프트웨어입니다. 현대·기아·제네시스(HKG)를 중심으로 개발되며, comma.ai가 공식 검토·승인·지원하는 배포판은 아닙니다. 지원 장치는 C3, C3X, C4이며 차종·연식·ECU·하네스에 따라 가능한 기능이 달라집니다.

**carrot-wip은 rolling 개발 브랜치입니다.** 업데이트마다 동작이 달라질 수 있으므로 장기간 고정된 안정판처럼 취급하지 않습니다. 지원 여부는 같은 차명보다 정확한 하드웨어 구성이 중요합니다.

### 자주 찾는 기능

| 궁금한 점                   | 안내                                                                                                              |
| ----------------------- | --------------------------------------------------------------------------------------------------------------- |
| 버튼을 누르면 속도가 이상하게 바뀌어요   | [버튼·프리셋과 순정 SCC](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/many/buttonspamming)     |
| 앞차와 거리·출발감을 조절하고 싶어요    | [크루즈·차간거리](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/tuning/longcontrol)            |
| 커브·카메라에서 왜 감속하나요?       | [속도·감속](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/functions/routespeed)             |
| 차선변경 지연·조향감을 이해하고 싶어요   | [조향과 차로 변경](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/tuning/steering)              |
| 레이더에 점은 보이는데 앞차가 아니에요   | [레이더트랙·코너레이더](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/functions/radartrack)       |
| eGPU·Jetson 모델을 바꾸고 싶어요 | [Carrot Web의 모델 선택](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/basic-settings/fleet) |
| DM 경고나 카메라 문제가 있어요      | [운전자 감시](https://app.gitbook.com/o/p9xlvWtR4qCAEMt6RV4y/s/EVSbIxeAg2vVzS7SBbnL/functions/dm)                    |

### 읽기 전에 기억할 세 가지

1. **운전자가 계속 감독합니다.** 전방·주변 상황을 직접 확인하고 언제든 제어할 준비를 합니다. 웹 설정과 로그 조작은 정차 후에 합니다.
2. **내 장치의 현재 값부터 저장합니다.** 다른 차량의 튜닝이나 오래된 핀 배치를 그대로 적용하지 않습니다.
3. **확인된 것과 시험 중인 것을 구분합니다.** 코드에 기능이 있다는 사실만으로 모든 차량에서 검증됐다는 뜻은 아닙니다.

#### 문서 찾는 법

기존 설명서의 페이지 주소와 배선 자료를 유지해 예전 링크로도 찾아올 수 있습니다. 배선 페이지에는 과거 자료 표시와 현재 확인 절차를 추가했습니다. 각 페이지 아래의 고정 커밋 링크에서 이 설명서가 확인한 원문을 볼 수 있습니다.

***

#### 문서 기준

2026-10-30 확인 · `carrot-wip` · [`10bf0a56`](https://github.com/ajouatom/openpilot/commit/10bf0a56a263e5e6701b1ee7ff3a2374a2cd4e20).

[README.md](https://github.com/ajouatom/openpilot/blob/10bf0a56a263e5e6701b1ee7ff3a2374a2cd4e20/README.md) · [docs/user/README.md](https://github.com/ajouatom/openpilot/blob/10bf0a56a263e5e6701b1ee7ff3a2374a2cd4e20/docs/user/README.md) · [docs/user/ko/settings.md](https://github.com/ajouatom/openpilot/blob/10bf0a56a263e5e6701b1ee7ff3a2374a2cd4e20/docs/user/ko/settings.md)

개발 브랜치는 계속 변경됩니다. 내 장치의 브랜치·커밋·현재 설정을 함께 확인하세요.