必须通过环境变量与配置文件组合启用开发者模式：先设置codegeex_dev_mode=true并重启vs code，再执行“codegeex: toggle developer tools”；随后可调高日志等级、捕获api流量、配置调试端口并接入chrome devtools进行断点调试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在本地完整掌控CodeGeeX的运行逻辑、修改底层提示词、调试模型响应延迟或验证自定义插件行为，就必须进入开发者模式——它不是UI开关，而是通过环境变量与配置文件组合触发的深度调试入口。
启用开发者模式核心开关
第一步：打开终端，执行命令临时启用开发者模式标识：export CODEGEEX_DEV_MODE=true（Linux/macOS）或 set CODEGEEX_DEV_MODE=true（Windows CMD），该变量必须在启动VS Code前设置，否则插件加载时无法识别；
第二步：重启VS Code，确保插件初始化阶段读取到该环境变量——若未重启，插件仍以生产模式运行，所有日志压缩、错误堆栈截断、API调用链路简化等机制照常生效；
第三步：在VS Code命令面板（Ctrl+Shift+P）中输入“CodeGeeX: Toggle Developer Tools”，回车执行，此时右下角状态栏出现“DEV”红色标签，表示开发者模式已激活。
开启详细日志与网络追踪
方法一：强制输出全量调试日志
在VS Code设置中搜索“CodeGeeX: Log Level”，将值改为debug；该设置会覆盖插件默认的日志过滤策略，使所有HTTP请求头、模型token生成过程、上下文窗口切片逻辑全部写入~/.codegeex/logs/目录下的debug-YYYY-MM-DD.log文件；
【注意】日志文件默认不加密且含原始prompt内容，禁止在共享开发机或公网服务器上长期启用此模式。
方法二：捕获本地API通信流量
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
启动插件后，在终端执行code --log=trace（Windows/Linux）或open -a "Visual Studio Code" --args --log=trace（macOS），该命令会额外开启VS Code内核级网络日志，可定位到CodeGeeX插件与Ollama服务间HTTP 400/503错误的真实原因，比如POST http://localhost:11434/api/chat返回空响应体，说明Ollama服务未正确加载模型。
配置本地调试端口与断点接入
第一步：在VS Code用户设置（settings.json）中添加以下字段：
"codegeex.debug.port": 9229,
"codegeex.debug.enable": true
第二步：关闭所有VS Code窗口，重新以调试模式启动：code --inspect-brk=9229（Windows/Linux）或open -a "Visual Studio Code" --args --inspect-brk=9229（macOS）；
第三步：打开Chrome浏览器，访问chrome://inspect→点击“Configure”→添加localhost:9229→返回页面刷新，即可在“Remote Target”中看到CodeGeeX插件进程，点击“inspect”进入DevTools；
第四步：在插件源码的src/extension.ts第87行（即handleCodeGeneration函数入口）打下断点，触发任意代码生成功能，执行流程将在该位置暂停，可实时查看context对象结构、prompt拼接结果及modelConfig参数实际值。
