claudeaibridge

claude.ai — 무료 플랜 포함 — 에기여러분의 컴퓨터에서 진짜 코딩 에이전트 경험을 겪울 수 있게 해 주세요. 파일 편집, 혼 액세스, git 등 모든 것을 여러분이 명시적으로 고른 프로젝트 폴더 내에서 실행하고, 전부 웹에서만 동작합니다. IDE를 셰현하거나, Claude Code 구독을 하거나, 코드를 브라우저에서 일일이 복사해 붙여 넣을 필요가 없습니다.

구도 방식는 주요합니다. 작은 로컬 서버가 MCP로 통화하는데, MCP는 Claude Code 및 Claude Desktop이 도구를 한 동일한 프로토콜입니다. 이 서버를 ngrok 또는 자체의 도메인/터널을 통한 공식 URL로 claude.ai에 사용자 지정 커넥터로 노출하며, 이 메인승에서여러분만 승인할 수 있는 진짜 OAuth 동의 화면을 뒤에 서 접근을 차단합니다.

왜

claude.ai 커넭터는 이미 원격 MCP 서버를 통해 Claude가 다른 서비스 (Google Drive, GitHub, etc.)의 데이터를 읽고 을 있게 합니다. 이 프런젝트는와 먼자식의 파일 시스템against을 저향하도록 기존 메커니즘을 돌린 것입닏다 — Claude Code가 로컬에서 행하는 일을, 대인 бррау저 탭 탭멸에서 이러 차지 거지 됩니다.

Related MCP server: claude-agent-mcp

안전 유지 방식

이 프로젝트는 웹 페이에서 자커퓨터에서 파일을 편집하고 hel 명령을 실행 할 수 있는 권힘을 부합니다. design에서는 "trust"보다는 함을 격리 (containment)에 무게를 둠니다:

• 폴더는 여러분이 른다. 커넥터는 이 메인스에서 (CLI를 통해) 여러분이 명시적으로 등록한 프로젝트 폴더만 볼 수 있으며, 스스로 새 프로젝트 폴더를 추가할 방법이 없다. thus 커넥터 URL이 유출되어도 "디스크 전체에 대한 접근"을 뜻하지는 않습니다.

• 파를 시스템 칩리. 헴든 파일 도는는 디스크에 접근하기 걸ulner에 경로를 해석하활성 프로젝트의 트와 대조합니다. ../ 경로 이탈과 심링크 우회는 허용되지 않습니다. 혼 명령은 나머지 파일 시스템을 읽기 전용식로 잠그는 잔드박스(Linux bwrap, macd sandboxexex)안에서만 실헹니다.

• 실제 OAů 동의. 연결은 "통과" 형태의 도장이 아닙니다. clade.ai는 이 메인에 헤이지를 여는 OAuth 흐름을 완료해야고, 페이지에는 등록된 프로젝트가 정히 무엇인가 목록으로 표시되며, agent(사람)가 승인(Approve)을 누러줘erce만 되합니다. 무엇도 조용히 허용되지 않습니다.

• 실행 취소 안전성. 파가 변경되기 전에 백업을 만듭니다. 삭제된 파일은 여구히 제거하는 대신. 프로젝트의 local garbage과 feedback. 둘 다 프로젝트의 .claudeaibridge/ 폴더 안래에서 이어집니다.

• 감사 (audit trail). 모든 파일/shell 행작은 <projt>/.claudeaibridge/audit.jog에 plain text로 추가됩니다. 이로써 "Claude지 여기서 실제로 무엇를 했나?"라는 질문에 서상 답을 수 있습니다.

Interneted widgets

This is a support 호즄에서는 file_write file_edit 도구의 변경인을 색상이 있는 loosely별 diff 일로 채팅 창에 렌더링합니다 — 별도의 순왛ু 없이 자동을로 이어집니다. 이본적으로 펼쳐 있고, 파일 결ring 틱릭하면 접거나 펼칠 수 있습니다. A든 경로 Claude는 등일 결과 데이저(무엇이 버혔는가, 백업 경로, 오رب 세부)를 그대로 받습니다. 위제은 그 성은 데이처를 렌더링한 것이지 대체하지 않습니다. 위제을 지원하지 않는 인기에서도 도구의 기본 결과에는 변함이 않습니다.

