AI 接口代理平台 - 使用帮助

Claude Code 集成指南

本平台提供与 Claude Code 完全兼容的 API 接口,您可以通过简单的配置将 Claude Code 连接到我们的服务。

什么是 Claude Code?

Claude Code 是 Anthropic 官方推出的命令行工具,可以帮助开发者在终端中直接使用 Claude AI 进行代码编写、调试和优化。通过本平台,您可以使用自己的 API Key 来访问 Claude 服务。

快速开始

1 获取 API Key

登录管理后台,在 "API Keys" 页面创建一个新的 API Key。请妥善保管您的 Key,它将用于身份验证。

2 安装 cc-switch 工具

使用 npm 全局安装 cc-switch 工具:

npm install -g cc-switch
3 配置代理服务

使用 cc-switch 添加本平台的配置:

cc-switch add ai202624 https://ai.202624.xyz your-api-key-here

其中:

  • ai202624 - 配置名称(可自定义)
  • https://ai.202624.xyz - 本平台的 API 地址
  • your-api-key-here - 您的 API Key
4 切换到本平台

使用以下命令切换到本平台的配置:

cc-switch use ai202624
5 开始使用

现在您可以正常使用 Claude Code 了!所有请求都会通过我们的代理服务转发到 Claude API。

claude-code

使用 cc-switch(推荐)

cc-switch 是一个方便的工具,可以帮助您在多个 Claude API 提供商之间快速切换。

常用命令

命令 说明
cc-switch add <name> <url> <key> 添加新的配置
cc-switch use <name> 切换到指定配置
cc-switch list 列出所有配置
cc-switch current 显示当前使用的配置
cc-switch remove <name> 删除指定配置

配置示例

# 添加本平台配置
cc-switch add ai202624 https://ai.202624.xyz sk-ant-xxxxx

# 查看所有配置
cc-switch list

# 切换到本平台
cc-switch use ai202624

# 查看当前配置
cc-switch current

# 启动 Claude Code
claude-code

其他配置方式

方式二:VSCode 扩展配置

如果您使用 VSCode 中的 Claude Code 扩展,可以通过以下方式配置:

1 打开 VSCode 设置

Cmd+,(Mac)或 Ctrl+,(Windows/Linux)打开设置页面

2 搜索 Claude Code 设置

在搜索框中输入 claude code 找到相关设置项

3 配置 API 设置

找到以下两个设置项并填入对应的值:

  • Claude Code: API Key - 填入您的 API Key(如:sk-ant-xxxxx
  • Claude Code: Base URL - 填入 https://ai.202624.xyz
提示:您也可以直接编辑 VSCode 的 settings.json 文件,添加以下配置:
{
  "claudeCode.apiKey": "sk-ant-xxxxx",
  "claudeCode.baseUrl": "https://ai.202624.xyz"
}

高级配置:使用环境变量(VSCode)

如果您希望通过环境变量的方式配置,可以在 VSCode 的 settings.json 中使用 claudeCode.environmentVariables 设置:

{
  "claudeCode.environmentVariables": {
    "ANTHROPIC_BASE_URL": "https://ai.202624.xyz",
    "ANTHROPIC_API_KEY": "sk-ant-xxxxx"
  }
}

配置说明:

注意:claudeCode.environmentVariables 是一个对象(键值对),不是数组。直接设置环境变量名和对应的值即可。

方式三:环境变量

如果不使用 cc-switch,也可以直接设置环境变量。在您的 shell 配置文件中添加以下内容(如 ~/.bashrc~/.zshrc):

# Claude Code 配置
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
export ANTHROPIC_BASE_URL="https://ai.202624.xyz"

然后重新加载配置:

source ~/.bashrc  # 或 source ~/.zshrc

方式四:临时使用

如果只是临时使用,可以在命令前直接设置环境变量:

ANTHROPIC_API_KEY="sk-ant-xxxxx" ANTHROPIC_BASE_URL="https://ai.202624.xyz" claude-code

API 端点说明

本平台提供以下 API 端点,完全兼容 Anthropic 官方 API:

端点 说明
GET /v1/models 获取可用模型列表
POST /v1/messages 发送消息(Anthropic 格式)
POST /v1/chat/completions 聊天补全(OpenAI 格式)
POST /v1/responses 响应接口(OpenAI 格式)

支持的模型

平台支持以下 Claude 模型:

使用示例

Python SDK 示例

import anthropic

client = anthropic.Anthropic(
    api_key="your-api-key-here",
    base_url="https://ai.202624.xyz"
)

message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude!"}
    ]
)

print(message.content)

cURL 示例

curl https://ai.202624.xyz/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

认证方式

API 支持两种认证方式:

注意:请妥善保管您的 API Key,不要将其提交到公共代码仓库或分享给他人。如果 Key 泄露,请立即在管理后台禁用或删除该 Key。

使用限制

根据您的账户配置,可能会有以下限制:

常见问题

Q: 如何查看我的使用情况?

A: 登录管理后台,在 "使用统计" 页面可以查看详细的 Token 使用量和费用统计。

Q: API Key 可以设置过期时间吗?

A: 可以。在创建 API Key 时,您可以指定过期天数。过期后的 Key 将自动失效。

Q: 遇到 401 错误怎么办?

A: 401 错误表示认证失败,请检查:

Q: 如何申请使用权限?

A: 登录后,在管理后台的 "模型申请" 页面提交申请,说明使用原因,等待管理员审批。

技术支持

如果您在使用过程中遇到任何问题,请联系管理员获取帮助。