Claude Code, Gemini CLI, Codex CLI, Antigravity 등 AI 코딩 도구들을 위한 설정 관리자입니다.

마이그레이션 참고 사항: 이 패키지는 @regression-io/claude-config에서 coder-config로 이름이 변경되었습니다. 기존의 claude-config 명령어는 여전히 별칭(alias)으로 작동합니다.

AI 코딩 비서들은 강력하지만, 프로젝트 전반에 걸쳐 설정을 관리하는 것은 번거롭습니다. 각 도구마다 고유한 설정 형식이 있습니다. MCP 서버는 프로젝트별로 설정해야 하며, 세션 간 컨텍스트가 손실됩니다. 여러 리포지토리를 넘나들며 작업할 경우 매번 관계를 재설명해야 합니다.

작업 흐름 (Workstreams)
관련된 리포지토리들을 그룹으로 묶을 수 있습니다. 작업 흐름이 활성화되면, Claude는 자동으로 접근 가능한 디렉터리를 파악하고 사용자 지정 컨텍스트를 받게 됩니다. 마이크로서비스(microservices), 모노레포(monorepos) 또는 프로젝트들이 서로 연관된 모든 멀티-리포지토리 워크플로우에 유용합니다.

통합 MCP 레지스트리 (Unified MCP Registry)
MCP 서버를 전역 레지스트리에 한 번만 정의할 수 있습니다. 토글을 사용하여 프로젝트별로 활성화할 수 있습니다. 설정은 글로벌 → 작업 공간(workspace) → 프로젝트 순으로 상속되므로, 공통 도구는 항상 사용 가능하며 프로젝트별 도구는 범위가 제한됩니다.

계층적 규칙 (Hierarchical Rules)
규칙들은 ~/.claude/rules/에서 시작하여 프로젝트별 규칙까지 계단식으로 적용됩니다. 글로벌 컨벤션은 모든 곳에 적용되며, 프로젝트별 지침은 로컬에 유지됩니다.

영구 메모리 (Persistent Memory)
세션 전반에 걸쳐 지속되는 선호도, 수정 사항, 패턴을 저장합니다. Claude에게

npm install -g coder-config

Node.js 18 이상 필요.

@regression-io/claude-config에서 마이그레이션하는 경우? npm uninstall -g @regression-io/claude-config npm install -g coder-config설정은 자동으로 보존됩니다.

~/.claude-config/

# 1. 설치
npm install -g coder-config
# 2. 자동 시작 설정 (권장)
...

로그인 시 서버가 자동으로 시작됩니다. 브라우저에서 PWA로 설치하여 앱과 같은 접근성을 확보하세요.

coder-config update
# 그리고 재시작: coder-config ui stop && coder-config ui

# 프로젝트 초기화
coder-config init
# 프로젝트에 MCP 추가
...

coder-config와 claude-config 모두 동일하게 작동합니다.

coder-config init # 프로젝트 초기화
coder-config apply # 설정에서 .mcp.json 생성
coder-config show # 현재 프로젝트 설정 표시
...

coder-config memory # 메모리 상태 표시
coder-config memory init # 프로젝트 메모리 초기화
coder-config memory add <유형> "<내용>" # 항목 추가
...

coder-config env # 환경 변수 목록 표시
coder-config env set <키> <값> # .claude/.env에 변수 설정
coder-config env unset <키> # 변수 제거

coder-config project # 등록된 프로젝트 목록 표시
coder-config project add [경로] # 프로젝트 추가 (기본값은 현재 작업 디렉토리)
coder-config project add [경로] --name X # 사용자 지정 표시 이름으로 추가
...

coder-config workstream # 모든 워크스트림 목록 표시
coder-config workstream create "이름" # 새 워크스트림 생성
coder-config workstream delete <이름> # 워크스트림 삭제
...

터미널별 격리: 셸 통합을 사용하면 각 터미널이 자체 활성 워크스트림을 가질 수 있습니다:

# 터미널 1
coder-config workstream use project-a
# 터미널 2
...

활성화되면 AI는 해당 워크스트림의 디렉토리 내에서만 작업하도록 제한을 받습니다.

다중 도구 지원: 워크스트림은 Claude Code, Gemini CLI, Codex CLI와 함께 작동합니다. 선호하는 도구에 대한 훅을 설치하세요:

Claude Code 전용

coder-config workstream install-hook

Gemini CLI 전용

...

폴더 자동 활성화 (Folder auto-activation): 일치하는 디렉터리로 이동할 때 워크스트림을 자동으로 활성화합니다:

# cd 훅 설치 (기본 ~/.zshrc 또는 ~/.bashrc에 함수 추가)
coder-config workstream install-cd-hook
# 이제 프로젝트 폴더로 cd 할 때:
...

트리거 폴더 (Trigger folders): 프로젝트 경로 외에도 추가 트리거 폴더를 지정할 수 있습니다:

