配置 Claude Code

本章节将指导您如何配置 Claude Code 连接 AwesomeAPI 服务。

Note: Claude Code 是 Anthropic 协议的客户端，主要用于 Claude 系列模型。若要使用 OpenAI GPT 系列模型，请使用支持 OpenAI 兼容接口的客户端（例如 OpenCode、Cursor、Cherry Studio、Roo Code）。

获取 API Key

1. 访问 AwesomeAPI 并登录账号
2. 进入个人中心或 API 管理页面
3. 创建新的 API Key 并复制保存

Warning: 请妥善保管您的 API Key，不要泄露给他人或提交到公开仓库。

配置 API 端点

Claude Code 默认连接 Anthropic 官方 API，需要修改配置指向 AwesomeAPI。

方法一：环境变量配置（推荐）

在终端中设置环境变量：

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "http://8.130.53.188:3000"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"
$env:ANTHROPIC_MODEL = "claude-opus-4-6-thinking"

Windows CMD：

set ANTHROPIC_BASE_URL=http://8.130.53.188:3000
set ANTHROPIC_AUTH_TOKEN=your-api-key
set ANTHROPIC_MODEL=claude-opus-4-6-thinking

Linux / macOS：

export ANTHROPIC_BASE_URL="http://8.130.53.188:3000"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
export ANTHROPIC_MODEL="claude-opus-4-6-thinking"

方法二：永久配置

为避免每次都设置环境变量，可以将配置写入 shell 配置文件。

Windows PowerShell（写入 Profile）：

# 打开 PowerShell Profile 文件
notepad $PROFILE

# 添加以下内容后保存
$env:ANTHROPIC_BASE_URL = "http://8.130.53.188:3000"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"
$env:ANTHROPIC_MODEL = "claude-opus-4-6-thinking"

Linux / macOS（写入 .bashrc 或 .zshrc）：

# 编辑配置文件
nano ~/.bashrc  # 或 ~/.zshrc

# 添加以下内容
export ANTHROPIC_BASE_URL="http://8.130.53.188:3000"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
export ANTHROPIC_MODEL="claude-opus-4-6-thinking"

# 使配置生效
source ~/.bashrc  # 或 source ~/.zshrc

验证配置

配置完成后，运行以下命令验证：

claude "你好，请介绍一下自己"

如果能正常收到回复，说明配置成功。

配置选项说明

可用模型

请到 AwesomeAPI 模型广场 查看最新可用模型列表。

常见问题

连接超时

如果遇到连接超时，请检查：

• 网络是否正常
• API 地址是否正确
• 防火墙是否阻止了连接

API Key 无效

如果提示 API Key 无效：

• 确认 Key 是否正确复制（无多余空格）
• 确认账户是否有足够额度
• 尝试重新生成 API Key

环境变量未生效

• Windows：重启终端或运行 refreshenv
• Linux/macOS：运行 source ~/.bashrc 或重启终端

模型不可用

如果提示模型不可用：

• 确认 ANTHROPIC_MODEL 环境变量拼写正确
• 确认账户有权限访问该模型