1분 만에 시작: 설치 및 설정
학습 후 할 수 있는 것
- OpenCode에서 테이블 포맷터 플러그인 설치
- AI가 생성한 Markdown 테이블 자동 정렬
- 플러그인이 정상적으로 작동하는지 확인
현재 겪고 있는 문제
AI가 생성한 Markdown 테이블은 종종 다음과 같습니다:
| 名称 | 描述 | 状态 |
|--- | --- | ---|
| 功能A | 这是一个很长的描述文本 | 已完成 |
| B | 短 | 进行中 |열 너비가 고르지 않아 보기 불편합니다. 수동으로 조정하시겠습니까? 시간이 너무 많이 걸립니다.
언제 사용해야 할까요
- AI에게 테이블 생성을 자주 요청하는 경우 (비교, 목록, 구성 설명)
- OpenCode에서 테이블이 깔끔하게 표시되기를 원하는 경우
- 매번 열 너비를 수동으로 조정하고 싶지 않은 경우
🎒 시작 전 준비
전제 조건
- OpenCode가 설치되어 있어야 합니다 (버전 >= 1.0.137)
.opencode/opencode.jsonc구성 파일의 위치를 알고 있어야 합니다
따라해 보세요
1단계: 구성 파일 열기
이유: 플러그인은 구성 파일을 통해 선언되며, OpenCode 시작 시 자동으로 로드됩니다.
OpenCode 구성 파일을 찾으세요:
# 구성 파일은 보통 프로젝트 루트 디렉토리에 있습니다
ls -la .opencode/opencode.jsonc
# 또는 사용자 디렉토리에 있습니다
ls -la ~/.config/opencode/opencode.jsonc# 구성 파일은 보통 프로젝트 루트 디렉토리에 있습니다
Get-ChildItem .opencode\opencode.jsonc
# 또는 사용자 디렉토리에 있습니다
Get-ChildItem "$env:APPDATA\opencode\opencode.jsonc"좋아하는 편집기로 이 파일을 엽니다.
2단계: 플러그인 구성 추가
이유: OpenCode에 테이블 포맷터 플러그인을 로드하도록 지시합니다.
구성 파일에 plugin 필드를 추가하세요:
{
// ... 다른 구성 ...
"plugin": ["@franlol/[email protected]"]
}다른 플러그인이 이미 있나요?
이미 plugin 배열이 있다면, 새 플러그인을 배열에 추가하세요:
{
"plugin": [
"existing-plugin",
"@franlol/[email protected]" // 여기에 추가
]
}확인해야 할 것: 구성 파일이 성공적으로 저장되었고, 구문 오류 메시지가 없습니다.
3단계: OpenCode 재시작
이유: 플러그인은 OpenCode 시작 시 로드되므로, 구성을 수정한 후 재시작해야 적용됩니다.
현재 OpenCode 세션을 닫고 다시 시작하세요.
확인해야 할 것: OpenCode가 정상적으로 시작되고 오류가 없습니다.
4단계: 플러그인 작동 확인
이유: 플러그인이 올바르게 로드되고 작동하는지 확인합니다.
AI에게 테이블을 생성하도록 요청하세요. 예를 들어 다음과 같이 입력하세요:
React, Vue, Angular 세 프레임워크의 특징을 비교하는 테이블을 생성해 주세요확인해야 할 것: AI가 생성한 테이블의 열 너비가 정렬되어 다음과 같이 보입니다:
| 프레임워크 | 특징 | 학습 곡선 |
|--- | --- | ---|
| React | 컴포넌트 기반, 가상 DOM | 중간 |
| Vue | 점진적, 양방향 바인딩 | 낮음 |
| Angular | 전체 기능 프레임워크, TypeScript | 높음 |체크포인트 ✅
위 단계를 완료한 후 다음 사항을 확인하세요:
| 확인 항목 | 예상 결과 |
|---|---|
| 구성 파일 구문 | 오류 없음 |
| OpenCode 시작 | 정상 시작, 플러그인 로드 오류 없음 |
| AI가 생성한 테이블 | 열 너비 자동 정렬, 구분선 형식 통일 |
문제 해결 팁
테이블이 포맷되지 않나요?
- 구성 파일 경로 확인: OpenCode가 실제로 읽는 구성 파일을 수정했는지 확인하세요
- 플러그인 이름 확인: 반드시
@franlol/[email protected]이어야 하며,@기호에 주의하세요 - OpenCode 재시작: 구성을 수정한 후 반드시 재시작해야 합니다
"invalid structure" 주석이 보이나요?
테이블 구조가 Markdown 규격에 맞지 않는다는 뜻입니다. 일반적인 원인:
- 구분선 누락 (
|---|---|) - 각 행의 열 수가 일치하지 않음
자세한 내용은 자주 묻는 질문 장을 참조하세요.
이번 수업 요약
- 플러그인은
.opencode/opencode.jsonc의plugin필드를 통해 구성합니다 - 버전 번호
@0.0.3은 안정적인 버전을 사용하도록 보장합니다 - 구성을 수정한 후 OpenCode를 재시작해야 합니다
- 플러그인은 AI가 생성한 모든 Markdown 테이블을 자동으로 포맷합니다
다음 수업 예고
다음 수업에서는 **기능 개요**를 학습합니다.
배우게 될 내용:
- 플러그인의 8가지 핵심 기능
- 숨김 모드에서의 너비 계산 원리
- 포맷할 수 있는 테이블과 포맷할 수 없는 테이블
부록: 소스 코드 참조
클릭하여 소스 코드 위치 보기
업데이트 시간: 2026-01-26
| 기능 | 파일 경로 | 행 번호 |
|---|---|---|
| 플러그인 진입점 | index.ts | 9-23 |
| 훅 등록 | index.ts | 11-13 |
| 패키지 구성 | package.json | 1-41 |
핵심 상수:
@franlol/[email protected]: npm 패키지 이름 및 버전experimental.text.complete: 플러그인이 감시하는 훅 이름
종속성 요구사항:
- OpenCode >= 1.0.137
@opencode-ai/plugin>= 0.13.7