1. CodeGeeX 补全请求走不通时先看通道配置CodeGeeX 是国产免费代码补全助手支持 VS Code 和 JetBrains 全家桶对标 GitHub Copilot 的补全体验。它的默认通道对多数人够用但如果你遇到补全延迟高、请求偶发失败、或者想把 CodeGeeX 和团队其他 AI 工具统一到同一个 Key 通道管理就需要手动改配置。这篇聚焦一个具体动作把 CodeGeeX 的请求通道切到 TaoToken 的统一 API 入口交付可直接复制的settings.json和config.toml骨架并给出连通性验证方法。适合谁看已经在用 CodeGeeX 做代码补全、想统一管理 API Key 的开发者或者刚装完 CodeGeeX补全一直转圈、想排查通道问题的同学。我试过在 VS Code 和 IntelliJ IDEA 两个环境各跑一遍下面把配置骨架和踩坑点都摊开。先说清楚一件事CodeGeeX 插件本身有官方登录通道本文不是让你抛弃官方通道而是当你有统一 Key 管理需求、或者官方通道在你的网络环境下不稳定时多一个可切换的配置路径。TaoToken 在这里扮演的是统一 API 通道角色官网入口 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。2. 前置准备Key、模型名、插件版本三件事动手改配置前先把三样东西备齐否则后面填配置会卡住。第一是 API Key。登录 TaoToken 控制台在 API Keys 页面创建一个新 Key复制出来存好。控制台地址带 deep linkhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。创建时注意权限范围代码补全只需要基础调用权限不要勾选生产库直连类的高危权限。第二是确认你要用的模型名。CodeGeeX 补全场景对延迟敏感建议选响应快的代码模型。你可以在模型对话页面先试一下目标模型的响应速度https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。把模型名记下来配置里要填。第三是插件版本。VS Code 里在扩展面板搜 CodeGeeX确认版本号JetBrains 在 Settings Plugins 里看。老版本可能不支持自定义 API 基址建议升到较新版本。如果你用的是 JetBrains 系注意 IDEA、PyCharm、GoLand 的配置路径一致都是config.toml。注意改配置前先备份原文件。VS Code 的settings.json和 JetBrains 的config.toml都可能已有其他插件配置直接覆盖会丢东西。3. VS Code 侧settings.json 配置骨架VS Code 的用户配置在settings.json通过CtrlShiftPmacOS 是CmdShiftP输入Open User Settings (JSON)打开。CodeGeeX 的自定义通道配置项以codegeex.为前缀下面是可以直接复制的骨架{ codegeex.apiBaseUrl: https://taotoken.net/api, codegeex.apiKey: sk-你的TaoToken密钥, codegeex.model: 你的代码模型名, codegeex.enableCompletion: true, codegeex.completionDelay: 300, codegeex.maxTokens: 256, codegeex.temperature: 0.2, codegeex.requestTimeout: 15000, codegeex.enableCrossFileCompletion: true, codegeex.logLevel: info }逐项说明关键参数。apiBaseUrl填 TaoToken 的 API 基址注意结尾不要多加斜杠否则部分版本会拼出双斜杠导致 404。apiKey填你刚创建的 Key注意别把 Key 提交到 Git 仓库建议用 VS Code 的 settings 同步时排除这一项。model填你在模型对话页确认过的模型名。completionDelay是触发补全的延迟毫秒数默认值偏大调到 300 左右补全更跟手但网络差时容易发太多请求可以按实际调。maxTokens控制单次补全最大长度代码补全场景 256 够用调太大会拖慢响应。temperature补全场景建议 0.1 到 0.3太高会生成离谱代码。requestTimeout设 15000 毫秒网络波动时给足重试时间。enableCrossFileCompletion是跨文件补全开关项目大时开着更准但请求量会上升。logLevel设info方便排查稳定后可以改warn减少日志。如果你在团队里共享配置可以把非敏感项写进工作区的.vscode/settings.jsonKey 单独放用户配置避免泄露。4. JetBrains 侧config.toml 配置骨架JetBrains 系插件的配置走config.toml。文件位置因系统而异Windows 在%APPDATA%\JetBrains\产品版本\codegeex\config.tomlmacOS 在~/Library/Application Support/JetBrains/产品版本/codegeex/config.tomlLinux 在~/.config/JetBrains/产品版本/codegeex/config.toml。如果目录不存在手动建一个。[api] base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model 你的代码模型名 timeout_ms 15000 max_retries 2 [completion] enabled true delay_ms 300 max_tokens 256 temperature 0.2 cross_file true context_lines 50 [logging] level infoTOML 的语法和 JSON 不同字符串用双引号布尔值是小写true/false数字不加引号。base_url同样不要带尾斜杠。max_retries设 2 表示失败后重试两次网络不稳时有用但别设太大否则补全卡顿。context_lines控制补全时向上取多少行上下文50 行对多数文件够用超大文件可以调到 100但请求体变大响应会慢。改完config.toml需要重启 IDE 才生效这点和 VS Code 的热加载不同别改完没重启就说没生效。提示JetBrains 的配置文件路径里产品版本是类似IntelliJIdea2024.1这样的目录名别填错。找不到就用 IDE 的Help Show Log in Explorer定位配置根目录。5. 验证请求三步确认补全通道通了配置写完不算完得验证请求真的走通了。分三步。第一步看插件状态。VS Code 里点底部状态栏的 CodeGeeX 图标如果显示已连接且模型名正确说明基础配置读到了。JetBrains 在右下角状态栏看或者打开 CodeGeeX 工具窗口看连接状态。第二步发一个最小补全请求。新建一个.py文件输入注释# 计算两个数的和回车后在下一行等补全。如果 300 毫秒左右出现灰色占位代码按 Tab 能填入说明补全通道通了。如果一直转圈看下一步排查。第三步看日志确认请求地址。VS Code 打开View Output通道选 CodeGeeX能看到实际请求的 URL。确认是https://taotoken.net/api开头的地址而不是官方默认地址。JetBrains 在Help Show Log里找 codegeex 相关日志。如果你想更直接地验证 API 通道本身可以用 curl 打一发curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: 你的代码模型名, messages: [{role: user, content: 写一个Python快排函数}], max_tokens: 128 }返回里有choices字段和代码内容说明 Key 和通道都没问题。如果返回 401是 Key 错了返回 404多半是base_url拼错返回 429是频率限制调大completionDelay。6. 本篇常见错排查配置过程中最容易踩的坑集中在这几类。补全一直不出现。先确认enableCompletion是true再看apiBaseUrl有没有多余斜杠。如果日志里请求地址是官方默认地址说明配置项名写错了CodeGeeX 不同版本配置项前缀可能有差异以插件文档为准。返回 401 未授权。Key 复制时带了空格或者 Key 被禁用。重新在控制台生成一个注意复制完整。JetBrains 的config.toml里 Key 要用双引号包住。返回 404。base_url结尾多了/或者路径拼成了/api/v1/v1/...。正确基址就是https://taotoken.net/api插件会自己拼/v1/chat/completions。补全延迟高。completionDelay调小反而更卡因为请求发太密。先调回 500 观察同时把maxTokens降到 128contextLines降到 30减轻单次请求负担。跨文件补全不准。enableCrossFileCompletion开着但项目索引没建好等插件完成索引再试。大项目首次索引可能要几分钟。改了 config.toml 没生效。JetBrains 必须重启 IDEVS Code 的 settings.json 是热加载但个别项也要重载窗口。重启后还不行检查文件路径里的产品版本目录对不对。如果你在排查接入问题时需要对照文档接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。长期做编码和 Agent 场景的话可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。最后补一个实操细节VS Code 和 JetBrains 同时开 CodeGeeX 时两个客户端会各自发补全请求如果共用同一个 Key注意控制台里的频率。我一般只在一个 IDE 里开补全另一个用 Ask 问答模式这样请求量可控补全响应也更稳。配置骨架复制过去后先把model和apiKey换成你自己的其余参数按项目大小微调跑通一次补全再逐步加跨文件、调上下文行数比一次性全开更容易定位问题。