Skip to main content

开始前

请先确认你已经完成以下准备:
  • 已在服务控制台创建 API 密钥
  • 已确认当前机器使用的是 zshbash 或 PowerShell

配置步骤

macOS / Linux / WSL

当前终端临时生效

永久生效

将以下内容写入 ~/.zshrc
加载配置:
如果使用 bash,请改写入 ~/.bash_profile~/.bashrc

或者写入配置文件 settings.json

文件路径:
示例:

Windows

当前终端临时生效

永久生效

在 Windows 环境变量中新增系统变量:

或者写入配置文件 settings.json

文件路径:
示例:

验证方式

配置完成后,建议执行以下验证:
  1. 重新打开终端
  2. 启动 Claude Code CLI
  3. 发送一个简单问题,例如 hi
  4. 若模型能正常返回结果,则说明配置成功

常见问题

环境变量和 settings.json 需要同时配置吗?

不需要,任选一种方式即可。

修改配置后为什么没有生效?

请先确认是否重新打开了终端,或是否执行了 source ~/.zshrc 等加载操作。

相关页面