coder-config workstream add-trigger "My Work" ~/projects
coder-config workstream remove-trigger "My Work" ~/projects

자동 활성화 설정 (Auto-activate setting): 워크스트림별 또는 전역적으로 제어할 수 있습니다:

coder-config workstream auto-activate "My Work" on # 항상 자동 활성화
coder-config workstream auto-activate "My Work" off # 절대 자동 활성화 안 함
coder-config workstream auto-activate "My Work" default # 전역 설정 사용

coder-config registry # 전역 레지스트리에 있는 MCP 목록 보기
coder-config registry add <name> '<json>' # MCP를 전역 레지스트리에 추가
coder-config registry remove <name> # 레지스트리에서 MCP 제거

coder-config update # npm 확인 및 사용 가능한 업데이트 설치
coder-config update --check # 설치 없이 업데이트 확인
coder-config update /path/src # 로컬 개발 소스에서 업데이트

UI는 자동으로 업데이트를 확인하며, 설정(Preferences)에서 활성화하면 자동 업데이트됩니다. 서버가 업데이트된 후에는 UI가 자동으로 새로고침되어 새 버전을 불러옵니다.

coder-config ui # 포트 3333에서 UI 시작
coder-config ui --port 8080 # 사용자 지정 포트
coder-config ui /path/to/project # 특정 프로젝트 디렉터리
...

데몬 모드 (Daemon Mode): 기본적으로 coder-config ui는 백그라운드 데몬으로 실행됩니다.
UI는 홈 디렉터리에서 실행되며 터미널 세션 간에 지속됩니다. 헤더의 드롭다운을 사용하여 등록된 프로젝트 간 전환할 수 있습니다.

PWA / 자동 시작 (Auto-Start): 브라우저에 UI를 PWA로 설치한 후, coder-config ui install을 실행하여 로그인 시 서버가 자동으로 시작되도록 합니다. 사용자의 PWA는 항상 즉시 연결됩니다.

전체 기능을 사용하려면 ~/.zshrc 파일에 다음 내용을 추가하세요.

source /path/to/coder-config/shell/claude-config.zsh

이것은 다음 기능들을 활성화합니다:

터미널별 작업 흐름(Per-terminal workstreams) - workstream use 명령어를 통해 현재 터미널에서만 활성화됩니다. 자동 생성되는 .mcp.json 파일. 프로젝트에 진입할 때 .claude/mcps.json 파일을 사용합니다.

• 모든 명령어에 대한 Tab 완성 기능
• 설정 병합: 전역(Global) → 프로젝트(Project) → 하위 프로젝트(Sub-project) 순서로 적용됩니다.

~/.claude/mcps.json # Global - 모든 곳에 적용
~/projects/.claude/mcps.json # Workspace - 여기에 있는 프로젝트에 적용
~/projects/my-app/.claude/ # Project - 이 프로젝트에만 특정 적용
...

하위 프로젝트는 자동으로 감지됩니다(.git 폴더가 있는 경우). 또는 웹 UI의 "Sub-project 추가" 기능을 사용하여 원하는 폴더를 수동으로 연결할 수도 있습니다.

coder-config init 실행 후:

your-project/
├── .claude/
│ ├── mcps.json # MCP 설정
...

.claude/mcps.json:

