가장 저렴하고 실제로 작동하는 AI 코딩 환경을 찾으세요.

저렴하면서도 실제 저장소에서 작동하는 AI 코딩 설정을 찾아보세요.

CTX Fit은 사용자의 저장소를 분석하여, 그 안에 있는 실제 작업을 대상으로 유망한 AI 코딩 구성을 테스트하고, 승리한 구성을 검토 가능한 변경 사항으로 생성합니다. 이 변경 사항은 --apply 옵션을 사용하여 작업 트리에 적용하거나, 또는 --pr 옵션을 사용하여 풀 리퀘스트로 생성됩니다.

이 도구는 가장 저렴하면서도 신뢰성 있게 작동하는 설정을 선택합니다. 신뢰성은 동점 처리 기준이 아니라 필수 요구 사항입니다. 만약 현재 가지고 있는 것보다 나은 것이 없다면, 그렇게 알려줍니다.

승리자는 점수가 아닌 고정된 규칙에 의해 결정됩니다: 먼저 신뢰도 하한선(reliability floor) 미만의 모든 후보를 폐기하고, 그 다음 기여 비용을 최소화하며, 마지막으로 더 간단한 구성 쪽으로 동점 처리를 합니다. LLM은 결과를 설명할 수는 있지만, 결코 하나를 결정하지는 않습니다.

릴리스 범위 (1.0.21). CTX Fit은 단일 코딩 에이전트 하네스 내의 기능별 구성을 비교합니다. Codex, Claude Code 또는 다른 하네스들을 서로 비교하지는 않습니다. Python, JavaScript/TypeScript, Go, Rust, 그리고 Make에 대한 저장소 네이티브 검증 명령을 인식하고 실행할 수 있으며, 선택된 테스트 명령을 검증 권한으로 간주합니다. 설치 가능한 Python 프로젝트의 경우, CTX Fit은 네트워크 접근 없이 캠페인 환경을 구축하고 이를 설치합니다. 이때 빌드 백엔드와 종속성은 이미 다운로드 없이 사용 가능해야 합니다. 다른 생태계에서는 런타임이 격리된 홈 디렉토리 내에서 호스트 PATH를 통해 사용 가능하고 검증 종속성이 저장소에 이미 존재할 때만 검증을 지원합니다. 최종 검증은 해당 격리된 홈을 사용하여 네트워크 접근 없이 실행되므로, 사용자 패키지 캐시는 지원되는 종속성 출처가 아닙니다. 이는 일반적인 개발의 증거일 뿐이며, 의도적으로 적대적인 코드가 자체 테스트 러너를 속일 수 없다는 것을 증명하지는 않습니다. 릴리스 자격에는 유료 라이브 제공업체 체험판이 포함되지 않았으므로, 비용을 승인하기 전에 ctx doctor와 드라이런(dry run)을 검사하십시오.

pip install --upgrade claude-ctx
cd /path/to/my-project
ctx fit

순수 ctx fit

무료이며, 로컬에서 실행되며, 읽기 전용입니다: 모델을 구동하지 않고, 비용을 지출하지 않으며,
git 명령어를 전혀 발생시키지 않습니다. 실제 저장소에 대한 실행 결과를 간략히 보여드리자면 다음과 같습니다:

Repository: /path/to/ctx
Languages: python, javascript
Current AI coding setup
...

Python 3.11 이상이 필요합니다. 기계가 읽을 수 있는 출력을 원하면 --json을 추가하거나,
전체 평가가 어떤 과정을 거치는지 확인하려면 --dry-run을 사용하세요. --dry-run은
사용자의 히스토리를 읽습니다 — 대표적인 작업을 도출하기 위해 읽기 전용 git 쿼리(log,
show --name-only,
ls-tree, rev-parse)를 실행하지만, 아무것도 기록하지 않습니다: 저장소에도, 인덱스에도, 어떤 참조(ref)에도 아닙니다.

무료 프로필을 넘어, ctx fit --test --budget N은 해당 작업들을 기준으로 후보 구성을 평가합니다. 비용 지출에는 두 플래그가 모두 필요합니다: --test는 --budget 없이 계획만 세웁니다. 실제 평가가 여기서 실행될 수 있는지 확인하려면 ctx doctor를 실행하세요. 실제 평가는
워크스페이스 파일 시스템 MCP(Machine Capability Provider)를 위한 Node.js와 npx, 일치하는 프로바이더 자격 증명, Linux의 Bubblewrap이 필요합니다. 기본 설치만으로도 프로파일링, 계획 수립 및 시뮬레이션은 가능합니다. 일치하는 프로바이더 자격 증명이 없으면 --test는 시뮬레이션 상태로 실행되며, 이는 파이프라인 자체를 입증할 뿐 저장소를 입증하지는 못합니다. 자격 증명은 있지만 실시간 전제 조건이 누락된 경우, CTX는 시험 설정 전에 실행을 거부합니다. 시뮬레이션 결과는 --apply 및 --pr에 대한 증거로 거부됩니다.

