ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Kimi Code 平台与模型供应商接入完全指南:config.toml 多供应商配置详解

Kimi Code 平台与模型供应商接入完全指南:config.toml 多供应商配置详解 AI Agent代码智能体人工智能大模型CLI【免费下载链接】kimi-codeKimi Code CLI — The Starting Point for Next-Gen Agents项目地址https://gitcode.com/gh_mirrors/ki/kimi-code点击查看免费下载Kimi Code CLI 支持同时接入多家 LLM 平台通过 Kimi Code 托管服务一键登录、用 Anthropic API 密钥连接 Claude、或经 OpenAI 兼容协议连接 DeepSeek / Qwen 等第三方推理服务。本篇以 docs/zh/configuration/providers.md 为核心完整讲解config.toml中六类供应商的配置方法、凭证解析优先级、/provider交互式管理并结合仓库源码揭示能力自动匹配与协议适配的底层原理。读完你将能独立完成任意供应商的接入、密钥管理与模型覆盖配置。支持的供应商类型与协议映射providers表里的type字段决定使用哪种协议实现。Kimi Code 把协议实现收敛在packages/kosong/src/providers/目录下每种类型对应一个具体类由 createProvider 工厂函数 统一实例化类型协议典型用途对应实现文件kimiOpenAI 兼容Kimi Code 托管服务、Kimi Platform API 密钥kimi.tsanthropicAnthropic MessagesClaude 系列模型anthropic.tsopenaiOpenAI Chat CompletionsOpenAI 及兼容服务、DeepSeek、Qwen 等openai-legacy.tsopenai_responsesOpenAI Responses APIOpenAI 较新的 Responses 接口openai-responses.tsgoogle-genaiGoogle GenAIGemini APIgoogle-genai.tsvertexaiGoogle GenAI on VertexGoogle Cloud Vertex AIgoogle-genai.ts复用vertexai标志切换路径所有供应商默认以流式方式与模型交互。thinking、视觉、工具调用等能力按模型名前缀自动匹配通常不需要手动声明——该逻辑实现在 capability-registry.ts 中以静态前缀表方式工作例如claude-opus-4/claude-sonnet-4/claude-haiku-4/claude-fable前缀命中视觉 工具 thinking能力集gemini-2.5-或含thinking的模型名命中 Gemini 多模态推理能力集。未知模型返回UNKNOWN_CAPABILITY能力检查保持非致命。凭证优先级CLI 只从配置文件读密钥凭证优先级api_key或api_key_env互斥替代项只能设置其中一个[providers.name.env]子表键两者都不存在时才读 全部缺失时启动报错。除显式声明的api_key_env外CLI不会从 shell 环境变量自动取凭证。这条规则在 配置覆盖供应商凭证 中有详细展开几个关键点api_key和api_key_env不是优先级回退链而是互斥项同时设置被判为配置冲突api_key_env与oauth同设同样被拒绝api_key_env是不从 shell 环境变量取凭证唯一有意开放的例外密钥在每次请求时从进程自身环境重新读取不缓存、不写进config.toml运行中的进程只能看到它启动时的环境轮换变量需要重启进程声明了api_key_env但变量未设置或为空时快速失败并报错指明供应商和变量名——会话就绪检查与请求发送时都会拦截绝不静默忽略也不回退到其他凭证来源env子表是api_key/base_url的备用来源只在配置文件里读取不会修改 shell 环境。[providers.kimi.env] KIMI_API_KEY sk-xxx KIMI_BASE_URL https://api.moonshot.ai/v1刷新/models时声明的变量未设置或为空的供应商会被记为失败但不影响其他供应商。/provider— 交互式供应商管理不想手动编辑 TOML在 TUI 里输入/provider打开供应商管理器可以以交互方式添加或删除供应商。管理器按来源把供应商显示为一行行条目。操作方式↑/↓ 移动光标←/→ 翻页d键删除当前供应商有[y/N]确认在[ Add New Platform ]行按 Enter 添加新供应商添加路径一Known third-party provider从 models.dev 拉取模型目录选供应商 → 输入 API 密钥 → 选默认模型。目录未声明协议类型的供应商如 xai、openrouter 这类厂商专用 SDK会按 OpenAI 兼容协议导入并显示 guessed 提示目录没有可用端点时会先弹出 base URL 输入框Amazon Bedrock / Cohere 等专有协议和无法识别的显式协议会被拒绝导入。已下线deprecated和 alpha 状态的模型不会出现在导入列表中。如果公共目录不可达CLI 会回退到内置目录快照离线或网络受限环境下也能完成导入。这些规则的判定逻辑在 catalog.ts 中清晰可查显式type字段权威已知则采用、未知则拒绝否则按npm/id启发式推断amazon-bedrock/cohere等专有 SDK 直接拒绝无法识别时回退 OpenAI 兼容协议并标记guessed。目录的api端点还会按 wire 约定适配——例如 Anthropic SDK 自己会追加/v1/messages导入时自动剥掉目录 URL 末尾的/v1避免请求落在/v1/v1/messages上。添加路径二Custom registry (api.json)粘贴自定义 registry 地址私有 registry 再附上 Bearer tokenCLI 自动创建providers/models条目。当 registry 条目声明了env字段存放 API 密钥的环境变量名时CLI 会把它作为提示打印出来——想用就在config.toml里自己设置api_key_env。绑定永远不会自动发生registry 既决定变量名、又决定凭证发往的端点不能由它来选择读取你的哪份密钥。对私有 registryBearer token 本身仍会存为source.apiKey供刷新时重新拉取。后续启动时同一个 registry 地址下的供应商会一起刷新因此上游新增、删除供应商以及模型元数据变化都会同步。::: warning 注意 通过/login登录的 Kimi Code OAuth 托管账号不会在/provider里显示请用/login和/logout管理。 :::非交互环境下也可以用 shell 命令完成同样操作kimi provider。kimi — Moonshot OpenAI 兼容接口用于对接 Moonshot AI 的 OpenAI 兼容接口包括 Kimi Code 托管服务和 Kimi Platform API 密钥。默认base_urlhttps://api.moonshot.ai/v1凭证键名KIMI_API_KEY、KIMI_BASE_URL额外能力支持视频上传[providers.kimi] type kimi base_url https://api.moonshot.ai/v1 api_key sk-xxxxx使用 Kimi Code 托管服务时/login登录后会自动配置base_url和凭证无需手动填写。托管服务走 OAuth 而非静态 API 密钥登录后内置认证工具链自动写入并刷新凭证config.toml无需任何手工配置。anthropic — Claude API用于对接 Claude API。标准 Claude 模型自动启用视觉、工具调用及 Thinking如支持自定义或未覆盖的模型需在[models.alias]里显式声明capabilities。默认base_url跟随 Anthropic SDK 默认值凭证键名ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL默认max_tokens按模型自动推断。如需覆盖在模型别名上设max_output_size[providers.anthropic] type anthropic api_key sk-ant-xxxxx [models.claude-opus-4-7] provider anthropic model claude-opus-4-7 max_context_size 200000 # max_output_size 32000 # 可选省略时使用模型推断的默认值从源码结构看Claude 能力按模型名前缀分组匹配capability-registry.tsclaude-3-/claude-3.5-/claude-3.7-前缀命中视觉 工具、无 thinkingclaude-opus-4/claude-sonnet-4/claude-haiku-4/claude-fable命中视觉 工具 thinking。新模型按能力加入对应分组而非按版本族单独建档。另外 Anthropic 供应商支持在模型别名上设adaptive_thinkingClaude ≥ 4.6 默认按模型名推断为 adaptive。openai — Chat Completions 及兼容服务用于对接 OpenAI Chat Completions 协议也可连接任何兼容该协议的第三方服务覆盖base_url即可。第三方推理模型DeepSeek、Qwen、One API 等开箱即用CLI 自动处理reasoning_content字段和reasoning_effort注入。如果你的网关用非标准字段名返回推理内容在模型别名上设reasoning_key覆盖——reasoning-key.ts中默认自动识别reasoning_content等标准字段。默认base_urlhttps://api.openai.com/v1凭证键名OPENAI_API_KEY、OPENAI_BASE_URL[providers.openai] type openai base_url https://api.openai.com/v1 api_key sk-xxxxxopenai_responses — OpenAI Responses API对应 OpenAI 较新的 Responses API始终以流式方式工作。配置方式与openai相同。从源码结构看Responses 协议独立实现了OpenAIResponsesChatProvideropenai-responses.ts能力目录与 legacy 版本略有差异例如gpt-4.1/o3等模型走 developer 角色。默认base_urlhttps://api.openai.com/v1凭证键名OPENAI_API_KEY、OPENAI_BASE_URL[providers.openai-responses] type openai_responses base_url https://api.openai.com/v1 api_key sk-xxxxxgoogle-genai — Gemini API 直连用于直连 Google Gemini API。thinking、视觉及多模态能力按模型名自动识别——gemini-1.5-pro、gemini-2.0-flash、gemini-2.5-pro等前缀列入目录gemini-2.5-或含thinking的名称命中多模态推理能力集capability-registry.ts。凭证键名GOOGLE_API_KEY[providers.gemini] type google-genai api_key xxxxx如需经由兼容 Gemini 协议的代理/网关访问可设置base_url或GOOGLE_GEMINI_BASE_URL环境变量不填时使用 SDK 默认地址https://generativelanguage.googleapis.com。只填主机根地址。Google GenAI SDK 会自行追加 API 版本与路径如/v1beta/models/model:generateContent所以结尾带/v1beta会导致路径重复成/v1beta/v1beta/…。[providers.gemini] type google-genai api_key xxxxx base_url https://your-gateway.examplevertexai — Google Cloud Vertex AI与google-genai共用实现同一个GoogleGenAIChatProvidertype vertexai时切换到 Vertex AI 访问路径——GoogleGenAIOptions.vertexai标志在 google-genai.ts 中定义端点随之改为 SDK 默认的区域化*-aiplatform.googleapis.com地址。认证走 Google Cloud 标准 ADC 流程gcloud auth application-default login或GOOGLE_APPLICATION_CREDENTIALS服务账号 JSON这部分与 Kimi Code 无关。项目 ID 和区域必须写在[providers.vertexai.env]子表里。直接在 shell 里export GOOGLE_CLOUD_PROJECT不会被 CLI 读取——GOOGLE_APPLICATION_CREDENTIALS是唯一走系统环境变量的例外它由 Google SDK 自身经 ADC 流程读取CLI 不参与。[providers.vertexai] type vertexai [providers.vertexai.env] GOOGLE_CLOUD_PROJECT my-gcp-project GOOGLE_CLOUD_LOCATION us-central1gcloud auth application-default login # 一次性完成认证 kimi如需让 Vertex 请求走自定义如代理端点可设置base_url或GOOGLE_VERTEX_BASE_URL环境变量不填时使用 SDK 默认的区域化地址。与google-genai一样只填主机根地址SDK 会自行追加/v1beta1/publishers/google/models/…。供应商凭证键名速查以下键名不是直接从 shell 读取的而是写在config.toml的[providers.name.env]子表里、作为api_key/base_url备用来源的键名。CLI 只从配置文件读取不从process.env读取键名适用供应商默认值KIMI_API_KEYKimi / Moonshot无KIMI_BASE_URLKimi / Moonshothttps://api.moonshot.ai/v1ANTHROPIC_API_KEYAnthropic无ANTHROPIC_BASE_URLAnthropicAnthropic SDK 默认值OPENAI_API_KEYOpenAIopenai和openai_responses无OPENAI_BASE_URLOpenAIopenai和openai_responseshttps://api.openai.com/v1GOOGLE_API_KEYGoogle GenAI、Vertex AI无VERTEXAI_API_KEYVertex AI无GOOGLE_CLOUD_PROJECTVertex AI无GOOGLE_CLOUD_LOCATIONVertex AI无如果希望把密钥放在 shell 环境里并使用自定义变量名可以在供应商上设置api_key_env指向你的变量名。完整清单见环境变量供应商凭证键。模型别名与能力声明供应商之上是模型声明。models表的每一项定义一个模型别名即default_model或-m参数里使用的名称字段包括字段类型必填说明providerstring是使用的供应商名称必须在providers中定义modelstring是调用 API 时实际传给服务端的模型 IDmax_context_sizeinteger是最大上下文长度token 数必须 ≥ 1max_input_sizeinteger否模型声明的单次请求输入上限压缩、溢出检查与用量比率优先使用它max_output_sizeinteger否单次请求的输出 token 上限对应max_tokens目前仅anthropic供应商读取capabilitiesarraystring否显式追加的能力标签thinking、always_thinking、image_in、video_in、audio_in、tool_use、dynamically_loaded_tools只能追加不能移除support_effortsarraystring否模型接受的 Thinking 档位default_effortstring否模型的默认 Thinking 档位off_effortstring否关闭 Thinking 时在线上传输的 effort 编码如 xai grok 的nonebase_urlstring否模型级端点覆盖解析时优先于供应商的base_urldisplay_namestring否UI 中显示的名称未设时回退到modelreasoning_keystring否仅openai供应商网关用非标准字段名返回推理内容时设置adaptive_thinkingboolean否仅anthropic供应商强制开关 adaptive thinking别名中含.时需要加引号否则 TOML 会把.解释为嵌套表分隔符[models.gpt-4.1] provider openai model gpt-4.1 max_context_size 1047576providers表字段的完整参考见配置文件各供应商对应的凭证键名列表见环境变量解析优先级规则见配置覆盖。下一步配置文件 —providers和models表的完整字段参考配置覆盖 — 供应商凭证的解析优先级规则环境变量 — 各供应商对应的凭证键名列表赞分享AI Agent代码智能体人工智能大模型CLI【免费下载链接】kimi-codeKimi Code CLI — The Starting Point for Next-Gen Agents项目地址https://gitcode.com/gh_mirrors/ki/kimi-code点击查看免费下载相关推荐big-AGI 接入 OpenRouter多供应商模型统一配置指南big AGI 接入 OpenRouter多供应商模型统一配置指南 big AGI 是一款开源的 AI 套件通过接入 OpenRouter 这一聚合 APIAI 应用大模型前端Aimeos多供应商电商平台搭建指南构建SaaS级电商解决方案的完整教程Aimeos多供应商电商平台搭建指南构建SaaS级电商解决方案的完整教程 Aimeos是一款基于Laravel 10和Aimeos电商框架的超快速在线商店系统电商后端前端OpenClaw Kimi 插件完全指南Kimi K3 / Kimi Coding 模型提供商接入、思考模式与 Web 搜索配置OpenClaw Kimi 插件完全指南Kimi K3 / Kimi Coding 模型提供商接入、思考模式与 Web 搜索配置 OpenClaw 通过官方插AI 应用AI Agent交互助手后端即时通讯网关上一篇为什么百度网盘下载那么慢用pan-baidu-download的login命令配合BDUSS解锁高速下载下一篇告别静态提示框Tippy.js模板系统实现动态内容生成创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表