KozeKoze
← 返回博客
教程2026年3月23日·管理员

claude code 配置教程

claude code 配置教程

📋 前置准备

在开始之前，请确保你已经：

  • 注册了 Koze 账号并登录
  • 在 API 管理 页面创建了一把 API Key
  • 已安装 Claude Code（npm install -g @anthropic-ai/claude-code）

🚀 步骤一：设置环境变量

在终端中执行以下命令，将 API 地址和密钥设置为环境变量：

# 设置 Koze 代理地址为 Base URL
export ANTHROPIC_BASE_URL="https://api.kozeai.com/v1"
# 设置你在 Koze 后台创建的 API Key
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

💡 提示：将 https://api.kozeai.com 替换为你的实际服务域名。API 密钥可在「API 管理 → 现有密钥」页面查看或创建。

🔧 步骤二：VSCode 插件配置（可选）

如果你使用 VSCode 的 Claude 插件，需要在 ~/.claude/config.json 中配置：

{
  "primaryApiKey": "你的API密钥",
  "apiBaseUrl": "https://api.kozeai.com/v1"
}

如果文件不存在，请手动创建。

  • macOS / Linux： ~/.claude/config.json
  • Windows： C:\Users\你的用户名\.claude\config.json

🎯 步骤三：启动 Claude Code

环境变量配置完成后，直接在终端启动：

claude

Claude Code 会自动使用你配置的 Koze 代理地址进行请求。

📌 持久化环境变量

为避免每次打开终端都要重新设置，建议将变量写入 shell 配置文件：

# Bash 用户
echo 'export ANTHROPIC_BASE_URL="https://api.kozeai.com/v1"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc
# Zsh 用户
echo 'export ANTHROPIC_BASE_URL="https://api.kozeai.com/v1"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

✅ 验证连接

启动 Claude Code 后，如果看到正常的对话界面，说明配置成功。你可以在 Koze 的「使用统计」页面查看实时调用记录。

⚠️ 常见问题

问题 解决方案
提示 "Invalid API Key" 检查 API Key 是否正确复制，确保没有多余空格
连接超时 确认 Base URL 是否正确，是否包含 /v1 后缀
模型不可用 在 Koze 模型大厅确认当前套餐可用的模型列表

 

claude code 配置教程 | Koze AI