Ubuntu 24.04는 비특권 사용자 네임스페이스를 제한하며, 단순히 bwrap을 설치하는 것만으로는 CTX가 저장소 명령을 위해 사용하는 네트워크 비활성화된 네임스페이스를 시작할 수 있다는 것을 증명하지 못합니다. /usr/bin/bwrap에 대한 Ubuntu의 패키징되고 범위가 지정된 bwrap-userns-restrict 프로필을 설치하고 로드하세요:

sudo apt update
sudo apt install bubblewrap apparmor-profiles apparmor-utils
if [ ! -e /etc/apparmor.d/bwrap-userns-restrict ]; then
...

Ubuntu의 전역 비특권 사용자 네임스페이스 제한을 유지합니다. CTX는 시스템 전체 보안 경계를 약화시키는 대신 대상 Bubblewrap 프로파일을 사용합니다. 이 프로파일은 모든 /usr/bin/bwrap 호출자에 대한 관리자 가시성 호스트 정책이며, CTX 내부 설정이 아닙니다. 위의 명령어들은 기존 로컬 프로파일을 보존할 뿐 덮어쓰지 않습니다. ctx doctor는 제한된 /bin/true 경로를 같은 네트워크 네임스페이스의 프로브에서 증명합니다. 이는 리포지토리 코드를 실행하거나 모델을 호출하지 않습니다. Ubuntu의 AppArmor 사용자 네임스페이스 가이드 및 패키징된 Bubblewrap 프로파일을 참조하십시오.

ctx fit --apply는 현재 작업 중인 브랜치에 승리하는 설정을 작성합니다. 제안된 모든 변경 사항을 먼저 출력하고, --yes를 전달하지 않는 한 거기서 멈춥니다. 실제 쓰기 과정에서는 어떤 git 명령어도 실행되지 않습니다: 아무것도 스테이징되거나 커밋되거나 푸시되지 않습니다. 여기에 도달하는 과정은 ctx fit --test --budget N을 실행하며, 이 평가를 위한 작업을 파생시키는 데 읽기 전용 쿼리 --dry-run을 사용합니다.

제안된 각 변경 사항은 파일 이름과 CTX Fit이 그것을 생성하는지 수정하는지를 명시합니다. 오늘날 모든 계획에는 정확히 하나의 CTX 소유 아티팩트인 .ctx/fit-configuration.json이 포함됩니다. 사이드카(sidecar)는 고정된 모델과 평가된 정확한 명령어 및 기능 바이트와 그 해시를 기록하며, 일반적인 ctx run 호출은 해당 구성을 검증하고 활성화합니다.

CTX Fit은 AGENTS.md, CLAUDE.md 또는 다른 사용자 작성 명령어 파일은 다시 쓰지 않습니다. 해당 파일의 평가된 바이트는 대신 사이드카어에 임베딩됩니다. 기존의 추적되지 않은 사이드카어가 중요하다면, 쓰기를 확인하기 전에 사본을 저장하십시오. 버전 관리 복원 명령으로는 추적되지 않은 파일을 복구할 수 없습니다.

** ctx fit --pr은 원격(remote)에 작성합니다.** 이는 브랜치를 생성하고, 승리한 구성(winning configuration)을 커밋하며, 이를 origin으로 푸시하고, GitHub CLI를 통해 풀 리퀘스트(pull request)를 엽니다. 무언가를 실행하기 전에 풀 리퀘스트 본문, 작성할 파일 목록, 정확한 명령어 시퀀스를 출력합니다:

git checkout -b ctx-fit/<timestamp>
git add -- <paths>
git commit -m "<풀 리퀘스트 제목>"
...

--yes가 없으면 거기서 멈추고 아무것도 변경하지 않습니다. --yes를 사용하면 해당 파일들을 작업 트리에 작성하고, 그 후 이 다섯 가지 명령어를 순서대로, 그리고 다른 어떤 것도 없이 실행합니다. 이들 중 어느 것이든 실행되기 전에, 아래 설명된 게이트(gate)가 읽기 전용 프로브(git rev-parse, git status, git remote get-url, 및 gh auth status)를 실행하는데, 이것이 모든 거절(refusal)이 저장소의 원래 상태 그대로 남도록 하는 이유입니다. CTX Fit은 결코 병합(merge)하지 않습니다.

--pr은 Git 저장소 내부에 있지 않거나, 작업 트리에 CTX Fit이 작성하지 않은 변경 사항(추적되지 않은 파일 포함—새 브랜치로 가져가질 것임)이 있거나, gh...

설치되어 있지 않거나
로그인되지 않았거나, 브랜치가 이미 존재하거나, 푸시할 원격 저장소가 없는 경우에 발생합니다. 각 거부 메시지는 어떤 문제였는지 알려주고, 0이 아닌 값으로 종료되며, 트리는 건드리지 않습니다. 명령 실행 중 일부가 실패하면, CTX Fit은 어떤 것이 실패했는지와 몇 개가 실행되었는지, 그리고 원래 있던 브랜치로 돌아가는 방법을 보고합니다. 이미 작성된 파일들은 작업 트리(working tree)에 그대로 남아 있습니다.

릴리스: v1.0.21
이 CTX Fit 릴리스입니다. 배포 이름은 claude-ctx를 유지합니다.

