常见问题解答(FAQ)
常见问题解答(FAQ)
Section titled “常见问题解答(FAQ)”本页面提供了在使用 Gemini CLI 过程中遇到的常见问题的答案和解决方案。
为什么我会遇到 API error: 429 - Resource exhausted？
Section titled “为什么我会遇到 API error: 429 - Resource exhausted？”这个错误表明您已经超出了 API 请求的限制。Gemini API 设有速率限制，以防止滥用并确保公平使用。
要解决此问题，您可以：
- 检查您的使用情况： 在 Google AI Studio 或您的 Google Cloud 项目仪表板中查看您的 API 使用情况。
- 优化您的提示： 如果您在短时间内发送了多个请求，请尝试批量处理提示或在请求之间引入延迟。
- 请求增加配额： 如果您始终需要更高的限制，可以向 Google 请求增加配额。
当我运行 npm run start 时，为什么我会遇到 ERR_REQUIRE_ESM 错误？
Section titled “当我运行 npm run start 时，为什么我会遇到 ERR_REQUIRE_ESM 错误？”这个错误通常在 Node.js 项目中出现，原因是 CommonJS 和 ES 模块之间存在不匹配。
这通常是由于您的 package.json 或 tsconfig.json 配置错误引起的。确保：
- 您的
package.json包含"type": "module"。 - 您的
tsconfig.json有"module": "NodeNext"或在compilerOptions中有兼容的设置。
如果问题仍然存在，请尝试删除您的 node_modules 目录和 package-lock.json 文件，然后再次运行 npm install。
为什么我在统计输出中看不到缓存的令牌计数？
Section titled “为什么我在统计输出中看不到缓存的令牌计数？”只有在使用缓存令牌时，才会显示缓存令牌信息。此功能适用于 API 密钥用户（Gemini API 密钥或 Google Cloud Vertex AI），但不适用于 OAuth 用户（例如 Google 个人/企业账户，分别是 Google Gmail 或 Google Workspace）。这是因为 Gemini Code Assist API 不支持缓存内容创建。您仍然可以使用 Gemini CLI 中的 /stats 命令查看您的总令牌使用情况。
我如何将 Gemini CLI 更新到最新版本？
Section titled “我如何将 Gemini CLI 更新到最新版本？”如果你全局安装了它，可以通过 npm 进行更新，使用以下命令
npm install -g @google/gemini-cli@latest。如果你从源代码编译的，从仓库拉取最新的更改，然后使用以下命令重新构建
npm run build。
平台特定问题
Section titled “平台特定问题”为什么在 Windows 上运行像 chmod +x 这样的命令时 CLI 会崩溃？
Section titled “为什么在 Windows 上运行像 chmod +x 这样的命令时 CLI 会崩溃？”像 chmod 这样的命令特定于类 Unix 操作系统（Linux、macOS）。在 Windows 上默认不可用。
要解决此问题，你可以：
- 使用 Windows 等效命令： 不要使用
chmod，你可以在 Windows 上使用icacls来修改文件权限。 - 使用兼容层： Git Bash 或 Windows Subsystem for Linux (WSL) 等工具在 Windows 上提供类 Unix 环境，在这些环境中这些命令将正常工作。
我应该如何配置我的 GOOGLE_CLOUD_PROJECT？
Section titled “我应该如何配置我的 GOOGLE_CLOUD_PROJECT？”你可以通过环境变量配置你的 Google Cloud 项目 ID。
在 shell 中设置 GOOGLE_CLOUD_PROJECT 环境变量：
export GOOGLE_CLOUD_PROJECT="your-project-id"为了使此设置永久生效，请将此行添加到你的 shell 启动文件中（例如，~/.bashrc，~/.zshrc）。
存储我的 API 密钥最安全的方法是什么？
Section titled “存储我的 API 密钥最安全的方法是什么？”在脚本中暴露 API 密钥或将它们检入源代码控制是一种安全风险。
为了安全地存储你的 API 密钥，你可以：
- 使用
.env文件： 在项目的.gemini目录（.gemini/.env）中创建一个.env文件，并在那里存储你的密钥。Gemini CLI 将自动加载这些变量。 - 使用你的系统的密钥环： 为了最安全的存储，使用你的操作系统的密钥管理工具（如 macOS Keychain、Windows 凭据管理器或 Linux 上的秘密管理器）。然后，你的脚本或环境可以在运行时从安全存储中加载密钥。
Gemini CLI 的配置和设置文件存储在哪里？
Section titled “Gemini CLI 的配置和设置文件存储在哪里？”Gemini CLI 的配置存储在两个settings.json文件中：
- 在你的主目录中：
~/.gemini/settings.json。 - 在你的项目根目录中：
./.gemini/settings.json。
有关更多详细信息，请参阅Gemini CLI 配置。
Google AI Pro/Ultra 和订阅常见问题
Section titled “Google AI Pro/Ultra 和订阅常见问题”我在哪里可以了解更多关于我的Google AI Pro 或Google AI Ultra 订阅的信息？
Section titled “我在哪里可以了解更多关于我的Google AI Pro 或Google AI Ultra 订阅的信息？”要了解更多关于你的Google AI Pro 或Google AI Ultra 订阅的信息，请访问你在订阅设置中的管理订阅。
我如何知道我是否拥有Google AI Pro 或 Ultra 的高限额？
Section titled “我如何知道我是否拥有Google AI Pro 或 Ultra 的高限额？”如果你订阅了Google AI Pro 或 Ultra，你将自动拥有Gemini代码辅助和Gemini CLI 的高限额。这些限额在Gemini CLI 和 IDE 中的代理模式之间共享。你可以通过检查你是否仍订阅了Google AI Pro 或 Ultra 来确认你有高限额，在订阅设置中查看。
如果我订阅了Google AI Pro 或 Ultra，使用Gemini代码辅助或Gemini CLI 的隐私政策是什么？
Section titled “如果我订阅了Google AI Pro 或 Ultra，使用Gemini代码辅助或Gemini CLI 的隐私政策是什么？”要了解更多关于受你的订阅管理和服务的隐私政策和条款，请访问Gemini代码辅助：服务条款和隐私政策。
我已经升级到Google AI Pro 或 Ultra，但仍然显示我正在达到配额限制。这是否是错误？
Section titled “我已经升级到Google AI Pro 或 Ultra，但仍然显示我正在达到配额限制。这是否是错误？”你在Google AI Pro 或 Ultra 订阅中的高限额适用于Gemini 2.5，包括Gemini 2.5 Pro 和 Flash。它们在Gemini CLI 和Gemini代码辅助 IDE 扩展中的代理模式之间共享配额。你可以了解更多关于Gemini CLI、Gemini代码辅助和代理模式的配额限制，在配额和限制中查看。
如果我通过购买 Google AI Pro 或 Ultra 订阅来升级 Gemini CLI 和 Gemini Code Assist 的更高限制，Gemini 会开始使用我的数据来改进其机器学习模型吗？
Section titled “如果我通过购买 Google AI Pro 或 Ultra 订阅来升级 Gemini CLI 和 Gemini Code Assist 的更高限制，Gemini 会开始使用我的数据来改进其机器学习模型吗？”如果你购买了付费计划，Google 不会使用你的数据来改进 Google 的机器学习模型。注意：如果你决定继续使用 Gemini Code Assist 的免费版本，即针对个人的 Gemini Code Assist，你也可以选择不使用你的数据来改进 Google 的机器学习模型。更多信息请参见针对个人的 Gemini Code Assist 隐私声明。