Guide
BerryCode 使用指南
给第一次接触 API 中转、终端和开发工具的用户看的完整说明。
为什么会有 BerryCode
很多 AI 编码工具本身很好用，但配置、模型额度、账单和网络环境会分散在不同地方。BerryCode 把这些环节合并到一个控制台：你只需要管理 BerryCode Key，再把不同客户端接到同一个入口。
这些工具到底是什么
| 名称 | 在 BerryCode 里的角色 |
|---|---|
| Codex | OpenAI 生态代码代理客户端，按 OpenAI compatible 地址接入。 |
| Claude Code | 命令行代码代理客户端，可通过 Messages 兼容入口调用 GPT 模型。 |
| OpenClaw / Hermes | 第三方开发工具或本地代理客户端，按文档写入 Base URL 和 Key。 |
| Cherry Studio | 图形化聊天/模型客户端，适合先验证 Key 和模型可用性。 |
什么是终端
终端就是输入命令的地方。Windows 可以用 PowerShell，macOS 可以用 Terminal，Linux 可以用系统终端。你安装 Node.js、设置环境变量、启动 Codex 或 Claude Code，通常都在终端里完成。
什么是 API Key
API Key 是客户端调用 BerryCode 的凭证，相当于机器使用的密码。不要把完整 Key 发给别人，也不要提交到 GitHub。每个客户端可以单独创建一个 Key，方便出问题时只停用某一个工具。
推荐使用习惯
- 长任务开始前确认余额，避免中途因余额不足中断。
- 每个工具单独创建 Key，命名为
codex-mac、claude-workstation这类可识别名称。 - 遇到模型名错误，优先检查是否写成了 Sonnet、Opus 或 Gemini。
- 调试时先用短 prompt 验证，再执行大规模代码任务。