Deskaid

코뎀프

codemcp를 설치하여 Claude Desktop을 페어 프로그래밍 어시스턴트로 만들어 보세요. 이 도구를 사용하면 Claude에게 컴퓨터의 코드베이스에 대한 기능 구현, 버그 수정, 리팩토링을 직접 요청할 수 있습니다. Claude는 직접 파일을 편집하고 테스트를 실행합니다. 이제 Claude의 채팅 창에 코드를 복사하고 내보내는 번거로움은 이제 그만!

codemcp는 다른 AI 코딩 소프트웨어(Claude Code, Cursor, Cline, Aider)와 유사한 기능을 제공하지만 디자인 공간에서 고유한 위치를 차지합니다.

1. Anthropic의 월 20달러 구독 서비스인 Claude Pro 와 함께 사용하도록 설계되었습니다. 저는 구독 플랜으로 사용량에 대한 요금을 지불하는 것을 선호하는데, 에이전트 작업에 대한 한계 비용이 전혀 없기 때문입니다. 제대로 작동하지 않는 변경 세트에 5달러를 낭비했다고 해서 더 이상 죄책감을 느낄 필요가 없습니다.Claude Max(월 100달러)를 사용 중이라면 Claude Code도 구독 기반 요금제로 사용할 수 있습니다. 이 경우 codemcp의 가치 제안은 다소 모호하며(어떤 면에서는 Claude Code보다 확실히 떨어집니다), codemcp가 제공하는 다른 UI 관련 기능이 마음에 든다면 Claude Max와 함께 사용할 수도 있습니다. (또한, Claude Code와는 달리 오픈 소스이므로 마음에 들지 않으면 변경할 수 있습니다!)
2. 기본적으로 자동 수락을 기반으로 구축되었습니다. 저는 에이전트가 제 감독 없이 최대한 많은 작업을 수행하도록 하여, 마지막에 모든 것을 한 번에 검토할 수 있도록 하고 싶습니다. codemcp는 대부분의 코딩 에이전트와 다른 두 가지 주요 기능을 제공합니다. 무제한 셸을 금지하는 대신, 에이전트가 사용할 수 있는 명령을 codemcp.toml 에 미리 선언하도록 요구합니다. 또한 모든 LLM 편집 내용을 Git 버전으로 관리하여 에이전트 변경 사항을 세밀하게 롤백할 수 있고, 변경 사항을 커밋하는 것을 잊어버릴 걱정이 없습니다.
3. IDE에 구애받지 않습니다 . Claude에게 변경 사항을 요청하면 Claude가 자동으로 변경해 주고, 원하는 IDE 설정을 사용하여 변경 사항을 검토하고 추가 편집을 할 수 있습니다. 저는 Vim을 일상적으로 사용하는 편집기로 사용하는데, VSCode나 특정 편집기가 필요한 코딩 환경은 저에게 적합하지 않습니다.

중요: 마스터 사용자를 위한 토큰 효율성을 위한 주요 변경 사항

codemcp의 토큰 효율성을 개선하기 위해 마스터에서 codemcp를 다중 도구 도구로 다시 변경하는 중입니다(InitProject를 실행할 때 채팅에 지침이 자동으로 표시되는 단일 도구 대신). 즉, 도구 사용을 수동으로 승인해야 합니다. 도구 사용 승인은 여러 채팅에서 동일하게 적용되므로, 이는 합리적인 타협이라고 생각하지만, 만약 마음에 들지 않으시면 자동 승인 도구 사용을 지원하는 refined-claude 브라우저 확장 프로그램에 버그를 신고해 주세요.

설치

codemcp를 설치하고 사용하는 특정 방법을 추천합니다.

