atticus98/codex-turbo

English | 简体中文

본 저장소는 Codex CLI의 개인 설정 템플릿 모음입니다. “경량화 및 고효율” 원칙을 고수하며, 복잡한 의존성을 도입하지 않고 CLI의 **네이티브 능력 (Native Capability)**을 깊이 있게 활용하여, 멀티 에이전트 (Multi-agent) 협업을 통해 효율적인 작업 스케줄링을 구현합니다. 이 설정 세트는 개인적인 실습 공유를 목적으로 하며, 여러분이 자신에게 가장 적합한 AI 워크플로우 (Workflow)를 구축하는 데 마중물 (抛砖引玉) 역할을 할 수 있기를 바랍니다.

💡

어떻게 조작해야 할지 모르겠나요? 프로젝트 주소를 AI 어시스턴트(예: Claude Code CLI, Codex CLI 등)에게 보내어, 실제 상황에 맞춰 병합하거나 새로 생성하도록 요청할 수 있습니다.

현재 프로젝트 적응 버전:

Codex CLI v0.120.0

• 💡
  병렬 워크플로우 (Parallel Workflow): multi_agent = true

최대 병렬도 및 최소 차단 설계 - 🔧
시스템 레벨 계약 (System-level Contract): config.toml 내의 developer_instructions를 통해 에이전트 (Agent) 병렬 작업 규범을 주입하며, 이는 AGENTS.md보다 우선순위가 높습니다.

• 🧠
  네이티브 메모리 (Native Memory): memories = true

대화 메모리를 자동으로 추출 및 병합하여 문맥의 일관성 (Context Coherence)을 향상시킵니다. - 🎯
상호작용 스타일 (Interaction Style): Codex의 네이티브 출력 방식인 “긴 문장의 나열, 경로 과다, 시각적 압박”으로 인한 터미널 읽기 재앙을 해결하기 위해, Claude Code 스타일과 깊게 정렬되었습니다. 강제 줄바꿈, 시각적 앵커(Visual Anchor), 그리고 극도로 간결한 단문을 통해 혼란스러운 콘솔 정보를 계층이 명확하고 생동감 있으며 직관적인 대화 경험으로 전환합니다.

terminal-dialog-style 기술을 적용하면 콘솔 출력이 더욱 명확해지며, 계층화된 실행 피드백과 레이아웃 효과를 지원합니다:

.
├── README.md # 중국어 문서 (본 페이지)
├── README.en.md # English Documentation
...

관련 문서

목표: 당신의 Codex CLI를 "병렬 + 템플릿화" 작업 모드로 전환하십시오.

git clone <your-repo-url>
cd codex-turbo

본 저장소는 다음 템플릿 파일을 제공합니다:

파일	용도	대상 위치
templates/cn/config.template.toml	핵심 시스템 설정 (developer_instructions 병렬 작업 규범 포함)	~/.codex/config.toml
templates/cn/AGENTS.template.md	개발 원칙 및 출력 스타일 가이드	~/.codex/AGENTS.md
templates/cn/agents/	서브 에이전트 (Sub-agent) 설정 (explorer, worker)	~/.codex/agents/
templates/cn/skills/	스킬 템플릿 (terminal-dialog-style 등)	~/.codex/skills/

config.toml은 서비스 제공업체의 요구사항에 따라 key 등 공급업체 정보를 직접 완성해 주세요.

처음 사용하는 경우 (직접 복사):

# 대상 디렉토리 생성 (존재하지 않을 경우)
mkdir -p ~/.codex
# 핵심 설정 파일 복사
...

기존 설정이 있는 경우 (수동 병합): → [설정 마이그레이션 가이드] 참조

설명: 본 문서는 Codex CLI v0.120.0에 맞춰 작성되었습니다. 버전이나 공급업체에 따라 필드명이 다를 수 있으므로, 로컬 CLI 지원 내용을 기준으로 삼으시기 바랍니다.

Q1: multi_agent를 켜면 반드시 빨라지나요?

반드시 그렇지는 않습니다. 작업이 분할 가능하고 쓰기 충돌 (Write Conflict)이 없을 때만 눈에 띄는 속도 향상이 있습니다.

Q2: 서브 에이전트를 사용하면 어떤 장점이 있나요?

문맥 격리 (Context Isolation) — 서브 에이전트가 독립적인 문맥을 가져 메인 에이전트의 문맥 폭발을 방지합니다.
책임 집중 (Focus of Responsibility) — 각 서브 에이전트가 단일 작업만 처리하여 출력이 더 정밀해집니다.
병렬 효율성 (Parallel Efficiency) — 독립적인 작업을 병렬로 실행하여 전체 소요 시간을 단축합니다.

Q3: 서브 에이전트를 쓰면 비용이 증가하나요?

네. 서브 에이전트를 활성화하면 비용이 20%~30% 정도 상승할 수 있으며, 구체적인 상승 폭은 프로젝트 규모와 작업 복잡도에 따라 다릅니다.

Q4: 서브 에이전트는 몇 개가 적당한가요?

기본 설정을 권장하며, 품질과 비용을 관찰한 후 점진적으로 조정하십시오.

Q5: 서브 에이전트 모델과 메인 에이전트 모델이 다르면 어떻게 하나요?

worker.toml 또는 explorer.toml의 model 필드를 통해 개별적으로 지정할 수 있습니다.

Q6: 이 템플릿이 모든 사람에게 적합한가요?

아닙니다. 이것은 시작점으로서의 템플릿이며, 팀의 습관에 맞춰 점진적으로 다듬어 사용하는 것이 가장 좋습니다.

본 저장소는 설정 방법론과 템플릿 참조를 제공하며, Codex CLI v0.120.0을 기반으로 검증되었습니다.

비용 주의사항: 멀티 에이전트 병렬 모드에서는 토큰 (Token) 소모가 20%~30% 증가할 수 있으므로, 실제 상황에 맞춰 합리적으로 평가하여 사용하십시오.

위험 주의사항: LLM은 잘못된 판단을 내릴 수 있으며, 이로 인해 데이터가 잘못 삭제되거나 코드가 잘못 수정될 수 있습니다. 권장 사항:

• 샌드박스 (Sandbox) 권한 및 작업 확인 메커니즘을 합리적으로 구성하십시오.
• 통제 가능한 환경에서 먼저 테스트하십시오.
• 중요한 데이터는 반드시 백업해 두십시오.

본 템플릿을 사용하여 발생하는 모든 결과에 대한 책임은 사용자 본인에게 있습니다.