使用教程

几分钟即可上手。

什么是 Cloud2Claude？

Cloud2Claude 提供可靠的 Claude 和 OpenAI 模型访问服务。支持两种 AI 编程智能体：Claude Code（使用 Claude 模型）和 OpenAI Codex（使用 OpenAI 模型）。同一个 API 密钥两者通用。

创建账户

1. 创建账户

点击首页的"立即开始"按钮，或前往注册页面。输入邮箱、姓名和密码即可。

2. 创建 API 密钥

登录后，进入控制台的"API 密钥"页面。点击"创建密钥"，可选填标签，然后复制生成的密钥。请妥善保管——密钥不会再次显示。

Claude 模型

Claude Code

Claude Code 是 Anthropic 的 AI 编程智能体。Cloud2Claude 让你通过 Anthropic Messages API（/v1/messages）使用 Claude 模型（Sonnet、Opus、Haiku）。

设置以下环境变量后启动 Claude Code：

export ANTHROPIC_BASE_URL=https://api.cloud2claude.com
export ANTHROPIC_AUTH_TOKEN=<your-api-key>
claude

或将其添加到 shell 配置文件（~/.bashrc、~/.zshrc）以永久生效：

# ~/.bashrc or ~/.zshrc
export ANTHROPIC_BASE_URL=https://api.cloud2claude.com
export ANTHROPIC_AUTH_TOKEN=<your-api-key>

支持的 Claude 模型

  • •claude-sonnet-4-6 — Claude Sonnet 4.6
  • •claude-opus-4-7 — Claude Opus 4.7
  • •claude-haiku-4-5 — Claude Haiku 4.5

Claude Code 仅支持 Claude 模型，无法使用 OpenAI 模型（GPT 等）。

OpenAI 模型

OpenAI Codex

OpenAI Codex 是一个在终端运行的 AI 编程智能体。Cloud2Claude 通过 Responses API（/v1/responses）支持 Codex 使用 OpenAI 模型（GPT-5.x 等）。

1. 安装 Codex

通过 npm 全局安装 Codex CLI：

npm install -g @openai/codex

2. 创建配置文件

创建 Codex 配置文件，将其指向 Cloud2Claude。这会让 Codex 使用你的 Cloud2Claude API 密钥和接口，而非官方 OpenAI API：

在 ~/.codex/config.toml 创建文件：

model = "gpt-5.3-codex"
model_provider = "cloud2claude"

[model_providers.cloud2claude]
name = "Cloud2Claude"
base_url = "https://api.cloud2claude.com/v1"
env_key = "CLOUD2CLAUDE_API_KEY"
wire_api = "responses"

3. 设置 API 密钥

设置包含 Cloud2Claude API 密钥的环境变量。你可以在控制台的「API 密钥」页面找到你的密钥：

export CLOUD2CLAUDE_API_KEY=<your-api-key>

或将其添加到 shell 配置文件（~/.bashrc、~/.zshrc）以永久生效：

# ~/.bashrc or ~/.zshrc
export CLOUD2CLAUDE_API_KEY=<your-api-key>

4. 运行 Codex

在任意项目目录中启动 Codex：

codex

支持的 OpenAI 模型

  • •gpt-5.3-codex — GPT-5.3 Codex (default)
  • •gpt-5.5 — GPT-5.5
  • •gpt-5.4 — GPT-5.4
  • •gpt-5.4-mini — GPT-5.4 Mini
  • •gpt-5.1-codex-max — GPT-5.1 Codex Max
  • •gpt-5.2 — GPT-5.2

Codex 仅支持 OpenAI 模型，无法使用 Claude 模型。

你可以在 config.toml 中修改模型，或按会话临时切换：

codex --model gpt-5.4
codex --model gpt-5.5

使用技巧

  • •你的 Cloud2Claude API 密钥同时适用于 Claude Code 和 Codex，无需创建不同的密钥。
  • •Codex 支持推理深度控制（如 high 或 low），会自动透传给模型。
  • •用量和费用在 Cloud2Claude 控制台实时追踪，与 Claude Code 的用量显示方式相同。
  • •如遇到连接问题，请检查 API 密钥是否正确，以及账户余额是否充足。

用量与计费

您的账户采用人民币积分制。充值后按 Token 用量计费，外加每次 API 调用约 ¥ 0.01 服务费：

每次 API 调用费: ¥ 0.01（~$0.0015）

每次 API 调用收取约 ¥ 0.01 固定服务费

您可以随时在控制台查看用量、费用和交易记录。