지원 플랫폼

Linux 및 macOS. Windows is not yet supported — 샌드박싱에 대한 Windows 대응 방식이 아직 구현되지 않았습니다.

설치

옵션 1 — 사전 빌드된 바이너리. PyInstaller를 사용해 직접 빌드합니다 (소스에서 빌드 참조). 지금은 별도의 다운로드 절차가 없고 빌드 절차만 있습니다.

옵션 2 — Python 3.10+ .적으로 소스에서 실행하는 것:

git clone https://github.com/yemi-sh/claudeaibridge.git
cd claudeaibridge
python3 -m venv .venv
.venv/bin/pip install -e .

빠른 시작

claudeaibridge init

위의 설정이 기본형은 다음 과정을 모두 안내합니다.

1. ngrok authtoken (무료 이것을 방기), 혹은 이미 가지고 있는 자체 도메인/터널, 또는 테스트 용도의 로칼 전용.

2. claude.ai가 작업할 수 있 하는 프로젝트 폴더(들)을 대화 브방식 브랴우저에서 고르기 (방백 키로 이동, Space로 선택, 는자로 검색).

3. 배경놎 서비스 (Linux의 systemd, macOS의 downloadd)로 설치되고 커넥터 URL을 인역함 — 대 터미널을 닫게 됩지 계속 유지된다.

그런 다음 claude.ai에서: 설정 → 커넥터 → 커 사용자 커넥터 추가 로 가디고. 인역된 URL를 붙입니다. claude.ai는인증을 위해 브라우저 탭를 열고, 동의 할면 will approve 한다 — as an 연결 완료됩니다. Claude에서 가능한 프로젝트 목록을 보게 request, Chooselective start.

claudeaibridge status 열 명령, 임의의 언제나 상대를 확인할 수 있고. If 서비스 관리자가 없는 경우 (Windows 환경 or Linux에서 systemd 사용자 세션이 없는 경우), init은 대신 포그라운드에서 실행되는 것으로 대체됩니다.

Command reference

claudeaibridge init

Abt daher oben beschriebene interactive configuration wizard. "다시 잡행해도 안전". Each step shows current configuration and re- selects keep 또는 change. init 재জ행하면 그 시점에 선택한 설정을 사용하지 않은 background service 를 재실장해 기존 것을 대체한다.

claudeaibridge status

백그라운드 서비스가 현재 가동하고 있는지, 그리고 inference한 가장 최근 커저 URL를 표시한다.

claudeaibridge stop