; 설치된 명령어는
ctx
입니다.

CPython 3.11 이상을 요구합니다. Linux와 macOS가 테스트된 호스트 플랫폼이며, 다른 POSIX 시스템은 최선의 노력(best-effort)으로 간주됩니다. 네이티브 Windows 및 PowerShell은 지원하지 않습니다. Windows 장치에서 사용하려면 WSL2 내부의 Linux 설치로 ctx를 실행하십시오.

pip install claude-ctx

실제 모델 기반 평가를 위해서는 대신 claude-ctx[harness]를 설치하고 Node.js와 npx를 사용할 수 있도록 설정해야 합니다. Linux 호스트는 Bubblewrap도 필요합니다.
ctx doctor

이 명령어는 모델에 연락하거나 비용을 지출하지 않고 이러한 전제 조건들을 확인합니다.

버전 1.0.21은
주요 명령어인 ctx fit과 더불어 ctx doctor, 그리고 ctx advanced를 제공합니다. 기존의 에이전트 루프 표기법(ctx run, ctx resume, ctx sessions)도 계속 지원됩니다.

분석하려는 저장소에서 런타임 그래프를 설치하고 추천을 요청하려면 다음 명령어를 사용하십시오:

ctx-init --graph --model-mode skip
ctx-scan-repo --repo . --recommend

ctx-init --graph는 이미 캐시된 검증된 로컬 런타임 아티팩트가 있는 경우 이를 사용하고, 그렇지 않은 경우 정확한 내용 주소 지정(content-addressed) GitHub 릴리스 애셋을 다운로드합니다. 무거운 아카이브 파일은 Git이나 Git LFS에 저장되지 않습니다. 전체 패키지 위키는 선택 사항이며, 지식 그래프 가이드를 참조하십시오.

모든 클린 그래프 설치는 프로젝트 소유의 MIT 라이선스 기반으로 키가 필요 없는 9가지 폴백(fallbacks)을 시딩합니다: ctx-python-testing, ctx-python-state-protocols, ctx-python-input-boundaries, ctx-python-api-compatibility, ctx-javascript-testing, ctx-rust-patterns, ctx-typescript, 그리고 에이전트인 ctx-python-reviewer와 로컬 ctx-core입니다.

MCP 서버는 관련 없는 스킬, 에이전트, MCP 및 변환된 스킬 콘텐츠를 보존합니다.
런타임 관리 하네스 페이지는 설치된 아티팩트에서 새로 고침됩니다.
예약된 ctx-* 식별자, 본문(body), 오버레이 또는 부모 경로가 예상되지 않으면 설치가 실패하며 닫힙니다.

이러한 제어 기능은 릴리스 1.0.21에 제공됩니다.

local_redacted 모드에서는 기본적으로 원격 측정(Telemetry) 기능이 활성화됩니다. 이벤트는 ~/.ctx/telemetry/events.jsonl에, 메트릭은 ~/.ctx/telemetry/metrics.jsonl에 기록되며, 원시 프롬프트와 쿼리는 제거되거나 해시됩니다. 연속적인 로그(log), 추적(trace), 메트릭 내보내기 기능은 기본적으로 비활성화되어 있습니다.

네트워크 내보내기를 위해서는 명시적인 ctx-telemetry-export 명령 또는 운영자 활성화된 내보내기 구성이 필요합니다. 로컬 JSONL 파일은 호환성을 위해 원시 session_id를 유지할 수 있으므로, 스풀(spool)을 민감한 정보로 취급하십시오. 내보내기를 활성화하기 전에 엔터프라이즈 원격 측정 가이드(enterprise telemetry guide)를 검토하십시오.

ctx-telemetry-export --dry-run --json
이 드라이 런(dry run)은 스풀을 내보내지 않고 로컬에서 검사합니다.

이 표는 릴리스 1.0.21을 설명합니다. 기본 ctx

인수 없이 실행하면 Fit 프로파일을 실행하며, 이것이 추천 표면(recommendation surface)에 나열되지 않는 이유입니다.

에이전트 루프 하네스(run, resume, sessions)는 여전히 존재하며 지원됩니다. 이는 ctx advanced 아래로 이동했기 때문에 최상위 도움말은 제품에 관한 내용을 유지하지만, 원래의 철자법을 사용하면 계속 작동합니다: ctx run ...과 ctx advanced run ...은 동일한 명령이며, ctx run --help는 여전히 하네스 옵션을 출력합니다. 변경된 것은 오직 ctx --help뿐인데, 이제 fit, doctor, 그리고 advanced를 광고합니다. 이전에 콘솔 스크립트였던 유지보수 유틸리티들은 python -m으로 접근할 수 있습니다 — 예를 들어 python -m ctx.cli.recommend 또는 python -m ctx.core.quality.dedup_check입니다.

구성, API, 엔티티 생명 주기 및 운영 세부 정보에 대한 전체 문서는 참고하십시오.

추적 출처

릴리스 준비 상태는 qa/feature_status.csv에서 추적됩니다.

docs/qa/feature-user-story-status.csv, docs/qa/dashboard-user-story-status.csv