시작하기

설치

정식 빌드가 출시되면 GitHub Releases에서 OS에 맞는 설치 파일을 받으세요.

cd vscode-main
npm ci
npm run watch
.\scripts\code.bat

설치 후 데이터는 사용자 홈 디렉터리의 .kcode 폴더에 저장됩니다.

API 키 설정

Kcode는 OpenAI, Anthropic 등 외부 LLM API를 사용합니다. API 키는 에디터의 Secret Storage에 안전하게 저장됩니다.

1. Ctrl+, (macOS: Cmd+,)로 설정을 엽니다.
2. Kcode → AI 섹션으로 이동합니다.
3. 사용할 프로바이더의 API 키를 입력합니다.

kcode://settings/ai

모델 선택

채팅 패널 상단의 모델 선택기에서 사용할 LLM을 전환할 수 있습니다.

{
  "version": 1,
  "updatedAt": "2026-06-18T00:00:00Z",
  "models": [
    { "id": "gpt-4o", "provider": "openai", "label": "GPT-4o", "recommended": true },
    { "id": "claude-sonnet-4", "provider": "anthropic", "label": "Claude Sonnet 4" }
  ]
}

api/models.json에서 스텁 응답을 확인할 수 있습니다.

.kcode/rules/

프로젝트 루트에 .kcode/rules/ 디렉터리를 만들면 AI 에이전트에게 프로젝트별 지침을 제공할 수 있습니다.

# TypeScript 규칙
- strict 모드를 유지한다
- any 사용을 피한다

kcode://open?path=.kcode/rules

에디터 연동 (설계)

Kcode 웹사이트와 에디터는 다음 훅으로 연동됩니다. 현재는 플레이스홀더이며, 에디터 Phase 4에서 구현됩니다.

kcode:// 프로토콜

• kcode://docs/getting-started — 문서 열기
• kcode://settings/ai — AI 설정
• kcode://open?path=.kcode/rules — 규칙 폴더

업데이트 피드

https://kcode.dev/api/updates.json

공개 설정 API