Codexkimi 是一个面向 macOS 和 Windows 的 Codex 插件，将 Kimi K3 接入为辅助前端设计师、主要前端实现代理，以及 Claude Code 的模型后端。Codex 负责范围控制、代码审查、测试与最终验收。
- macOS 优先：Keychain、
zsh/bash、install.sh和原生 shell 路由 - Windows：DPAPI、PowerShell 和维护者 D 盘存储边界
- Kimi Code CLI：前端设计、实现、响应式、交互和无障碍优化
- Claude Code：通过官方 Kimi Claude 兼容端点运行 K3 或
k3[1m] - 安全凭据：环境变量 → Keychain/DPAPI → Kimi OAuth
- 一键发布：校验、密钥扫描、版本更新、提交、推送、打包和 GitHub Release
- 双技能自动触发：
$kimi-frontend与$kimi-claude-code
flowchart LR
U["Codex 用户任务"] --> C["Codex 范围控制与验收"]
C --> F["$kimi-frontend"]
C --> CC["$kimi-claude-code"]
F --> KCLI["Kimi Code CLI"]
CC --> CLAUDE["Claude Code CLI"]
KCLI --> K3["Kimi K3 API"]
CLAUDE --> K3
KC["macOS Keychain"] --> K3
DP["Windows DPAPI"] --> K3
ENV["运行时环境变量"] --> K3
依赖：
- macOS
- Git、Python 3
- Codex CLI / Codex 桌面版
- Kimi Code CLI
- Claude Code
- GitHub CLI（只有发布者需要）
git clone https://github.com/wangsiyi7/Codexkimi.git ~/Developer/Codexkimi
cd ~/Developer/Codexkimi
./install.sh --check
./install.sh将 Kimi Key 保存到 macOS Keychain：
./plugins/codexkimi/skills/kimi-frontend/scripts/configure-kimi-k3-key.sh检查 Kimi 路由：
./plugins/codexkimi/skills/kimi-frontend/scripts/invoke-kimi-frontend.sh --check检查 Claude Code + K3 路由：
./plugins/codexkimi/skills/kimi-claude-code/scripts/invoke-claude-kimi.sh --check完整说明见 macOS 指南。
维护者机器上的仓库、Kimi 数据、缓存和构建输出必须位于 D:\：
git clone https://github.com/wangsiyi7/Codexkimi D:\vibecoding\Codexkimi
Set-Location D:\vibecoding\Codexkimi
.\install.ps1 -Check
.\install.ps1配置 DPAPI 凭据：
& .\plugins\codexkimi\skills\kimi-frontend\scripts\configure-kimi-k3-key.ps1详细说明见 Windows 指南。
Codexkimi 不会将真实 Key 写入 Git、Claude 设置、Kimi TOML 或 shell profile。
Kimi CLI 路由优先级：
KIMI_MODEL_API_KEY- macOS Keychain 或 Windows DPAPI
- Kimi OAuth
Claude Code 路由优先级：
ANTHROPIC_API_KEYKIMI_MODEL_API_KEY- macOS Keychain 或 Windows DPAPI
自动化和 CI 应由平台 Secret 注入空白示例中的变量，不要提交真实 .env：
KIMI_MODEL_API_KEY=
ANTHROPIC_API_KEY=
Kimi 官方 Claude Code 配置使用：
ANTHROPIC_BASE_URL=https://api.kimi.com/coding/ANTHROPIC_MODEL=k3[1m]- 1M 上下文窗口：
1048576
Allegretto 及以上套餐可使用 k3[1m]；其他套餐可把模型改为 k3。
macOS：
./plugins/codexkimi/skills/kimi-claude-code/scripts/invoke-claude-kimi.sh \
--working-directory "/path/to/project" \
--permission-mode plan \
--prompt "Review this frontend implementation."Windows：
& .\plugins\codexkimi\skills\kimi-claude-code\scripts\invoke-claude-kimi.ps1 `
-WorkingDirectory "D:\path\to\project" `
-PermissionMode plan `
-Prompt "Review this frontend implementation."这不是“Claude 模型的独立意见”：Claude Code 只作为代理外壳，推理模型是 Kimi K3。更多信息见 Claude Code 集成。
新建 Codex 任务后直接描述：
使用 Kimi K3 作为辅助前端设计师，实现这个页面并由 Codex 审查和测试。
显式选择 Kimi CLI：
使用
$kimi-frontend完成这个 React 页面。
显式选择 Claude Code 外壳：
使用
$kimi-claude-code让 Claude Code 通过 Kimi K3 审查这个页面。
只做发布预检，不产生外部变更：
./scripts/publish-plugin.sh --tag v0.2.0macOS 一键发布：
./scripts/publish-plugin.sh \
--tag v0.2.0 \
--message "publish macOS and Claude Code support" \
--publishWindows 一键发布：
.\scripts\publish-plugin.ps1 `
-Tag v0.2.0 `
-Message "publish macOS and Claude Code support" `
-Publish发布器会：
- 验证仓库、插件和技能结构
- 扫描常见 Key、GitHub Token、
.env和 DPAPI 文件 - 更新插件 SemVer 与 Codex cachebuster
- 暂存并提交当前插件仓库
- 推送
main - 生成
dist/codexkimi-vX.Y.Z.zip - 创建或更新 GitHub Release
完整边界见 发布指南。
跨平台：
python3 scripts/validate_repository.pyWindows 额外验证：
.\scripts\validate-repository.ps1Codexkimi/
├── .agents/plugins/marketplace.json
├── .github/workflows/validate.yml
├── docs/
├── plugins/codexkimi/
│ ├── .codex-plugin/plugin.json
│ └── skills/
│ ├── kimi-frontend/
│ └── kimi-claude-code/
├── scripts/
│ ├── publish_plugin.py
│ ├── publish-plugin.ps1
│ ├── publish-plugin.sh
│ ├── validate_repository.py
│ └── validate-repository.ps1
├── install.ps1
└── install.sh
- 不要在 Issue、提交、日志、截图或对话中粘贴真实 Key。
- 已公开的 Key 应立即撤销并重新创建。
- Keychain/DPAPI 凭据不在仓库目录内，并被密钥扫描规则防护。
- Claude 和 Kimi 的变量只在调用进程内设置并在结束后恢复。
- 安全问题请参阅 SECURITY.md。