{
"mcpServers": {
"filesystem": {
...

환경 변수는 ${VAR} 구문을 사용하며 .claude/.env 파일에서 로드됩니다.

Claude Code 세션을 위한 영구 메모리 저장소입니다.

전역(Global) (~/.claude/memory/)

프로젝트(Project) (<project>/.claude/memory/)

웹 UI를 통해 관리하거나 파일을 직접 편집할 수 있습니다.

Claude Code 세션의 컨텍스트를 저장하고 다음 세션 시작 시 복원할 수 있습니다.

컨텍스트 저장(Save context) - Claude Code에서 /flush를 사용하여 컨텍스트 요약을 작성합니다.
자동 복원(Auto-restore) - session-start 훅이 저장된 컨텍스트를 다음 세션에 주입합니다.

컨텍스트는 프로젝트별로 .claude/session-context.md에 저장됩니다.

UI에서: System > Sessions로 이동하여 "모두 설치(Install All)"를 클릭하세요.
CLI에서:

coder-config session install

이 명령어는 SessionStart 훅과 /flush 명령어를 설치합니다.

coder-config session # 세션 상태 표시
coder-config session install # 훅(hook) 및 /flush 명령어 설치
coder-config session clear # 저장된 컨텍스트 지우기

세션 컨텍스트는 각 프로젝트의 .claude/session-context.md에 저장됩니다.

워크스트림(Workstreams)은 다중 프로젝트 워크플로우를 위한 컨텍스트 세트입니다. 관련 프로젝트들을 그룹화하고, 모든 Claude 세션에 컨텍스트 규칙을 주입합니다.

여러 리포지토리(repo)에 걸쳐 여러 기능을 작업할 때 (예: REST API + UI + 공유 라이브러리), 광범위한 컨텍스트를 이해하도록 Claude에게 요청해야 합니다. Workstreams는 다음 방식으로 이를 해결합니다:

• 관련 프로젝트들을 함께 그룹화하고,
• 해당 워크플로우에 특정한 규칙을 정의하며,
• 이 규칙들을 모든 Claude 세션에 자동으로 주입합니다.

# 사용자 인증 기능을 위한 워크스트림 생성
coder-config workstream create "User Auth"
# 관련 프로젝트 추가
...

그런 다음 Web UI에서 해당 워크스트림을 편집하여 다음과 같은 규칙을 추가할 수 있습니다:

사용자 인증 흐름에 집중합니다. JWT 토큰을 사용하세요. 상태 관리는 React Query를 사용하고, 영속성은 PostgreSQL을 사용하세요.

규칙이 자동으로 주입되려면 사전 프롬프트 훅(pre-prompt hook)을 설치해야 합니다:

옵션 1: 원클릭 설치 (권장)

• Web UI 열기 → Workstreams → "Install Hook Automatically" 클릭

옵션 2: 수동 방식

# ~/.claude/hooks/pre-prompt.sh에 추가
coder-config workstream inject --silent

설치되면, 활성화된 워크스트림의 규칙이 모든 Claude 세션에 접두사(prepended)로 붙습니다.

Coder-config는 사용자가 작업하는 파일을 추적하고 패턴을 기반으로 워크스트림을 제안할 수 있습니다:

작동 방식:

• 응답 후 훅(post-response hook)이 Claude 세션 동안 접근된 파일 경로를 기록합니다.
• 공동 활동 패턴(Co-activity patterns, 함께 자주 작업하는 프로젝트)이 감지됩니다.
• 이러한 패턴을 기반으로 UI에 워크스트림 제안이 나타납니다.

설정 (선택 사항):

# 활동 추적 훅 설치
# ~/.claude/hooks/post-response.sh에 추가:
source /path/to/coder-config/hooks/activity-track.sh

Web UI에서:

• Activity Insights 패널에서 세션, 추적된 파일 및 활성 프로젝트를 확인합니다.
• 패턴이 감지되면 Suggested Workstreams가 나타납니다.
• 'Create'를 클릭하여 사전 채워진 대화 상자를 열고 (필요에 따라 프로젝트 조정 가능) 사용합니다.
• 원하지 않는 제안은 'X'를 클릭하여 해제할 수 있습니다.

추가 기능: 헤더의 프로젝트/워크스트림 전환기, 서브 프로젝트 감지, 다크 모드, 자동 업데이트.

Claude Code 플러그인은 LSP 서버, MCP 서버, 명령어 및 상시 안내 기능을 통해 기능을 확장합니다. 플러그인이 템플릿을 대체합니다 - 더 이상 오래될 수 있는 정적 파일이 아니라, 플러그인은 항상 활성화되어 자동으로 업데이트됩니다.

# coder-config 플러그인 마켓플레이스 추가
claude plugin marketplace add regression-io/claude-config-plugins
# 프레임워크별 플러그인 설치
...

웹 UI에서:

• Project Explorer를 엽니다.
• 모든 프로젝트 폴더의 + 메뉴를 클릭합니다 - **플러그인 설치(Install Plugins)**를 선택합니다 - 범위 선택(Local/User)과 함께 플러그인을 켜고 끕니다.

플러그인(Plugins) 페이지에서는 사용 가능한 모든 플러그인을 볼 수 있습니다:

• 마켓플레이스, 카테고리, 소스 유형(Anthropic/Community), 설치 상태별로 필터링합니다.
• 이름 또는 설명으로 검색합니다.
• 플러그인 세부 정보(LSP/MCP/명령어 포함)를 확인합니다.

플러그인은 마켓플레이스(Git 저장소)에서 가져옵니다:

claude-plugins-official - Anthropic의 공식 플러그인
regression-io/claude-config-plugins - 프레임워크 및 언어 플러그인
필터 드롭다운 메뉴의 "Manage Marketplaces"를 통해 커뮤니티 마켓플레이스를 추가하세요.

지원되는 마켓플레이스 형식:

owner/repo
— GitHub 약식 표기법
https://github.com/owner/repo
— 전체 URL
/local/path
— 로컬 디렉터리

웹 UI는 ~/.claude/settings.json에 대한 시각적 편집기를 제공합니다.

Claude Code가 자동으로 수행할 수 있는 작업을 구성하세요:

허용(Allow) - 질문 없이 실행되는 도구
질문(Ask) - 확인이 필요한 도구
거부(Deny) - 차단된 도구

패턴 예시: