CodeLocal: 모든 AI 클라이언트를 위한 범용 MCP 레이어

하나의 프로젝트 브레인. 어떤 AI 클라이언트와도 연결 가능. 당신의 머신에서.

CodeLocal은 AI 코딩을 위한 범용 MCP(Multi-Client Protocol) 레이어입니다. ChatGPT, Codex, Claude 등 다른 MCP 호환 클라이언트를 하나의 영속적인 **프로젝트 브레인(Project Brain)**에 연결하며, 사용자가 자신의 머신에서 명시적으로 승인한 프로젝트 폴더에 대한 제어된 접근을 제공합니다.

모델이 추론하고, CodeLocal이 기억하고, 라우팅하며, 실행합니다.

대부분의 AI 코딩 도구는 각 채팅, 클라이언트 또는 머신을 새로운 시작으로 취급합니다. CodeLocal은 정반대의 아이디어를 기반으로 설계되었습니다: 프로젝트 지능은 오늘 사용하게 되는 인터페이스에 관계없이 생존해야 합니다.

하나의 프로젝트 브레인(One Project Brain) — 검증된 결정, 프로젝트 컨텍스트, 규칙, 경험 및 재사용 가능한 기술을 보존합니다.어떤 호환 AI 클라이언트와도 연결 가능(Any compatible AI client) — 동일한 프로젝트 지능에 대해 ChatGPT, Codex, Claude 또는 다른 MCP 지원 에이전트를 사용합니다.제어된 로컬 실행(Controlled local execution) — 파일, Git, 터미널 및 선택적 자동화가 명시적으로 승인된 작업 공간을 대상으로 실행됩니다.설계 단계부터 다중 작업 공간(Multi-workspace by design) — 하나의 로컬 런타임이 여러 프로젝트를 유지하고 필요할 때 활성화할 수 있습니다.로컬 우선 소스 접근(Local-first source access) — 리포지토리 소스와 로컬 인덱스는 기본적으로 사용자의 머신에 남아 있으며, 클라우드는 신원 확인, 라우팅 및 정제된 영속적 연속성을 위해 사용됩니다.

저희는 Codex, Claude Desktop, DeepSeek Harness, Cursor 또는 다른 AI 코딩 클라이언트를 재구축하려는 것이 아닙니다. AI 클라이언트들은 인터페이스입니다. CodeLocal은 그 뒤에 있는 공유 지능 및 실행 레이어입니다.

You
↓
MCP 호환 AI 클라이언트 ChatGPT · Codex · Claude · 기타 에이전트
...

AI 클라이언트/모델이 추론하고; CodeLocal이 공유 MCP 레이어를 제공하며, 프로젝트 지능을 보존하고 실행을 제어합니다.

Node.js 20+ 및 npm이 필요합니다.

현재 안정화된 버전을 설치하세요:

npm i -g codelocal@latest

설치된 버전을 확인하세요:

codelocal --version

하나 이상의 프로젝트를 승인하세요:

cd /path/to/project-a
codelocal .
cd /path/to/project-b
...

하나의 머신 런타임을 시작하세요:

codelocal

단일 런타임으로 여러 워크스페이스를 인증 상태로 유지할 수 있습니다. 프로젝트나 AI 클라이언트마다 CodeLocal 데몬을 가질 필요는 없습니다.

유용한 명령어:

codelocal --version
codelocal setup
codelocal status
...

현재 호스팅되는 MCP 엔드포인트는 다음과 같습니다:

ChatGPT와 Codex의 경우, 사용 가능한 OpenAI 디렉토리에서 CodeLocal 플러그인을 사용하십시오. 리뷰어/개발자 흐름은 해당 엔드포인트를 직접 사용할 수 있습니다. 다른 MCP 호환 클라이언트는 인증된 원격 MCP를 지원할 때 동일한 원격 엔드포인트를 추가할 수 있습니다.

OAuth는 AI 클라이언트를 CodeLocal 계정에 로그인시킵니다. 페어링(Pairing)은 로컬 머신을 같은 계정에 연결합니다. 연결된 클라이언트는 해당 계정에 속하는 장치와 워크스페이스로만 도구를 라우팅할 수 있습니다.

일반적인 첫 요청:

@CodeLocal inspect project_info first, understand this project,
then make the requested change and run the relevant checks.

• 지속 가능한 단일 사용자 프로젝트 지식;

• 검증된 경험 촉진 및 재사용;

• 재사용 가능한 학습된 기술;

• 프로젝트 규칙, 결정 및 제약 조건;

• 클라우드 연속성이 사용 가능할 때 호환되는 클라이언트와 페어링된 머신 간의 연속성.

• 워크스페이스 경계 강제 적용 및 심볼릭 링크 탈출 보호;
  .gitignore에 대한 인식 기반 목록화 및 검색;- 민감 경로 차단 (.gitignore와 무관).
  ; - UTF-8/바이너리 감지 및 범위 읽기;

