Qoder插件需依次完成启用、登录、模型配置和上下文设置四步才能生效：启用插件后登录账号获取Credits，配置阿里云百炼API密钥与模型，最后统一语言设置并触发项目索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在 PyCharm 中安装 Qoder 官方插件但功能未生效，则可能是由于插件未启用、模型配置缺失或账号未登录所致。以下是启用 Qoder 插件并完成基础配置的详细流程：
一、确认插件已正确安装并启用
该步骤确保 Qoder 插件处于激活状态，是后续所有功能运行的前提。PyCharm 默认可能将新安装插件设为禁用，需手动开启。
1、启动 PyCharm，点击顶部菜单栏 File → Settings（Windows/Linux）或 PyCharm → Preferences（macOS）。
2、在左侧导航栏中展开 Plugins 选项，进入插件管理界面。
3、在右上角搜索框中输入 Qoder，确认列表中显示已安装的插件条目（发布者为 qoder-ai）。
4、若插件右侧显示 Disable 按钮，说明当前处于禁用状态；点击该按钮切换为 Enable。
5、点击窗口右下角 OK 保存设置，随后按提示重启 PyCharm。
二、完成 Qoder 账号登录与凭证绑定
登录账号是调用 AI 服务的必要认证环节，未登录将导致所有请求返回“未授权”错误，且无法获取 Credits 配额。
1、重启后，在 PyCharm 右侧边栏查找 Qoder 图标（若未显示，可尝试通过 View → Tool Windows → Qoder 打开）。
2、首次打开时将弹出登录面板，支持 手机号验证码、GitHub 账号授权 或 GitLab 账号授权 三种方式。
3、选择任一方式完成登录；新用户将自动获得 300 Credits 初始额度。
4、登录成功后，Qoder 面板左上角应显示用户头像及昵称，右上角状态指示灯变为绿色。
三、配置阿里云百炼模型接入参数
Qoder 插件依赖后端大模型提供推理能力，必须显式配置合法的模型接入凭证，否则无法生成代码或响应问答。
1、点击 PyCharm 右上角 Qoder 图标旁的齿轮设置按钮，或进入 Settings → Other Settings → Qoder。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
2、在模型配置区域点击 Add Model 按钮。
3、在弹出表单中依次填写以下字段：
提供商：从下拉菜单选择 阿里云百炼 - 国内；
类型：根据您开通的服务方案选择 Token Plan、Coding Plan 或 按量付费；
模型：仅支持文本生成类模型，如 qwen-plus 或 qwen-max（需与所选方案兼容）；
API Key：粘贴对应方案在 阿里云百炼控制台 获取的专属密钥。
4、点击 Validate & Add，等待校验通过后，该模型即出现在模型列表中。
5、勾选刚添加的模型作为默认项，确保后续所有请求均路由至该配置。
四、验证语言与上下文设置
语言与项目上下文直接影响 AI 输出质量，需确保界面语言与代码理解语言一致，并启用仓库级感知能力。
1、在 Settings → Other Settings → Qoder 页面中，找到 显示语言 和 AI 回答语言 两个下拉选项。
2、将二者均设为 简体中文（若开发项目以中文注释/文档为主）或 English（若项目技术栈为英文生态）。
3、向下滚动至 项目上下文 区域，确认已启用 自动索引当前项目文件 开关。
4、点击 Re-index Now 强制触发一次全量代码库扫描，尤其适用于大型多模块项目。
5、扫描完成后，状态栏将显示 Indexed N files，表示上下文已就绪。
