codebuddy 的 api 密钥设置需按版本（国际版、中国版、ioa 版）和接入方式（插件、cli、第三方模型）区分：先获取对应平台密钥，再通过环境变量（如 codebuddy_api_key 和 codebuddy_internet_environment）或配置文件 models.json 正确加载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy 的 API 密钥设置取决于你用的是哪种版本（国际版、中国版或 iOA 版）以及接入方式（插件、CLI 工具或第三方模型）。核心是两件事：拿到正确的密钥，并通过环境变量或配置文件正确加载。
一、先获取对应平台的 API Key
不同版本入口不同，务必选对：
- 国际版：访问 https://www.php.cn/link/b8fa01ae8c901c84c7021690375b9ee0，登录后创建并复制 Key
- 中国版：前往 https://www.php.cn/link/89eaa3ed65876d0a236597b512e31336，完成实名认证后获取
- iOA 版：使用企业内网账号登录 https://www.php.cn/link/38263b1bf2eae961299270e20d9b12fb
- 若接入 OpenAI/Gemini/Groq 等第三方模型，需分别去对应平台申请：
OpenAI → platform.openai.com/api-keys
Google AI → aistudio.google.com/app/apikey
Groq → console.groq.com/keys
二、配置环境变量（最常用且推荐）
这是个人开发者最稳妥的方式，尤其在终端或 CLI 场景下。关键点是：必须同时设置 CODEBUDDY_API_KEY 和 CODEBUDDY_INTERNET_ENVIRONMENT（中国版和 iOA 版不能省略）：
-
国际版（默认海外服务）：
export CODEBUDDY_API_KEY="sk-xxx"
无需设置CODEBUDDY_INTERNET_ENVIRONMENT，或显式设为public -
中国版：
export CODEBUDDY_API_KEY="your-key"export CODEBUDDY_INTERNET_ENVIRONMENT=internal -
iOA 版：
export CODEBUDDY_API_KEY="your-key"export CODEBUDDY_INTERNET_ENVIRONMENT=ioa
? 建议把这两行加到 ~/.zshrc（macOS）或 ~/.bashrc（Linux/WSL），然后运行 source ~/.zshrc 生效，避免每次重启终端重输。
Gemini Notebook网页版是一款基于AI的智能笔记工具，其核心功能是让用户上传个人文档（如PDF、文本等），并以此为基础进行交互。它能针对你的资料进行总结、解答疑问、生成新内容，让信息处理更高效。该版本为在线使用，无需下载安装。
三、VS Code 插件中配置第三方模型密钥
如果你用的是 CodeBuddy 插件并想调用 GPT、Gemini 或 Groq，走的是另一套路径：
- 打开 VS Code → 扩展市场搜 “CodeBuddy” 并安装
- 点击左侧 CodeBuddy 图标 → 右上角齿轮图标进入「Extension Settings」
- 展开 CodeBuddy: Model Providers，分别填入：
• OpenAI API Key（格式 sk-xxxx）
• Google Gemini API Key（格式 AIzaSy…）
• Groq API Key（格式 gsk_xxxx） - 点右上角磁盘图标保存，再从顶部「Model」下拉框选择对应模型即可使用
四、本地 CLI 工具（codebuddy）配置模型列表
适用于命令行启动的 CodeBuddy Code，需手动编辑配置文件：
- 找到配置路径：
macOS/Linux：~/.codebuddy/models.json
Windows：C:Users\.codebuddymodels.json - 新建或修改该文件，填入类似结构（注意替换
<user_api_key></user_api_key>）：{"models": [{"id": "tc-code-latest", "name": "Auto", "vendor": "Tencent Cloud", "apiKey": "<user_api_key>", "url": "https://api.lkeap.cloud.tencent.com/coding/v3"}]}</user_api_key> - 保存后运行
codebuddy启动，首次会提示选择登录方式（国内用户选「Log in via Chinese Site」）
配置完成后，输入简单指令测试（比如“写一个冒泡排序”），能返回结果就说明密钥已生效。常见失败原因：密钥复制带空格、环境变量没生效、网络无法访问对应服务端点（尤其是国内直连 OpenAI/Gemini 需代理）。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
