Codex-Dream-Skin

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #go #golang #android #rust #macos #awesome #cli #awesome-list #pytorch #mcp #ios

Codex-Dream-Skin

(★ 13,789)

Codex Dream Skin

Codex-Dream-Skin 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Codex Dream Skin

[中文](./README.md) · **English**

**Codex 데스크톱에 숨쉬는 얼굴을 부여하세요.**  
외부 테마 / 스킨 변경 도구 · 로컬 CDP 인젝션 · 공식 설치 패키지 수정 없음

하나의 이미지, 하나의 감성 · 코딩을 할 때도 분위기를 더해보세요.

공식 테마 라이브러리: [**DreamSkin.cc**](https://dreamskin.cc) ·
[테마 라이브러리 Gallery](https://dreamskin.cc/gallery) ·
[온라인 Studio](https://dreamskin.cc/studio)

OpenAI 공식 제품이 아닙니다. `.app` / `app.asar` / WindowsApps를 수정하지 않습니다.

## 🤝 단독 스폰서

|  |  |
| --- | --- |
| [Passion8](https://passion8.cc/sign-up?aff=ZgLT) | Passion8의 본 프로젝트 단독 스폰서십에 감사드립니다! Passion8은 개발자를 위한 AI API 중계 서비스 제공업체로, 개인 개발자와 팀에게 안정적이고 저렴한 주류 대형 모델 연동을 제공합니다.   **만족스러운 AI · 손쉬운 접근**: OpenAI, Claude 전 시리즈 정품 모델 제공, 성능 저하 없음, 껍데기만 씌운 가짜 아님; 최신 AI 모델을 공식 가격의 극히 일부로 이용 가능, 1:1 충전, **1$ = 1¥**. 기존 공식 SDK를 유지하면서 Base URL만 Passion8로 변경하면 Claude Code, Codex, Grog 및 임의의 OpenAI 호환 클라이언트에서 바로 실행 가능 — 한 줄의 설정으로 코드는 수정할 필요가 없습니다. **글로벌 노드 가속**: Cloudflare 글로벌 엣지 + 다중 회선 BBR 가속, 저지연, 고가용성, 변함없는 안정성; 7×24 안정적인 중계, 99.9% SLA, 첫 토큰 목표 1초 이내. **안전하고 신뢰할 수 있음**: 독립적인 API Key, 키 암호화 저장, 전 구간 HTTPS, 프라이버시 우선.   Passion8은 본 프로젝트 사용자를 위한 전용 혜택을 준비했습니다: [해당 링크](https://passion8.cc/sign-up?aff=ZgLT)를 통해 가입 시 첫 충전 금액의 10%가 자동으로 적립되며, 별도 신청 없이 30분 이내에 지급됩니다. 문의 사항은 [support@passion8.cc](mailto:support@passion8.cc)로 연락해 주세요. |

스킨 변경과 API 설정은 서로 독립적이며, 본 프로젝트는 사용자의 모델 공급업체 설정을 자동으로 변경하지 않습니다.
## 바로 설치
일반 사용자는 공식 Codex / ChatGPT를 먼저 설치한 후 한 번 실행하고 종료한 다음,
[GitHub Releases](https://github.com/Fei-Away/Codex-Dream-Skin/releases)에서 다운로드하면 됩니다:
- macOS: `CodexDreamSkin-vX.Y.Z.dmg`를 열고 App을 Applications 폴더로 드래그합니다.
- Windows: `CodexDreamSkin-Setup-vX.Y.Z.exe`를 더블클릭하고 설치 마법사의 안내를 따릅니다.
소스 코드를 clone하거나 Node.js를 설치하거나 `.sh` / `.ps1`을 수동으로 실행할 필요가 없습니다. 최초 실행 시 서명 우회 허용, 업데이트 및 제거 방법에 대한 자세한 내용은
[macOS 설치 안내](./docs/install-macos.md) / [Windows 설치 안내](./docs/install-windows.md)를 참조하세요.
## 테마 라이브러리 및 커뮤니티

[![DreamSkin.cc](docs/images/dreamskin-mark.svg)](https://dreamskin.cc)

**DreamSkin.cc** · 본 프로젝트의 공식 테마 라이브러리 및 창작 플랫폼  
Make your workspace *yours.*

[**테마 라이브러리 탐색 →**](https://dreamskin.cc/gallery)
 · 
[**온라인 Studio →**](https://dreamskin.cc/studio)

- [\*\*테마 라이브러리 Gallery\*\*](https://dreamskin.cc/gallery): 커뮤니티에서 검토된 테마를 탐색하며, 최신순 / 인기순 정렬 및 크리에이터 순위를 지원합니다.
모든 테마는 웹페이지 내의 데스크톱 시뮬레이터에서 미리 입어본 후 설치 여부를 결정할 수 있습니다.

|  |  |
| --- | --- |
| 커뮤니티 테마 「오공(WUKONG)」의 데스크톱 시뮬레이터 실제 적용 모습  「오공(WUKONG)」by JamesOpsLab | 커뮤니티 테마 「DeepSeek-고래소녀」의 데스크톱 시뮬레이터 실제 적용 모습  「DeepSeek-고래소녀」by powerdog996 |

- [\*\*온라인 Studio\*\*](https://dreamskin.cc/studio): 브라우저에서 배경 이미지를 변경하고, 테마 색상을 조절하며, Safe CSS를 작성하고, `.zip` 테마 패키지를 내보내거나,
테마 라이브러리에 직접 투고할 수 있습니다(로그인 필요, 관리자 검토 후 공개).

![DreamSkin.cc 온라인 Studio에서 설정한 커스텀 배경 효과](docs/images/studio-custom-look.png)
  
온라인 Studio · 마음에 드는 배경 이미지로 바꾸고, 초점과 배색을 조절하여 나만의 테마를 만들어보세요.

macOS 메뉴 바와 Windows 트레이에 모두 「테마 라이브러리 Gallery」와 「온라인 Studio」 진입점이 있어 바로 열 수 있습니다.
### 원클릭 스킨 변경
DreamSkin.cc에서 마음에 드는 테마를 발견하면「원클릭 스킨 변경」을 클릭하여 로컬 클라이언트에 직접 적용할 수 있으며, 먼저 다운로드하여 수동으로 가져올 필요가 없습니다.
v1.5.0 이상 버전의 클라이언트가 필요합니다(v1.5.5 이상 권장).
프로세스 및 보안 경계:
- 웹페이지는 `dreamskin://apply?version=ver\_...`를 통해 로컬 App을 호출합니다. 링크에는 하나의 테마 버전 ID만 포함될 수 있으며, 임의의 URL, 파일 경로 또는 명령어를 포함할 수 \*\*없으며\*\* 조용한(silent) 적용 파라미터도 존재하지 않습니다.
- App은 고정된 공식 API에서만 패키지를 가져오며 리디렉션을 거부합니다.
- 스킨 변경 전 네이티브 확인창이 나타나며, 해당 버전의 검토 상태, 원클릭 호환성 태그, 버전 번호, 패키지 크기, 실제 다운로드 바이트 및 SHA-256을 대조합니다.
- 승인 후 수동 가져오기와 완전히 동일한 ZIP, manifest, 이미지 및 Safe CSS 검증을 재사용합니다.
- 실제 렌더링 프로세스에서 새 테마가 적용되었음을 확인해야 성공으로 간주됩니다. 시작 또는 렌더링 실패 시 스킨 변경 전 테마로 복구를 자동으로 시도하며, 복구 결과 역시 가시성 검증을 거쳐야 합니다. 확인이 불가능할 경우 복구된 것처럼 위장하지 않고 상태 미확인을 명확하게 보고합니다.
현재 테마 패키지 규격(배경 이미지 + `theme.json` + 빈 값이 아닌 `theme.css` + `safe-css` 기능 선언)을 완벽히 충족하는 테마에만 원클릭 스킨 변경 버튼이 표시되며, 충족하지 않는 경우 아래의 수동 가져오기를 사용하세요.
## 실측 검증 추천 프리셋
### Gothic Void Crusade / 고딕 헛된 성전
\*\*세련되고 분위기 넘치는 이 오리지널 고딕 SF 작품을 디자인하고 기여해 주신 [@seansong-ideogram](https://github.com/seansong-ideogram)님께 특별히 감사드립니다.\*\* 이 프리셋은 현재 실측 검증된 첫 번째 프리셋이며, macOS 새로 설치 시 기본으로 활성화되는 테마입니다.

![고딕 헛된 성전 테마 실제 적용 효과](docs/images/presets/gothic-void-crusade-preview.jpg)  
실제 Codex 홈 화면 인젝션 효과 (미리보기 전용)

설치 후 macOS 메뉴 바의 「저장된 테마」에서 바로 전환할 수 있습니다.
### Hashimoto Arina / 하시모토 아리나
아래의 「Hashimoto Arina」 테마는 실제 Codex 홈 화면에서 라이트 모드와 다크 모드 외관이 각각 검증되었습니다. 사용자가 제공한 원본 PNG는 `1672 × 941`이며, 테마 패키지는 원본 이미지의 16:9에 가까운 구도를 유지하면서 파생 수출된 `2560 × 1440` JPEG를 사용하며, 원본 이미지의 디테일이 추가되었음을 의미하지는 않습니다. 스크린샷의 사이드바, 카드, 프로젝트 선택 및 입력창은 모두 Codex 네이티브 컨트롤입니다.

![하시모토 아리나 테마 라이트 모드 실제 적용 효과](docs/images/presets/arina-hashimoto-light.jpg)  
라이트 모드 · 실제 인젝션 스크린샷 (전송되지 않은 입력 내용은 스크린샷 촬영 시 가려졌으며, 미리보기 전용입니다)

![하시모토 아리나 테마 다크 모드 실제 적용 효과](docs/images/presets/arina-hashimoto-dark.jpg)  
다크 모드 · 실제 인젝션 스크린샷 (전송되지 않은 입력 내용은 스크린샷 촬영 시 가려졌으며, 미리보기 전용입니다)

이 릴레이션 캐릭터 소스 소재는 소스 코드 저장소에 참고 및 권리 검증용으로만 남겨두며, 공개 DMG / Setup.exe에는 포함되지 않습니다. 공개 설치 프로그램에는 배포가 확인된 Gothic Void Crusade만 미리 포함됩니다. 일반 사용자는 메뉴의 '배경 이미지 변경'을 통해 자신이 사용할 권리가 있는 순수 배경을 가져올 수 있으며, 저장 후 계속해서 원클릭으로 전환할 수 있습니다.
> 다운로드 가능한 사용자 소스 이미지는 [`docs/images/presets/arina-hashimoto-source.png`](./docs/images/presets/arina-hashimoto-source.png) (`1672 × 941`)이며, 소스 코드 참고 프리셋은 [`macos/presets/preset-arina-hashimoto/background.jpg`](./macos/presets/preset-arina-hashimoto/background.jpg) (정규화 파생 `2560 × 1440`)를 사용합니다. 위의 두 렌더링 이미지에는 실제 UI가 포함되어 있으며, \*\*미리보기용으로만 사용해야 하며 절대 배경으로 가져와서는 안 됩니다\*\*. 배경은 사용자가 제공한 AI 생성 예시이며, OpenAI/Codex의 공식 시각 자료나 보증을 의미하지 않습니다. 인물 및 소재의 권리가 확인되기 전에는 이를 공개 설치 패키지에 포함할 수 없습니다.

## 주요 기능
- \*\*진짜 인터랙티브\*\* : 사이드바, 제안 카드, 프로젝트 선택, 입력창 모두 전체 창을 가짜 스크린샷으로 덮어씌운 것이 아닌 네이티브 컨트롤입니다.
- \*\*진짜 배경 레이어\*\* : 16:9 순수 벽지가 창 전체를 연속으로 채우며, 홈 화면에서는 분위기를 강조하고 작업 화면에서는 간섭을 자동으로 줄여줍니다.
- \*\*이미지 변경 가능\*\* : 마음에 드는 순수 배경으로 교체하면, 초점, 안전 영역, 색상 조절이 자동으로 적용되어 나만의 테마가 됩니다.
- \*\*테마 저장 가능\*\* : macOS 메뉴 바와 Windows 시스템 트레이 모두에서 로컬 테마를 저장/전환할 수 있습니다.
- \*\*원클릭 스킨 변경\*\* : [DreamSkin.cc](https://dreamskin.cc)에서 클릭 한 번으로, 클라이언트가 출처와 체크sum을 확인한 후 즉시 설치합니다.
- \*\*테마 패키지 가져오기 가능\*\* : 양쪽 모두 일반 `.zip` 파일을 직접 선택할 수 있으며, 보안 검증 후 로컬 테마 라이브러리에 추가됩니다.
- \*\*복원 가능\*\* : 원클릭으로 공식 외관으로 복원합니다.
- \*\*상대적 안전성\*\* : 로컬 호스트 루프백 CDP 인주입 방식을 사용하여 공식 바이너리와 서명을 변경하지 않습니다.

## 빠른 시작
### 일반 사용자: 설치 패키지 다운로드
git clone이나 Node.js 설치, `.sh` / `.ps1` 실행이 필요 없습니다.
[GitHub Releases](https://github.com/Fei-Away/Codex-Dream-Skin/releases)에서 각 플랫폼에 맞는 최신 설치 패키지를 다운로드하고, 플랫폼 문서에 따라 그래픽 인터페이스 설치를 완료하세요:

| 플랫폼 | 다운로드 | 설치 설명 |
|------|------|----------|
| macOS | `CodexDreamSkin-vX.Y.Z.dmg` | [`docs/install-macos.md`](./docs/install-macos.md) |
| Windows | `CodexDreamSkin-Setup-vX.Y.Z.exe` | [`docs/install-windows.md`](./docs/install-windows.md) |

설치 후 메뉴 바(macOS) 또는 시스템 트레이(Windows)에서 사용하세요. 업데이트 시 새 설치 패키지를 다운로드하여 덮어쓰기 설치하면 테마와 이미지가 유지됩니다. 일부 시스템에서는 서명되지 않은 새로 다운로드한 파일에 대해 보안 경고가 한 번 다시 나타날 수 있으며, 문서에 해제 방법이 기재되어 있습니다.

### 다운로드한 테마 가져오기
DreamSkin.cc에서 테마를 설치할 때는 [원클릭 스킨 변경](#원클릭-스킨-변경)을 우선적으로 사용하세요. 아래는 `.zip` 파일을 수동으로 가져오는 안전 경로이며, 다른 출처의 테마 패키지에도 적용됩니다.

macOS 메뉴 바에서 “테마 ZIP 가져오기…”를 선택하거나, Windows 트레이에서 같은 이름의 메뉴를 선택하세요. 일반 `.zip` 파일만 지원하며, `.dreamskin` 확장자는 지원하지 않고 확장자만 바꿔서 위장해서도 안 됩니다. 정식 Studio 테마 패키지에는 `manifest.json`, `theme.json`, 비어 있지 않은 `theme.css`, 그리고 정확히 한 장의 `background.webp|jpg|png`가 포함되어야 합니다. 또한 `LICENSE.txt`와 미리 준비된 `manifest.sig`가 포함될 수 있습니다. 이 파일들은 ZIP 루트 디렉토리나 단일 계층의 테마 디렉토리에 위치할 수 있습니다. 가져오기 도구는 적용 플랫폼, 최소 클라이언트 버전, 그리고 매니페스트에 있는 각 페이로드 파일의 크기와 SHA-256을 대조하여 확인합니다. `theme.css`는 로컬 Safe CSS 검증을 통과해야 하며, 가져온 후에는 등록된 12개의 컴포넌트에만 적용됩니다. 전환/적용할 때마다 다시 검증됩니다. `manifest.sig`는 현재 서명 검증에 참여하지 않습니다.

로컬 간소화 ZIP 역시 비어 있지 않은 `theme.json`, 비어 있지 않은 `theme.css` 및 그 참조 이미지를 정확히 포함해야 합니다. 이 형식은 정식 매니페스트의 무결성 및 호환성 선언이 없으므로 신뢰할 수 있는 출처에서만 사용해야 합니다. 압축 파일은 최대 32 MiB, 최대 32개 항목, 압축 해제 후 최대 64 MiB까지만 허용됩니다.

가져오기가 성공하면 테마가 “저장된 테마”에만 추가되며 현재 테마를 자동으로 교체하지 않습니다. 동일한 내용은 중복으로 쓰여지지 않습니다. 동일 ID의 새 버전은 기존 디렉토리 신원을 확인한 후 제자리에서 업데이트되며, 시맨틱 지문이 완전히 일치하고 동일한 테마에 속하는 것으로 확인된 구버전 `-2`/`-3` 중복 디렉토리만 정리합니다. 신원을 확인할 수 없는 경우 덮어쓰기를 거부하며, 이름을 추측하여 다른 테마를 삭제하지도 않습니다.

먼저 수동으로 압축을 해제한 다음, `theme.json`, `theme.css` 및 배경 이미지가 포함된 전체 테마 디렉토리를 로컬 테마 라이브러리로 이동할 수도 있습니다:
- macOS: `~/Library/Application Support/CodexDreamSkinStudio/themes/`
- Windows: `%LOCALAPPDATA%\CodexDreamSkin\themes\`

메뉴에 “테마 폴더 열기” 빠른 진입 경로가 있습니다. 이동 후 메뉴/트레이를 다시 열면 반영됩니다. 디렉토리 계층을 한 겹 더 만들거나 링크, 중첩 압축 파일, 삼신기(세 필수 파일)가 누락된 폴더를 넣지 마세요. 수동 디렉토리는 ZIP 가져오기 도구의 아카이브 검증을 거치지 않으므로 신뢰할 수 있는 콘텐츠만 사용하세요. 업그레이드 전에 저장되었고 CSS가 없는 레거시 테마는 여전히 전환할 수 있지만 추가 CSS는 주입되지 않습니다.

### 개발자: 소스 코드에서 실행
저장소에는 플랫폼별로 준비된 스크립트가 포함되어 있습니다(구현 세부 사항은 다르지만 효과는 모두 "Codex 테마화"입니다):

| 플랫폼 | 디렉토리 | 진입점 |
|------|------|------|
| Apple Silicon / Intel Mac | [`macos/`](./macos/) | `Install Codex Dream Skin.command` 더블 클릭 |
| Windows | [`windows/`](./windows/) | `scripts/install-dream-skin.ps1` → `start-dream-skin.ps1` |

상세 설명:
- Mac: [`macos/README.md`](./macos/README.md)
- Windows: [`windows/README.md`](./windows/README.md)
- 경로 대조: [`docs/platforms.md`](./docs/platforms.md)
- 바로 복사해서 사용할 수 있는 참고 이미지 생성 템플릿: [`docs/reference-background-prompt-guide.md`](./docs/reference-background-prompt-guide.md)
- 8가지 컨셉 방향 상세 프롬프트: [`docs/background-generation-prompts.md`](./docs/background-generation-prompts.md)
- 프로젝트 기록: [`docs/PROJECT.md`](./docs/PROJECT.md)

## 피드백 및 기여
- \*\*Issue:\*\* [Issue 템플릿](./.github/ISSUE\_TEMPLATE/)을 사용해 주세요(Bug / 기능). 빈 Issue는 닫힙니다. 제출하기 전에 Verify / Restore 자체 검사를 먼저 실행하는 것을 권장합니다.
- \*\*PR:\*\* [PR 템플릿](./.github/pull\_request\_template.md)에 따라 변경 사항을 명확히 작성하고, 해당 자체 테스트(예: `macos/tests/run-tests.sh`, verify / restore)를 체크해주세요.

## 보안 경계
- CDP는 `127.0.0.1`에만 바인딩되지만 \*\*신원 인증이 없습니다\*\*. 동일한 컴퓨터의 다른 프로세스가 여전히 연결하여 renderer를 읽거나 제어할 수 있습니다.
- 테마를 일시 중지하거나 인젝터만 중지한다고 해서 이미 실행된 Codex의 디버그 포트가 닫히지는 않습니다. 전체 Restore/재시작을 사용하거나 모든 Codex를 종료한 후 공식 일반 진입점에서 다시 열어야 위험 창이 종료됩니다.
- 공식 설치 디렉토리와 코드 서명을 수정하지 않습니다.
- API Key / Base URL을 자동으로 변경하지 \*\*않습니다\*\*. 중계와 스킨 변경은 분리되어 있습니다.
- 전체 위협 모델 및 운영 권장 사항은 [`SECURITY.md`](./SECURITY.md)를 참고하세요.

## 라이선스 및 고지 사항
- [`macos/LICENSE`](./macos/LICENSE) (MIT) 및 [`macos/NOTICE.md`](./macos/NOTICE.md) 참고
- OpenAI 공식 제품이 아니며, Codex 및 관련 권리는 해당 권리자에게 있습니다.
- 저장소에 포함된 프리셋 및 렌더링 이미지 속 인물 / IP 소재는 테마 예시용일 뿐입니다. 상업적 이용 또는 공개 재배포 시 초상권, 소재 및 상표권을 직접 확인하시기 바랍니다.

---
Star를 누르고, 이미지를 골라 오늘의 원하시는 모습으로 Codex를 바꿔보세요.

Codex-Dream-Skin

Codex-Dream-Skin 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Codex-Dream-Skin

Codex-Dream-Skin 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README