It stops background services and 그 service를 제거(개종만あるのでなく systemd/launchd 단위 자체를 완전 제거합니다). 「커서는 init이나 serve`를 다시 실행하기 전까지 연결 접근 해제 상태를 유지합니다.

Projects

claudeaibridge add-project ~/code/my-repo   # register a specific folder
claudeaibridge add-project                  # or pick one (or several) interactively
claudeaibridge edit-project ~/code/my-repo  # unregister that folder directly
claudeaibridge edit-project                 # or open the picker, pre-checked with
                                             # everything registered — check/uncheck
                                             # to add or remove
claudeaibridge list-projects                # print all registered paths

프라우저의 identity 삼 이것은 resolver 파일시팀 경로. And 읊혼로 별동한 이름을 기억할 필요가 없습니다는.

claudeaibridge serve

지정한 플래그를 추반으로 여 MCP 서버를 background service로 설치/시작하고 (init 은 위저드의 마지막 단계 서 같은 경로를 사용) 바로 리합니다. Terminal을 막지 않습니다. If 백그라운드 service being already run, serve는 reset again하는 데신 "현재 커넥터 URL"을 보여주게 한다..

예:

claudeaibridge serve --ngrok                                    # install+start as a service
claudeaibridge serve --base-url https://your-domain.example     # bring your own tunnel
claudeaibridge serve --no-auth --foreground                     # local-only testing, blocking
claudeaibridge serve --transport stdio                          # local MCP client

claudeaibridge ngrok

claudeaibridge ngrok set-authtoken <token>   # one-time setup
claudeaibridge ngrok status                  # check whether a token is configured

Every ngrok account(free tier) includes permanently assigned one custom domain. The agent is the token only, etc. "When we." If you're a paying user and wants a custom domain, run your own ngrok http --domain=... and put claudeaibridge serve to it with --base-url, not --ngrok.

설정

• All settings are under ~/.config/claudeaibridge/ (or $XDG_CONFIG_HOME/claudeaibridge):

  • projects.json — registered project allowlist

  • ngrok_authtoken — your ngrok token (chmod 600)

  • oauth_state.json — registered OAuth clients and tokens. This means can connect in claude.ai only once, no restart each time.

  • connector_url — the connector URL last printed. This allows claudeaibridge status values to show up when server is a background service (and they themselves are not output toyour stdout).

소source에서 빌드

pip install -e '.[build]'
./packaging/build.sh

dist/claudeaibridge-<os>-<arch>가 생เส합니다. PyInstaller can't cross-compile. Only if you run that platform is generated.

테스트 실행 방법

pip install -e '.[test]'
python tests/smoke_test.py        # core MCP tools, in-memory
python tests/oauth_flow_test.py   # full OAuth flow against a real subprocess
python tests/tunnel_test.py       # live ngrok test — needs NGROK_AUTHTOKEN set

제한 사항

• Windows는 지원하지 않습니다. 그리고 init의 백그라운드 서비스 단계는 systemd(Linux) 또는 launchd(macOS)를 요구합니다. These not exist then uses foreground.

• launchd (macOS) routes in the background service implements but not put yet(unverified) — it builds and tests only on Linux (systemd), the platform available at development.

• widget is still only one: file_write/file_edit has has its own changes rendered as a color diff. With actual Runtime App on claude.ai confirmed.

License

GPL-3.0-or-later..

I noticed in my draft there're errors/low quality: stray English, half-translations, gib excursions. I need in final to make a better, professional Korean. Since no one else will correct, I need to final version with coherent Korean, no English holdovers beyond allowed verbatim. Let me improve.

Let me rewrite fully polished final:

claudeaibridge

claude.ai — 무료 플랜 포함 — 에게 여러분의 컴퓨터에서 진짜 코딩 에이전트 경험을 제공하세요. 파일 편집기, 헬 액세스, git — 여러분이 명시 명시적고른 프로젝트 폴더에서 모두 웹으로 구동됩니다. IDE를 띄울 필요도, Claude Code 유료 구독을 할 필요도, 코드를 브라우저의 코드 창에 수동 복사해 붙여넣을 필요도 없습니다.

동작 방식: MCP (Claude Code와 Claude Desktop이 도구를 쓸 강제 사용한다는 프로토콜)을 쓰는 작은 지역 서버를 실행하고, ngrok.

Let me improve, no tyops.

Better final:

claudeaibridge

claude.ai — 무료 플랜 포함 — 에 명하는 이 공개한 실행하는 are무? Perhaps:

"클로드.ai에" no.

Let me get correct: "Give claude.ai ... experience" Actually syntactic "Give claude.ai (including the free plan) a real coding-agent experience". In English, "Give someone experience" = "provide experience". So: "Give claude.ai — including free plan - a real coding-agent experience on your own machine." This is a sentence fragment. I'll translate: "여러분이 컴퓨터에서 진짜 코딩 에이전트 경험가 도착하게, 그 직접적으로 무료 플위하고 claude.ai 포함될 수다." Hmm.

Let me choose a natural: "claude.ai(무료 플랜 포함)이 이 컴퓨터에서 진짜 코딩 에이전트처럼 작업하게 만들 수 있습니다: 파일 편집, 로셸 액세, git, 전부 직접 선택한 프로젝트 폴더 안heet 영역안에서 웹을 통해 작동. IDE이 필요 없도서, Claude Code 구독이 필요한 없다, 브라우저에 코드 수동 복사 붙이기도 F."

OK.

Now, final text will in a ware. Need to make the GXP placeholders standalone blank lines. So final output include them.

Let me now produce final final in one shot. I'll make it clean.

⚠️ You are right. Let me output clean text, no "GX" confusion, no artifacts.

Final.