要在 codegeex 中上传文件以生成更精准的代码、sql 或文档，必须使用网页版——唯一支持上传 .md、.sql、.zip 的官方渠道；vs code 插件和 cli 均不支持。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 CodeGeeX 中上传文件以生成更精准的代码、SQL 或文档，必须使用支持文件上传的入口，网页版是唯一能直接上传本地文件（如 .md、.sql、.zip）的官方渠道，VS Code 插件和 CLI 工具均不支持文件上传功能。
网页版上传 Markdown 需求文档
该方式适用于已有结构化需求说明、需批量转为代码草案的场景。
1、访问 CodeGeeX 官网「代码生成」页面，选择“从需求文档生成代码”模式。
2、点击“上传文件”按钮，选择单个 .md 文件（如 requirements.md），【不支持多选或拖拽文件夹】。
3、上传成功后，在下方提示框中明确指定目标语言和框架，例如：“生成 FastAPI 路由，接收 POST /v1/submit，解析 JSON body 中的 name 和 email 字段，校验邮箱格式并返回 201 响应”。
4、点击“生成”，等待分析完成，复制返回的 Python 草案代码。注意核对是否已预置 Pydantic 模型定义与 HTTP 异常处理分支。
网页版上传数据库 DDL 脚本
当你要生成上下文感知的 SQL 查询时，必须先让模型理解表结构，仅靠自然语言描述无法准确推断字段类型或外键关系。
方法一：粘贴建表语句
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
进入 CodeGeeX 网页端「数据库上下文」模块→在文本框中粘贴完整 CREATE TABLE 语句（含主键、索引、NOT NULL 约束）→点击“加载上下文”。
方法二：上传 DDL 文件
点击“上传文件”，选择本地 .sql 或 .txt 文件→【文件必须仅含标准 DDL 语句，不能混入注释、SET 命令或 USE database 语句，否则解析失败】→上传后系统自动提取表名与字段元数据。
网页版上传项目压缩包生成 README
这是为开源项目快速产出专业文档最高效的方式，适合已完成编码但尚未编写说明的开发者。
第一步：在本地打包项目根目录，确保压缩包内含 src/、lib/ 及 package.json 或 pyproject.toml 等工程标识文件。
第二步：进入 CodeGeeX 官网「项目文档」页面→点击“上传项目”→选择刚生成的 .zip 文件。
第三步：在模板选项中选择“Open Source Project README”→点击“生成文档”。
第四步：下载生成的 README.md，检查是否包含 API 概览表与贡献指南章节；若缺失，说明压缩包未正确包含依赖声明文件，需重新打包。
