安装与初始设置

CodeGeeX 的安装非常简便，目前支持 VS Code、JetBrains 系列 IDE（IntelliJ IDEA、PyCharm、WebStorm 等）以及 Visual Studio。以 VS Code 为例，在扩展商店搜索“CodeGeeX”并点击安装，重启编辑器后侧边栏会出现 CodeGeeX 图标。首次使用需要登录账号，支持手机号或邮箱注册，也可以使用微信扫码快捷登录。登录后可在设置页面选择偏好语言（如 JavaScript、Python、Java）以及激活方式（可通过快捷键或自动触发）。建议开启“自动补全”模式，这样在输入时后端会自动推理并给出候选代码块。

基础代码补全：直接输入与快捷键触发

代码补全是 CodeGeeX 最核心的功能。你只需像平常一样敲代码，当光标停在某一行末尾时，CodeGeeX 会根据上下文推测后续代码并以灰色文字显示。按下 Tab 键即可采纳当前建议，按 Esc 键忽略。如果想主动获取建议，可以按 Alt+\（Windows/Linux）或 Option+\（macOS）触发一次完整补全。在 JetBrains IDE 中默认快捷键为 Ctrl+Shift+G。建议在复杂逻辑处（如循环、条件分支、函数体内部）主动使用快捷键，效果更佳。

自然语言生成代码：写好注释即会写代码

CodeGeeX 支持根据自然语言注释生成代码。在代码文件中输入中文注释，例如“// 读取 CSV 文件并返回数据框”，然后按下 Enter 键换行，CodeGeeX 会自动根据注释内容生成相应的 Python 代码。如果你使用英文注释，它也能同样处理。要使用此功能，确保注释与代码同在一个文件中，并且注释行后紧跟空行或代码行。在 JetBrains 中，你还可以在注释末尾按 Alt+Enter 选择“使用 CodeGeeX 生成代码”来获得更精确的候选项。生成的代码会直接插入到当前光标位置，可以手动编辑微调。

代码翻译：跨语言转换

当你需要将一段代码从一种编程语言翻译成另一种时，CodeGeeX 提供了专门的翻译功能。在 VS Code 中，选中需要翻译的代码段，右键菜单中选择“CodeGeeX：翻译代码”，或使用快捷键 Ctrl+Shift+G T。在弹出的对话框中选择目标语言（如将 Python 翻译为 Java），CodeGeeX 会生成对应代码并替换原选区。翻译结果通常保持语义一致，但建议对关键业务逻辑进行人工复核，因为不同语言的库和习惯有所差异。JetBrains 用户可以在代码编辑区域右键选择“CodeGeeX” -> “Translate Code”。

代码解释：理解别人的代码

阅读陌生代码时，可以借助 CodeGeeX 的“解释代码”功能。选中一段代码，右键菜单选择“CodeGeeX：解释代码”，或用快捷键 Ctrl+Shift+G E。它会以自然语言在侧边栏或新标签页中输出逐行或逐块的解释，包括所用算法、变量作用、边界条件等。这个功能非常适合学习开源项目或快速审查遗留代码。解释内容默认使用中文，你可以在设置中切换语言。注意，解释不会修改你的原代码，仅作为辅助阅读。

代码审查与优化建议

在编写完成后，CodeGeeX 还能辅助审查代码质量。选中一个函数或整个文件，使用快捷键 Ctrl+Shift+G R 触发“代码审查”。它会分析潜在问题，例如未使用的变量、可能的空指针异常、性能瓶颈等，并给出优化建议。优化建议通常以注释形式显示在对应代码行上方，或者以列表形式在输出窗口展示。你可以选择手动应用建议，或者让 CodeGeeX 直接修改代码（需确认两次）。这个功能特别适合在提交代码前快速扫雷，但建议不要完全依赖，仍需结合项目规范和团队约定。

多行选择与自定义提示词

对于更复杂的任务，CodeGeeX 支持通过“自定义提示词”进行生成。在 VS Code 中，按下 Ctrl+Shift+G P 打开提示词输入框，你可以输入类似“写一个用二分查找实现搜索的 Python 函数，时间复杂度 O(log n)”这样的描述，然后点击生成。生成的代码会插入到当前光标处。这种模式适用于补全不满足需求时的精确控制。另外，在 JetBrains 中可通过菜单“Tools” -> “CodeGeeX” -> “Custom Prompt”进入。提示词建议用英文或中文混合，描述越具体，生成结果越符合预期。

多文件上下文与全局搜索

CodeGeeX 在 VS Code 中支持跨文件上下文。当你打开多个相关文件时（例如一个类文件和它的测试文件），CodeGeeX 会自动感知工程中的变量和函数定义，从而给出更符合项目风格的补全。在 JetBrains 中，需要手动开启“Enable Cross-File Context”选项。此外，CodeGeeX 还提供了“语义代码搜索”功能：在侧边栏搜索框输入描述（如“查询用户登录状态的函数”），它会列出工程中相关的代码片段，方便快速定位。这个功能对大型项目尤其有用。

快捷键与效率技巧

为了充分利用 CodeGeeX，熟悉以下快捷键可以显著提升效率：

• 接受建议：Tab
• 拒绝建议：Esc
• 手动触发补全：Alt+\（VS Code） / Ctrl+Shift+G（JetBrains）
• 翻译代码：Ctrl+Shift+G T（VS Code）
• 解释代码：Ctrl+Shift+G E（VS Code）
• 代码审查：Ctrl+Shift+G R（VS Code）
• 打开自定义提示词：Ctrl+Shift+G P（VS Code）

建议在初次使用时通过官方文档或插件内的“快捷键参考”页面熟悉映射，JetBrains 用户可以在 Settings -> Keymap 中搜索“CodeGeeX”自行修改。

常见问题与调优方法

如果在使用中发现补全质量不佳，可以尝试以下调整：

• 增大“上下文窗口”值（在设置中调整 max_tokens），让模型看到更多历史代码。
• 关闭“自动补全”模式，改用主动快捷键触发，避免误判。
• 在注释中使用更具体的英文描述，例如将“排序”改为“使用快速排序对整数列表升序排列”。
• 定期更新插件版本，新版本会改进推理速度和准确性。

另外，CodeGeeX 完全免费使用，无需担心额度限制。如果在网络受限环境下工作，可开启离线模式（仅支持已有的缓存模型），但建议联网以获得最新模型效果。