配置文件Configuration File
你可能会说
帮我把 AI 工具的配置文件里默认的模型换成 DeepSeek，并且把超时限制设置成 60 秒。
配置文件是用文件保存的软件设置，供程序在启动或运行时读取。例如 AI 工具可以从配置文件读取模型、连接地址、超时和权限设置，而项目规则文件负责说明当前项目的技术栈和协作要求。配置文件可能引用密钥变量，但真实密钥应放在环境变量或密钥管理服务中，并确认不会被 Git 跟踪。
也常被叫作设置文件配置项config.jsonconfig.toml
AI 工具配置文件对照
| AI 工具名称 | 是否支持修改配置文件 | 配置文件位置 | 官方文档 |
|---|---|---|---|
| Codex | 支持 | ~/.codex/config.toml项目级：<项目目录>/.codex/config.toml |  官方文档 |
| Claude Code | 支持 | ~/.claude/settings.json项目级：<项目目录>/.claude/settings.json | |
| Gemini CLI | 支持 | %USERPROFILE%\.gemini\settings.json项目级：<项目目录>\.gemini\settings.json | |
| Qoder | 不支持 | 可通过工具内的模型配置入口 /model 配置。 |  官方文档 |
| Trae | 不支持 | 可通过产品内“设置 → 模型”配置。 |  官方文档 |
| WorkBuddy | 不支持 | 可通过产品内“设置 → 模型”配置。 |  官方文档 |
配置文件和项目规则分别负责什么
配置文件保存运行设置（JSON / YAML / TOML）：用于保存 Provider、模型、地址、端口或权限等运行参数。常见格式有 JSON（严格键值对）、YAML（可写注释）和 TOML（分块清晰）。
项目规则规范协作要求：项目规则用于说明模型在当前项目中需要遵守的要求，例如技术栈、代码风格和协作规范。
修改配置后通常需要重启：多数工具只在启动时读取配置文件。修改 next.config.js、.env 或 tailwind.config.ts 后，通常要重启开发服务器（Ctrl+C 再 npm run dev）才能生效。
你可以这样告诉 AI Agent
请先确认当前工具实际读取哪一个配置文件，再检查模型、连接地址和超时设置。不要读取或打印真实密钥；完成后告诉我生效的文件路径和配置层级。
接下来学什么
延伸阅读 · 权威出处
快速练习
模型调用失败时，应该先查看什么类型的文件？
ANS 原创方法