1. uv 와 git이 아직 설치되지 않았다면 설치하세요.
2. 브라우저에 claude-mcp를 설치하세요. 웹사이트에서 SSE MCP 서버에 직접 연결할 수 있으므로 Claude Desktop을 사용할 필요 없이 여러 채팅 창을 동시에 쉽게 실행할 수 있습니다. 이 확장 기능은 통합 기능 출시로 인해 곧 폐기될 것으로 예상됩니다. 하지만 이 글을 쓰는 시점에는 Claude Pro 구독자를 위한 통합 기능이 아직 제공되지 않았습니다.
3. uvx --from git+https://github.com/ezyang/codemcp@prod codemcp serve 사용하여 codemcp를 실행하세요. 비표준 포트에서 수신하려면 --port 1234 추가할 수 있습니다.전문가 팁: 위험하게 살고 싶다면 prod``main 으로 변경하세요. 특정 릴리스에 고정하려면 0.3.0 또는 이와 유사한 버전으로 바꾸세요.전문가 팁: codemcp를 원격으로 실행할 수 있습니다! Tailscale을 사용하고 Tailnet의 모든 장치를 신뢰하는 경우, --host 100.101.102.103 전달하여 안전하게 실행할 수 있습니다. (IP 주소는 노드의 Tailscale IP 주소로 바꾸세요. 이 IP는 일반적으로 100.64.0.0/10 범위에 있습니다.) 경고: 이 MCP에 액세스할 수 있는 사람은 누구나 컴퓨터에서 임의 코드를 실행할 수 있으므로, 0.0.0.0에 바인딩하는 것은 매우 바람직하지 않습니다.
4. URL: http://127.0.0.1:8000/sse 로 claude-mcp를 구성합니다(필요한 경우 포트를 바꾸세요.)
5. 안타깝게도 웹 UI에 망치 아이콘이 일관되게 표시되지 않습니다. 하지만 콘솔에서 "[MCP codemcp] SSE 연결이 열렸습니다"를 찾거나 Claude에게 사용 가능한 도구가 무엇인지 물어보면 MCP 서버가 제대로 작동하는지 확인할 수 있습니다(codemcp의 도구를 사용할 수 있다는 메시지가 표시되어야 합니다).

Claude Desktop을 선호하거나 특이한 요구 사항이 있는 경우 다양한 비표준 상황에 대한 설치 지침을 보려면 INSTALL.md를 확인하세요.

용법

먼저, 작업하려는 Git 저장소 체크아웃에 codemcp.toml 파일을 생성해야 합니다. 에이전트가 포매터를 실행하거나 테스트를 실행하는 등의 작업을 수행할 수 있도록 하려면, 해당 작업을 실행하는 명령을 commands 섹션에 추가하세요(참고: 이 명령들은 필요한 가상 환경을 적절히 설정해야 합니다).

지엑스피1

format 명령은 특별합니다. 이 명령은 항상 파일을 편집한 후에 실행됩니다.

다음으로, Claude Desktop에서 프로젝트를 생성하고 이를 프로젝트 지침에 입력하는 것이 좋습니다.

여기서 $PROJECT_DIR 작업하려는 프로젝트의 경로입니다.

그런 다음 Claude와 프로젝트에 어떤 변경 사항을 적용할지 이야기해 보세요. codemcp가 코드를 변경할 때마다 커밋이 생성됩니다.

이 도구를 사용하여 작성한 샘플 대본을 보려면 다음을 확인하세요.

• 새로운 기능을 구현하다
• 실패한 테스트 수정
• 리팩토링을 하세요

codemcp는 채팅당 커밋을 생성하고 기능을 작업하면서 이를 수정합니다.

철학

• 속도 제한을 받으면 다른 일을 할 시간을 가지세요(Claude의 코드 검토, 다른 사람의 코드 검토, 계획 수립, 회의 진행)
• 이 에이전트는 자율 에이전트가 아닙니다 . 최소한 매 채팅 후에 직접 개입하여 변경 사항을 검토하고 다음 변경 사항을 요청해야 합니다. 한 번의 채팅에서 여러 가지 작업을 요청할 수는 있지만, Claude Desktop의 출력 제한에 도달하여 에이전트를 수동으로 "계속"해야 할 가능성이 높습니다. 이러한 상황을 받아들이고, Claude가 제대로 작업하고 있는지 확인하기 위해 방해 요소를 활용하세요.
• 클로드가 궤도를 이탈하면 돈보다는 시간이 더 많이 소모됩니다. 그에 맞게 행동하세요. 시간이 병목 현상이라면 클로드의 점진적인 성과를 주의 깊게 살펴보세요.

구성

codemcp.toml 에서 지원하는 모든 구성 옵션은 다음과 같습니다.

채팅에서 프로젝트를 초기화하면 project_prompt 로드됩니다.

commands 섹션에서는 특정 도구에 대한 명령을 구성할 수 있습니다. 이름은 LLM에 전달되며, LLM은 해당 명령을 언제 실행할지 결정합니다. project_prompt 에 도구 사용 방법을 추가할 수 있습니다. 또한 도구별로 구체적인 지침을 제공할 수 있는 보다 자세한 구문도 지원합니다.

문제 해결

검사기로 서버를 실행하려면 다음을 사용하세요.

로그는 ~/.codemcp/codemcp.log 에 기록됩니다. 로그 수준은 ~/.codemcprc 에 있는 전역 설정 파일에서 설정할 수 있습니다.

로깅은 프로젝트별로 구성할 수 없지만, 어차피 Claude Desktop을 여러 프로젝트에서 병렬로 사용하는 건 어렵기 때문에 크게 문제가 되지는 않습니다.

기여하다

CONTRIBUTING.md를 참조하세요.