Qoder调用OpenAI需四步：一、验证并创建有效API密钥；二、通过MCP配置openai-config.json及环境变量；三、在rules.yaml中设置模型路由规则；四、依error.code处理配额、超长、密钥或限流错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Qoder开发环境中集成OpenAI的模型能力，但无法成功调用其API，则可能是由于API密钥未配置、请求头缺失、模型ID不匹配或网络代理策略限制。以下是完成Qoder调用OpenAI接口的完整配置流程：
一、确认OpenAI API密钥有效性与权限
Qoder需通过合法凭证访问OpenAI服务，该密钥必须具备对应模型（如gpt-4-turbo、gpt-3.5-turbo）的调用权限，且未被组织策略禁用或超出速率/配额限制。
1、登录OpenAI官方平台（https://platform.openai.com/api-keys），进入API Keys管理页。
2、点击“Create new secret key”，为密钥填写描述名称（如“Qoder-Dev-Key”），确保勾选所需模型访问权限。
3、复制生成的密钥字符串（以sk-开头），切勿在前端代码或公开仓库中硬编码该密钥。
4、在OpenAI平台Usage页面验证密钥最近30分钟内是否有成功调用记录，排除组织级阻断可能。
二、配置Qoder的MCP工具连接OpenAI服务
Qoder通过MCP（Model Context Protocol）协议接入第三方大模型，需在本地创建并注册符合规范的工具定义文件，使Agent能识别并路由请求至OpenAI端点。
1、在项目根目录下新建文件夹.mcp/tools/，并在其中创建openai-config.json。
2、在openai-config.json中写入标准MCP工具声明，包含name、description、input_schema及endpoint字段，其中endpoint值设为https://api.openai.com/v1/chat/completions。
3、将OpenAI密钥以环境变量形式注入：在系统shell中执行export OPENAI_API_KEY="sk-..."，确保Qoder进程启动前该变量已加载。
4、在Qoder IDE插件设置中启用MCP支持，并点击“Reload Tools”刷新本地工具列表，确认openai-config.json被识别为可用工具。
三、设置Qoder Agent的模型路由规则
Qoder默认优先调用自有模型，需显式配置规则，使特定任务类型（如自然语言理解、文档生成）自动转向OpenAI服务，避免请求被内部调度器拦截。
1、在项目根目录创建.qoder/rules.yaml文件，若已存在则追加rule项。
2、添加一条rule，match条件设置为intent: "document-generation"且model: "openai/gpt-4-turbo"，action指定use_tool: "openai-config.json"。
3、保存后，在Qoder IDE右下角状态栏点击“Rules Sync”图标，触发规则热重载。
4、在Ask Mode中输入测试指令：“用中文生成一份RESTful API设计规范”，观察日志是否显示请求已转发至OpenAI endpoint并返回200响应。
四、处理常见HTTP错误响应
当Qoder调用OpenAI接口返回非200状态码时，需根据error.code字段定位具体失败原因，而非依赖通用重试机制。
1、若响应含error.code: "insufficient_quota"，说明账户余额不足，需前往OpenAI Billing页面充值或切换至其他计费账户。
2、若响应含error.code: "context_length_exceeded"，表明输入token超限，应在Qoder规则中增加preprocess步骤，启用自动摘要或分块策略。
3、若响应含error.code: "invalid_api_key"，检查环境变量OPENAI_API_KEY是否拼写错误、是否含不可见空格、是否被IDE终端会话隔离。
4、若响应含error.code: "rate_limit_exceeded"，在Qoder CLI中执行qoder config set rate_limit_delay 2000，将重试间隔设为2秒，避免触发OpenAI的突发流量熔断机制。
