Skip to content

macos.md

Latest commit

 

History

History
117 lines (82 loc) · 2.78 KB

macos.md

File metadata and controls

117 lines (82 loc) · 2.78 KB
Raw

macOS 安装与使用

macOS 是 Codexkimi 的优先支持平台。Key 保存在登录用户的 Keychain，不写入 shell profile、Claude 设置或仓库。

1. 准备依赖

确认以下命令可用：

git --version
python3 --version
codex --version
kimi --version
claude --version

Kimi Code CLI 和 Claude Code 请使用各自官方安装方式。

2. 克隆与安装

git clone https://github.com/wangsiyi7/Codexkimi.git ~/Developer/Codexkimi
cd ~/Developer/Codexkimi
./install.sh --check
./install.sh

安装脚本只注册当前仓库的 Codex marketplace，不写入 API Key。

3. 配置 Keychain

./plugins/codexkimi/skills/kimi-frontend/scripts/configure-kimi-k3-key.sh

脚本使用隐藏输入，并将凭据写入：

  • Service：codexkimi.kimi-k3-api-key
  • Account：当前 macOS 用户

自定义 service：

export CODEXKIMI_KEYCHAIN_SERVICE="my.codexkimi.k3"

检查但不显示 Key：

./plugins/codexkimi/skills/kimi-frontend/scripts/configure-kimi-k3-key.sh --check

4. Kimi CLI 路由

检查：

./plugins/codexkimi/skills/kimi-frontend/scripts/invoke-kimi-frontend.sh --check

调用：

./plugins/codexkimi/skills/kimi-frontend/scripts/invoke-kimi-frontend.sh \
  --working-directory "$HOME/Developer/my-app" \
  --prompt "Improve the responsive navigation and run the frontend tests."

如果需要让当前 shell 的其他进程读取 Kimi 标准变量：

source ./plugins/codexkimi/skills/kimi-frontend/scripts/enable-kimi-k3-env.sh

5. Claude Code 路由

检查：

./plugins/codexkimi/skills/kimi-claude-code/scripts/invoke-claude-kimi.sh --check

只读审查：

./plugins/codexkimi/skills/kimi-claude-code/scripts/invoke-claude-kimi.sh \
  --working-directory "$HOME/Developer/my-app" \
  --permission-mode plan \
  --prompt "Review the UI architecture and accessibility."

明确授权实现时：

./plugins/codexkimi/skills/kimi-claude-code/scripts/invoke-claude-kimi.sh \
  --working-directory "$HOME/Developer/my-app" \
  --permission-mode acceptEdits \
  --prompt "Implement the approved frontend changes and run tests."

6. 套餐与模型

  • Allegretto 及以上：默认 k3[1m]
  • 其他支持 K3 的套餐：传入 --model k3
./plugins/codexkimi/skills/kimi-claude-code/scripts/invoke-claude-kimi.sh \
  --model k3 \
  --prompt "Review this component."

7. 故障定位

  • Keychain 不可用：运行配置脚本并确认当前登录用户一致。
  • Claude 仍显示 Claude 型号：用 /status 检查 Base URL；第三方网关下显示名不一定等于实际后端。
  • Claude 登录提示：确认自定义 API Key，然后授权可信项目目录。
  • 新技能未出现：新建 Codex 任务以重新加载插件。