• SHA-256 오래된 쓰기 방지(stale-write protection);

• 정확한 편집, 패치 및 트랜잭션 구조화 편집;

• 프로젝트/언어/프레임워크 매핑;

• 심볼, 정의, 참조, 진단 및 구조적 호출/가져오기 컨텍스트;

• Node, Go, Rust 및 Python에 대한 종속성 검사.

네이티브 구조 엔진은 언어 서버를 요구하지 않고 작동합니다. 전용 LSP 통합 기능은 사용 가능한 경우 깊이를 더합니다.

• 보호된 호스트 명령어 실행(guarded host command execution);
• 동시 프로세스 관리 및 사용 가능한 PTY 지원(concurrent process management and PTY support);
• 증분 stdout/stderr, stdin, 크기 조정(resize), 신호(signals) 및 취소(cancellation);
• 결정론적 명령어 위험 분류(deterministic command risk classification);
• 민감한 작업에 대한 승인 게이트(approval gates for sensitive operations);
• 로컬 마스킹 터미널/감사 기록(local redacted terminal/audit history);
• 강제되지 않은 Git 스테이징, 커밋 및 푸시 제어(non-force Git stage, commit and push controls);
• 부작용을 일으키는 도구 호출에 대한 반복성 보호(idempotency protection for side-effecting tool calls).

CodeLocal은 사용자의 장치에 설치된 다른 MCP 서버와 연결하면서 그 구성을 로컬로 유지할 수 있습니다.

codelocal mcp add <name> -- <command> [args...] 
codelocal mcp add <name> --url <https://server/mcp>
codelocal mcp list
...

비밀(Secrets)은 CodeLocal Cloud에 복사되는 대신 환경 변수에서 참조되어야 합니다.

최초 시작 시, CodeLocal은 두 가지 선택적 기능(optional capabilities)을 개별적으로 활성화할 수 있습니다:

브라우저 자동화(Browser Automation)— 열기, 검사, 클릭, 타이핑 및 스크린샷을 위한 격리된 Chromium 세션.
컴퓨터 사용(Computer Use)— 운영 체제 접근성/화면 권한을 통한 네이티브 데스크톱 제어.

나중에 이 선택 사항들을 변경하려면 codelocal setup을 실행하고, 준비 상태를 검사하려면 codelocal doctor를 실행하세요.

.gitignore는 보안 경계가 아닌 검색 규칙(retrieval rule)입니다. 개인 키, 자격 증명 저장소 및 .env와 같은 민감한 위치의 비밀은 별도로 처리됩니다.

터미널 명령어는 CodeLocal 정책과 승인 확인을 거쳐 사용자의 호스트에서 실행됩니다. CodeLocal이 명령어 정책만으로 OS 샌드박스(OS sandbox)라고 주장하는 것은 아닙니다. 브라우저 자동화와 컴퓨터 사용은 선택 사항이며, 해당 신뢰 모델이 수용 가능한 경우에만 활성화해야 합니다.

원시 리포지토리 소스(Raw repository source), 로컬 인덱스, 비밀 및 장치 바인딩(machine bindings)은 기본적으로 로컬로 유지됩니다. 지원되는 원격 MCP 흐름(remote MCP flow), 계정/장치 라우팅(account/device routing) 및 크로스 디바이스 프로젝트 브레인 연속성(cross-device Project Brain continuity)은 현재 CodeLocal Cloud에 의존합니다.

전체 보안 및 개인 정보 보호(Security & Privacy), 보안 정책(Security Policy) 및 구현 상태(Implementation Status)를 읽어보세요.

“아이를 키우기 위해서는 마을 전체가 필요하다. 오픈 소스도 다르지 않다.”

CodeLocal은 여전히 성장하고 있습니다. 버그를 발견했거나 디자인 결정에 동의하지 않거나 아이디어가 있거나 프로젝트의 어떤 부분을 개선할 수 있다면, CodeLocal 포럼에서 코드를 기여하고 피드백을 공유해 주세요.

codelocal.cloud

은 CodeLocal 팀의 현재 **참조 배포(reference deployment)**입니다. 소스 코드는 여러분이 연구하고, 포크(fork)하며, 수정하고, 실험할 수 있도록 공개되어 있습니다. 실험적인 자체 호스팅은 환영하지만, 자체 호스팅된 공용 게이트웨이는 아직 공식적으로 지원되는 배포 대상이 아닙니다.

CodeLocal이 “완료”될 때까지 기다리지 말고 참여해 주세요. 코드를 검토하고, 이슈를 열고, 더 안전한 디자인을 제안하고, 풀 리퀘스트(pull requests)를 보내고, 가정을 문제 삼고, 작동하지 않는 부분을 알려주세요. 함께 CodeLocal의 성장을 도와주세요.

기여하기(Contributing)를 확인해 주세요.

