qoder全局调用需配置五项环境变量：一、path添加cli路径以支持qoder命令；二、qoder_home指向主目录以加载规则与缓存；三、qoder_credits_provider与qoder_api_token实现无头认证；四、qoder_model_router及qoder_default_model控制模型选择；五、qoder_workspace_root声明仓库根路径以启用上下文感知。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在任意终端位置或系统服务中直接调用Qoder的核心功能组件（如CLI工具、Quest执行器、Repo Wiki生成器等），但命令提示符返回“不是内部或外部命令”或模块导入失败，则可能是由于Qoder相关路径未纳入系统环境变量。以下是实现全局调用的多种配置方式：
一、配置PATH环境变量添加 Qoder CLI主目录
该方式使系统能在任意路径下识别并执行qoder命令，适用于Windows、macOS与Linux全平台，是全局调用的基础前提。
1、确认Qoder CLI安装路径：默认情况下，Windows为C:Users\AppDataLocalProgramsQodercli，macOS为/Applications/Qoder.app/Contents/Resources/cli，Linux为/opt/qoder/cli。
2、将上述路径复制到剪贴板，确保路径末尾不含斜杠。
3、Windows用户：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”中双击“Path”，点击“新建”后粘贴路径；macOS/Linux用户：在~/.zshrc（或~/.bash_profile）末尾追加export PATH="/path/to/qoder/cli:$PATH"，随后执行source ~/.zshrc。
4、重启终端或命令提示符，运行qoder --version验证是否返回版本号。
二、设置QODER_HOME指向主程序根目录
该变量为Qoder官方推荐的主目录标识，用于定位内置工具链、规则集（.qoder/rules）、缓存目录及模型路由配置，所有Qoder子组件均优先读取此路径。
1、在文件资源管理器中定位Qoder主安装目录：Windows常见于C:Program FilesQoder，macOS为/Applications/Qoder.app/Contents/MacOS，Linux为/opt/qoder。
2、Windows用户：在“系统变量”中新建变量名QODER_HOME，变量值填入完整路径；macOS/Linux用户：在shell配置文件中添加export QODER_HOME="/path/to/qoder"。
3、执行echo $QODER_HOME（macOS/Linux）或echo %QODER_HOME%（Windows）确认输出正确。
4、关键提示：若未设置QODER_HOME，Agent模式可能无法加载项目级Rules、Repo Wiki生成将跳过本地知识库索引。
三、启用QODER_CREDITS_PROVIDER与API密钥注入
该配置用于绕过GUI登录流程，在CI/CD流水线或无头服务器环境中自动认证，使CLI与Quest执行器可直接调用AI核心模块而无需交互式Token获取。
1、访问Qoder控制台账户页，进入“API Keys”板块，创建一个新的Personal Access Token，勾选quest:execute与repo:read权限。
2、将生成的Token字符串复制备用。
3、设置环境变量QODER_CREDITS_PROVIDER=env，并同步设置QODER_API_TOKEN=your_token_here。
4、在终端中运行qoder quest start --spec "生成README.md"，若立即进入Running状态且无登录弹窗，则配置生效。
5、重要安全提醒：切勿将QODER_API_TOKEN硬编码进脚本或Git仓库，应通过Secret Manager或临时注入方式传递。
四、配置QODER_MODEL_ROUTER策略变量
该变量控制Qoder在Ask与Agent模式下如何选择底层大模型，直接影响代码生成质量与Credits消耗，适用于对响应精度或成本有明确要求的场景。
1、查阅Qoder支持的模型代号列表：当前可用值包括qwen-coder-pro、claude-sonnet-4、gpt-4o-mini、glm-4v。
2、根据任务类型选定默认模型：简单补全建议设为gpt-4o-mini，复杂重构建议设为qwen-coder-pro。
3、设置环境变量QODER_MODEL_ROUTER=default，再设置QODER_DEFAULT_MODEL=qwen-coder-pro。
4、启动IDE插件后，在侧边栏AI聊天窗口输入/model指令，确认当前激活模型名称与设定一致。
5、注意：若QODER_MODEL_ROUTER设为auto，系统将忽略QODER_DEFAULT_MODEL，改由任务复杂度动态判定。
五、声明QODER_WORKSPACE_ROOT以启用仓库级上下文
该变量显式告知Qoder当前工作区根路径，避免其依赖当前shell路径或IDE自动探测失败，对多模块项目、符号链接目录或远程挂载路径尤为关键。
1、打开终端，进入您要开发的代码仓库根目录，执行pwd（macOS/Linux）或cd（Windows）获取绝对路径。
2、将该路径赋值给环境变量QODER_WORKSPACE_ROOT：Windows使用setx QODER_WORKSPACE_ROOT "C:devmyproject"，macOS/Linux使用export QODER_WORKSPACE_ROOT="/Users/name/dev/myproject"。
3、在该路径下新建任意测试文件，运行qoder ask "这个项目用了什么数据库？"。
4、验证成功标志：回答中准确引用application.yml内spring.datasource.url字段，而非返回“未检测到配置文件”。
