Claude API 接入教程

选择您的接入方式，按照教程快速开始使用 Claude 模型。

🔌
API 接入
直接调用 REST API
🔄
CCswitch 接入
Claude Code 代理切换
💻
原生命令行接入
Claude CLI 直接使用
📝
opencode 接入
opencode 编辑器集成

1 获取 API 密钥

在开始使用之前，您需要获取一个 API 密钥。请联系管理员获取您的专属 API 密钥。

API 密钥格式为：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

请妥善保管您的 API 密钥，不要将其泄露给他人或提交到公开代码仓库中。

2 API 端点

我们提供两种 API 格式，您可以根据需要选择：

Claude API 格式

POST {BASE_URL}/v1/messages

OpenAI API 格式

POST {BASE_URL}/v1/chat/completions
将 {BASE_URL} 替换为实际的服务地址，例如 http://localhost:3000 或您的部署域名。

3 支持的模型

以下是当前支持的 Claude 模型列表：

模型名称 说明
claude-sonnet-4-20250514 Claude Sonnet 4 - 平衡性能与速度
claude-opus-4-5-20251101 Claude Opus 4.5 - 最强大的模型
claude-3-5-sonnet-20241022 Claude 3.5 Sonnet
claude-3-5-haiku-20241022 Claude 3.5 Haiku - 快速响应

1 什么是 CCswitch

CCswitch 是一个 Claude Code / Codex 代理切换工具，提供可视化界面管理多个 API 供应商配置，支持一键切换不同的 API 端点。

主要特性：

  • 支持 Claude Code、Codex 等多种客户端
  • 可视化配置管理界面
  • 内置多种供应商模版（DeepSeek、GLM、ModelScope 等）
  • 支持自定义供应商配置
  • 配置导入/导出，方便备份迁移
CCswitch 项目地址：https://github.com/yiGmMk/ccswitch

2 安装 CCswitch 

go install github.com/yiGmMk/ccswitch@latest

从 GitHub Releases 下载对应平台的预编译二进制文件：

# 访问下载页面
https://github.com/yiGmMk/ccswitch/releases

3 配置文件位置

CCswitch 的配置文件存储在以下位置：

客户端 配置目录
CCswitch ~/.ccswitch/
Claude Code ~/.claude/
Codex ~/.codex/
CCswitch 支持配置的导入/导出功能，方便备份和迁移到其他设备。

4 添加供应商配置

启动 CCswitch 后，点击【添加供应商】按钮，可以选择两种配置方式：

CCswitch 内置了多种供应商模版，选择对应模版会自动填充配置信息：

  • DeepSeek
  • GLM (智谱)
  • ModelScope (魔搭)
  • 更多模版持续更新中...

选择模版后，只需填入您的 API Key 即可完成配置。

如果没有对应的供应商模版，可以选择【自定义配置】：

# 自定义供应商配置示例
名称: Kiro API
Base URL: {BASE_URL}
API Key: sk-your-api-key

将 {BASE_URL} 替换为实际的服务地址。

配置完成后点击【添加】保存，配置会显示在首页列表中。

5 启用配置

在配置列表中点击【启用】按钮激活对应的供应商配置：

  1. 在首页找到您添加的供应商配置
  2. 点击配置项右侧的【启用】按钮
  3. 启用成功后，根据提示重启 Claude Code
  4. 重启后即可使用新的 API 端点
您可以添加多个供应商配置，随时切换使用不同的 API 服务。

6 其他功能

功能 说明
导入配置 从文件导入已有的供应商配置
导出配置 将当前配置导出为文件，方便备份迁移
检查更新 在关于页面检查 CCswitch 是否有新版本
更新日志 查看 CCswitch 的版本更新历史

1 安装 Claude Code

Claude Code 是 Anthropic 官方的命令行工具，可以通过 npm 全局安装：

npm install -g @anthropic-ai/claude-code
安装前请确保已安装 Node.js 18 或更高版本。可通过 node -v 检查版本。

2 配置环境变量

设置 API 密钥和服务端点，使 Claude Code 连接到本服务：

添加到 ~/.bashrc 或 ~/.zshrc

export ANTHROPIC_API_KEY="sk-your-api-key"
export ANTHROPIC_BASE_URL="{BASE_URL}"

保存后执行 source ~/.bashrc 或 source ~/.zshrc 使配置生效。

PowerShell - 添加到 $PROFILE

$env:ANTHROPIC_API_KEY = "sk-your-api-key"
$env:ANTHROPIC_BASE_URL = "{BASE_URL}"

或者通过系统环境变量设置（永久生效）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-your-api-key", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "{BASE_URL}", "User")
将 {BASE_URL} 替换为实际的服务地址，将 sk-your-api-key 替换为您的 API 密钥。

3 启动您的第一个会话

在任何项目目录中打开终端并启动 Claude Code：

cd /path/to/your/project
claude

您将看到 Claude Code 欢迎屏幕，其中包含您的会话信息、最近的对话和最新更新。

输入 /help 查看可用命令，或输入 /resume 继续之前的对话。

4 基本使用

Claude Code 支持多种使用方式：

# 启动交互式会话
claude

# 直接发送消息
claude "你好，请介绍一下自己"

# 使用管道输入
cat file.txt | claude "请分析这个文件"

# 继续上一次对话
claude --resume

5 常用命令

命令 说明
claude 启动交互式会话
claude "message" 发送单条消息并获取回复
/help 查看所有可用命令
/resume 继续之前的对话
/clear 清除当前会话
/login 重新登录或切换账户
claude --version 查看版本信息

1 什么是 opencode

opencode 是一个开源的 AI 编程助手，支持多种 LLM 后端。通过配置，您可以使用本服务提供的 Claude 模型。

opencode 项目地址：https://github.com/opencode-ai/opencode

2 安装 opencode

使用包管理器安装 opencode：

brew install opencode-ai/tap/opencode
# 下载最新版本
curl -fsSL https://github.com/opcode-ai/opencode/releases/latest/download/opencode_linux_amd64.tar.gz | tar xz
sudo mv opencode /usr/local/bin/
go install github.com/opencode-ai/opencode@latest

3 配置 opencode

创建或编辑配置文件 ~/.config/opencode/config.toml：

[providers.anthropic]
api_key = "sk-your-api-key"
base_url = "{BASE_URL}"

[agents.coder]
model = "anthropic:claude-sonnet-4-20250514"
max_tokens = 8192

[agents.task]
model = "anthropic:claude-sonnet-4-20250514"
max_tokens = 8192
将 {BASE_URL} 替换为实际的服务地址，将 sk-your-api-key 替换为您的 API 密钥。

4 使用 opencode

在项目目录中启动 opencode：

# 进入项目目录
cd your-project

# 启动 opencode
opencode

opencode 会自动读取配置文件并连接到本服务。

5 常用快捷键

快捷键 功能
Ctrl+C 取消当前操作
Ctrl+L 清屏
Tab 自动补全
↑/↓ 浏览历史记录