공개 에디션은 한 사람을 위해 의도적으로 최적화되었습니다: 한 사용자의 프로젝트 브레인, 재사용 가능한 기술, 프로젝트 컨텍스트 및 호환되는 AI 클라이언트를 통한 제어된 실행입니다.

프라이빗 엔터프라이즈 에디션(private Enterprise edition)은 보안에 민감한 비즈니스 환경 내부에 AI가 필요한 조직을 위해 설계되었으며, 조직 전체의 제어 기능, 사설 통합, 고객별 특정 배포 가정 및 독점 인프라 결합 기능을 포함할 수 있습니다.

공개 레포지토리는 엔터프라이즈 코드베이스에서 개인 파일을 제거한 복사본이 아닙니다. 우리는 엔터프라이즈 소스 코드를 이 레포지토리로 옮기지 않습니다. 대신, 엔터프라이즈 에디션은 검증된 제품이자 운영 참조 역할을 합니다: 각 기능은 공개 에디션을 위해 다시 설계되고 구현됩니다.

왜 그럴까요? Enterprise 에디션에는 조직별 통합(organization-specific integrations), 배포 가정(deployment assumptions), 접근 제어(access controls), 보안 강화(security hardening) 및 사설 비즈니스 환경과 긴밀하게 결합된 인프라가 포함되어 있습니다. 이 코드를 공개 저장소에 직접 복사하면 오픈 소스 에디션이 이해하기 어렵고, 감사하거나(audit), 포크(fork)하여 독립적으로 실행하기 어려워질 것입니다. 각 공용 기능을 개별적으로 재구축함으로써 유용한 아이디어와 동작은 유지하면서 커뮤니티를 위한 더 깨끗하고 독립적인 구현을 제공할 수 있습니다.

이 리라이트는 수동으로, 기능별로 수행되고 있습니다. 전환 기간 동안 공개 저장소에는 Enterprise에서 사용 가능한 모든 기능을 아직 포함하고 있지 않을 수 있으며, 검토자들은 배포된 공용 npm 런타임에 속하지 않는 역사적 이름, 호환성 파일 또는 Enterprise 시대의 메타데이터를 여전히 접할 수 있을 것입니다.

현재 공개 저장소 분리 및 정리 목표 완료일: 2026년 10월 19일입니다.

그때까지는 STATUS.md, 릴리스 빌더(release builder) 및 표준 아키텍처 문서(canonical architecture documentation)를 공용 에디션에 실제로 배포되는 내용의 진실 공급원(source of truth)으로 사용하십시오.

표준 백엔드, 클라우드 게이트웨이(Cloud gateway), CLI 및 로컬 런타임은 Go로 구현되었습니다. 브라우저 제품은 Next.js + TypeScript를 사용합니다. Product Stack을 참조하십시오.

Go 1.25 이상 필요.

go test ./...
go vet ./...
go build ./cmd/...```

게시 없이 npm CLI 스테이징 패키지를 검증하고 빌드하려면:

`npm run release:npm:prepare`

전체 저장소 게이트를 사용하려면:

`npm run release:prepare`

게시 및 릴리스 세부 정보는 npm 릴리스 운영 핸드북에 있습니다. 이 README에 자주 변경되는 구현 세부 정보를 중복하여 넣기보다는, 릴리스 메커니즘은 그곳에 유지해 주세요.

Stable:

`npm i -g codelocal@latest`

Beta:

`npm i -g codelocal@beta`

일반적인 npm 업데이트는 기존의 페어링 자격 증명(pairing credentials)과 승인된 워크스페이스를 유지합니다. 이미 열려 있는 MCP 클라이언트가 업데이트 후 도구/스키마 불일치(tool/schema mismatch)를 보고하는 경우, 해당 클라이언트에서 CodeLocal을 새로 고침하거나 다시 연결하여 현재의 도구 표면(tool surface)을 스캔하도록 하세요.

- 시작하기 (Start here)
- 사용자 가이드 (User Guide)
- CodeLocal 작동 방식 (How CodeLocal Works)
- 보안 및 개인 정보 보호 (Security & Privacy)
- 프로젝트 브레인 증거 (Project Brain Evidence)
- 제품 스택 (Product Stack)
- 구현 상태 (Implementation Status)
- 보안 정책 (Security Policy)
- 기여하기 (Contributing)
- 베타 채널 (Beta Channel)
- OpenAI 플러그인 제출 패키지 (OpenAI Plugin Submission Pack)

웹사이트: https://codelocal.cloud

CodeLocal은 Apache License 2.0에 따라 라이선스가 부여되었습니다. 파일이나 디렉터리에 달리 명시되지 않는 한, 이 저장소의 소스 코드는 해당 라이선스의 조건 하에서 사용, 수정 및 배포될 수 있습니다. 타사 구성 요소는 각자의 라이선스를 유지합니다.