open·kritt AI 模型接入配置教程：Codex、Claude、OpenRouter、xAI 四通道实战

open·kritt AI 模型接入配置教程Codex、Claude、OpenRouter、xAI 四通道实战【免费下载链接】open-krittOpen-source, self-hosted AI vulnerability research tool that orchestrates agents to find and validate security issues in code.项目地址: https://gitcode.com/gh_mirrors/op/open-krittopen·kritt 是一款开源、可自托管的 AI 漏洞研究工具它通过编排多个 AI Agent 自动发现并验证代码中的安全问题。要让它跑起来核心一步就是完成AI 模型接入open·kritt 支持Codex、Claude Code、OpenRouter、xAIGrok四通道只需配置其中任意一个即可开始扫描也可以同时配置多个、在每次任务中灵活切换。本文用先对比选型 → 走通用流程 → 分通道实操 → 验证排错的顺序带你快速完成 open·kritt 模型提供商接入配置。一、四通道 AI 模型接入方式对比先选对通道再动手在动手之前先用一张表搞清楚四条通道的接入方式和模型来源提供商接入方式模型列表来源推荐场景CodexChatGPT 设备登录推荐或 OpenAI Platform API Key按登录账号加载可用模型本地交互使用首选ClaudeClaude 订阅登录或ANTHROPIC_API_KEY订阅用sonnet/opus别名API Key 走 Anthropic Models API已订阅 Claude 的用户OpenRouterOPENROUTER_API_KEY引擎定期刷新的可搜索目录支持手填精确模型 ID一把钥匙访问多家模型xAIGrok 设备登录或XAI_API_KEY带 Key 时有可搜索目录默认模型grok-4.6想用 Grok 系列模型四条通道默认对应的 Agent 运行框架harness分别是Codex →codexClaude 与 OpenRouter →claude-codexAI →grok-build。扫描时无需关心细节open·kritt 会自动选择兼容的 harness。选型建议有 ChatGPT 订阅选 Codex 登录有 Claude 订阅选 Claude 登录想一个 Key 打天下选 OpenRouter偏爱 Grok 模型选 xAI。二、通用接入流程三步完成任意通道的模型接入无论走哪条通道open·kritt 的接入流程都遵循setup 配置凭证 → start 启动 → setup 验证三步官方文档见 docs-site/ai-provider-setup/overview.mdx。第 1 步打开接入向导在仓库根目录执行./kritt setup第 2 步选择一种接入方式向导中可选Codex login、OpenAI API key、Anthropic API key、OpenRouter API key、xAI API key等选项按下一节对应通道的说明填入凭证即可。API Key 类配置由 CLI 写入仓库的.env文件设备登录类凭证存放在.data/下的专属目录如.data/codex、.data/claude、.data/grok这些目录均被 Git 忽略不会误提交。第 3 步启动或重建服务栈./kritt start如果服务已在运行先按CtrlC停掉再启动——已运行的容器不会读取新改动的.env必须重建后才生效。第 4 步验证再次运行./kritt setup确认所选方式显示为present。之后创建工作流、Post-script 或新扫描时表单只会列出已检测到的提供商。⚠️安全提醒.env与.data/里的登录文件等同于密码切勿提交、粘贴到 Issue 或分享给他人凭证一旦泄露应立即吊销并更换。三、Codex 通道ChatGPT 设备登录推荐或 API KeyCodex 通道的配置细节在 docs-site/ai-provider-setup/codex.mdx。3.1 推荐ChatGPT 设备登录该流程使用临时引擎容器完成设备认证无需在宿主机安装 Codex也绕开了浏览器回调容器localhost的坑./kritt setup→ 选择Codex login→ 选择Sign in with Docker打开 Codex 打印的 URL登录拥有 Codex 权限的 ChatGPT 工作区输入一次性验证码回到 CLI看到Codex login present即成功凭证默认保存在./.data/codex/auth.json并挂载进引擎./kritt start启动服务。若宿主机已有可读的~/.codex/auth.json也可选择Import local login直接导入比手动cp更安全CLI 会处理好目录属主与权限。3.2 备选OpenAI Platform API Key在 OpenAI 平台创建 API Key 并确认组织已配置账单后在./kritt setup中选择OpenAI API key或Codex API key粘贴密钥即可。注意ChatGPT 订阅与 OpenAI Platform 是两套独立的账户与计费体系订阅不会为 API 账户充值。登录成功后Accounts → Codex页面还能查看每周用量窗口、用Start quota刷新用量或在有手动重置额度时Use reset消耗一次额度。四、Claude 通道订阅登录或 Anthropic API KeyClaude 通道走 Claude Code harness详见 docs-site/ai-provider-setup/claude-code.mdx。两种方式互斥计费二选一即可。4.1 Claude 订阅登录若已有其他提供商直接./kritt start若是首次纯 Claude 登录需先手动引导 Composecp .env.example .env后docker compose up --build因为 CLI 发现不了尚不存在的登录打开 http://localhost:5173进入Accounts → Sign in to Claude在打开的授权 URL 中完成认证把单行回调码粘贴回对话框Accounts 显示登录可用后扫描表单即暴露sonnet、opus等 Claude Code 稳定别名。凭证文件保存在.data/claude并挂载进引擎。订阅快过期时 open·kritt 会在任务启动前自动刷新登录并生成私有凭证快照扫描中途中断可重新登录后恢复。4.2 Anthropic API Key在 Claude Console 确认工作区可创建 Key、账单配置正常后到Settings → API keys创建 Key然后在./kritt setup中选择Anthropic API key粘贴CLI 会将其写入.env的ANTHROPIC_API_KEY。⚠️ 请使用普通推理类 API KeyAdmin / Analytics / Compliance 类 Key 无法配置本提供商。五、OpenRouter 通道一个 Key 路由多家模型OpenRouter 通道使用OPENROUTER_API_KEY默认采用 Claude Code harness配置方法见 docs-site/ai-provider-setup/openrouter.mdx在 OpenRouter 账户充值付费模型需要 Credits到API keys页面创建一个普通推理 Key管理 Key 无法调用模型接口可顺手设置消费上限./kritt setup→OpenRouter API key→ 粘贴写入.env./kritt start如已在运行先CtrlC停止。Key 配置后引擎会在后台定期从 OpenRouter 的认证模型端点刷新可搜索模型目录并缓存到扫描与生成表单目录没刷出来前可手填精确的作者/模型标识作为兜底。目录是建议而非白名单——模型是否真正兼容由 OpenRouter 与 harness 在运行时决定。模型需要支持大代码上下文、工具调用与可靠的结构化输出。六、xAI 通道Grok 设备登录或 XAI_API_KEYxAI 通道固定使用Grok Buildharness别名grok接入说明见 docs-site/ai-provider-setup/xai.mdx。两种凭证可同时存在扫描时优先用已保存的设备登录未登录时回落到XAI_API_KEY。设备登录./kritt start后打开Accounts → xAI → Add Grok accountopen·kritt 会在后端执行grok login --device-auth并显示一次性设备码与登录 URL在浏览器完成认证即可。登录材料默认存放在.data/grok与.data/grok-accounts按机密对待。API Key在 xAI Console 创建 Key显示后不可再查看完整密钥通过./kritt setup的xAI API key选项或 Accounts 页面的Add API key写入.env的XAI_API_KEY。带 Key 时引擎同样会后台刷新可搜索目录目录不可用时仍可手填精确模型 ID。特色能力Grok 通道支持Thinking effort低/中/高Grok 4.6 还支持xhighopen·kritt 默认mediumUI 只会显示当前模型与 harness 支持的档位。每次 Grok Build 任务都会获得一个全新隔离的 home仅包含所选账号的auth.json与选中的 skills不继承账户级配置——扫描不可信代码时更安全但容器仍有出网能力建议放在专用 Docker 主机或虚拟机上运行参见 docs/threat-model.md。七、配置完成后的模型选择与验证排错7.1 在哪里看到效果配置生效后新建扫描页Scans → New scan即可选择模型。默认所有深度用一个模型也可打开Customize by depth为每个深度单独配置提供商 模型 harness 思考强度例如深度 0 用快模型枚举入口、深度 1 用强模型深挖候选漏洞后处理去重、严重度定级、Post-script还支持Use different model单独指定更便宜的模型。详细说明见 docs-site/scans/model-and-harness.mdx。7.2 四通道验证清单./kritt setup中对应项显示present如 Codex login present、Anthropic API key present新建扫描与 AI 生成表单中能列出该提供商及其模型目录Accounts 页面显示对应登录或 Key 处于激活状态。7.3 常见错误速查现象原因与处理401Key 无效、已吊销或登录过期重建 Key 或重新走设备登录402OpenRouter 账户余额不足去充值 Credits模型目录一直加载查看docker compose logs engine确认 Key 有列出模型的权限模型未找到模型 ID 拼写错误或账号无权访问从目录复制精确 ID改完.env没生效先CtrlC停栈再./kritt start重建容器能启动但工具调用/结构化输出失败模型能力不满足 harness 要求换模型或换 harness总结按自己的账户组合选一条通道起步已有ChatGPT/Claude 订阅→ 直接走设备登录体验最顺偏好按量计费或多模型→ OpenRouter / xAI API Key一个 Key 快速接入全部配好后可随时在扫描表单里按任务深度切换模型与提供商兼顾成本与效果。更多细节可参考源码与文档凭证处理逻辑位于 backend/src/lib/providerCredentials.js引擎侧模型目录刷新见 engine/open_kritt_engine/model_catalog.py提供商路由见 backend/src/routes/modelProviders.js。完成模型接入后下一步就可以创建自己的工作流并发起第一次漏洞扫描了 【免费下载链接】open-krittOpen-source, self-hosted AI vulnerability research tool that orchestrates agents to find and validate security issues in code.项目地址: https://gitcode.com/gh_mirrors/op/open-kritt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考