48-自定义模型接入指南

48 自定义模型接入指南概述Codex的默认模型通常能够满足大多数场景的需求，但不同的开发者可能有不同的偏好和需求——有些人希望使用本地模型来保护数据隐私，有些人需要接入企业内部的Azure OpenAI服务，还有些人想尝试成本更低的模型如DeepSeek。Codex提供了灵活的model_providers 配置系统，支持接入多种模型提供商，包括Ollama本地模型、OpenRouter、Azure OpenAI、DeepSeek等。本文将详细介绍各模型的接入方式和配置要点。1. model_providers 配置体系1.1 配置架构Codex的模型提供商配置采用插件式架构，通过统一的接口屏蔽不同提供商的差异：# ~/.codex/config.yaml — 模型提供商配置总览model_providers:# 默认提供商default:openai# 提供商列表providers:openai:# ...配置azure:# ...配置deepseek:# ...配置ollama:# ...配置openrouter:# ...配置# 模型路由规则routing:-match:"code*"provider:codex-default-match:"chat*"provider:openai-match:"local*"provider:ollama1.2 核心配置参数所有模型提供商共享以下核心参数：参数类型说明默认值api_basestringAPI端点地址各提供商不同api_keystringAPI密钥无modelstring模型名称各提供商不同max_tokensint最大输出Token数4096temperaturefloat生成温度(0-2)0.7timeoutint请求超时(秒)60retry_countint重试次数3concurrent_limitint并发请求限制52. Ollama本地模型接入2.1 安装Ollama# macOSbrewinstallollama# Linuxcurl-fsSLhttps://ollama.com/install.sh|sh# Windows# 从 https://ollama.com/download 下载安装包# 启动Ollama服务ollama serve2.2 拉取模型# 拉取常用模型ollama pull llama3.1:8b# Meta Llama 3.1ollama pull codellama:7b# 代码专用模型ollama pull mistral:7b# Mistralollama pull qwen2.5-coder:7b# Qwen编码模型ollama pull deepseek-coder:6.7b# DeepSeek编码模型# 查看已安装的模型ollama list2.3 Codex配置# ~/.codex/config.yamlmodel_providers:default:ollamaproviders:ollama:api_base:"http://localhost:11434"model:"llama3.1:8b"max_tokens:4096temperature:0.7timeout:120# 本地模型可能较慢retry_count:2parameters:num_ctx:8192# 上下文窗口大小num_predict:4096repeat_penalty:1.1top_k:4