注册账号

充值

添加令牌

前置条件

Claude Code 需要以下环境，请逐项检查：

安装 Git

Git 是 Claude Code 的必要依赖，用于分析项目历史、执行代码提交等操作。

git -v

安装 Node.js

方式一：官网下载安装包

node -v

方式二：使用 fnm 安装 推荐

fnm (Fast Node Manager) 是一个快速的 Node.js 版本管理器，支持轻松安装和切换多个 Node.js 版本。

fnm install --lts
node -v

安装 Claude Code

npm install -g @anthropic-ai/claude-code

系统要求

• macOS 10.15 (Catalina) 或更高版本
• Git（macOS 通常已预装，终端运行 git -v 检查）
• Node.js 18+

安装步骤

1. 安装 Node.js

如已安装可跳过此步骤。

方式一：官网下载安装包

访问 Node.js 官网 下载 macOS 安装包，完成安装后在终端运行 node -v 验证。

方式二：使用 fnm 安装 推荐

fnm (Fast Node Manager) 是一个快速的 Node.js 版本管理器，方便切换和管理多个版本。

# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash

# 安装最新 LTS 版本
fnm install --lts
node -v

方式三：使用 Homebrew

brew install node

2. 安装 Claude Code

npm install -g @anthropic-ai/claude-code

补充：如果安装报错 error，使用管理员权限安装

sudo npm install -g @anthropic-ai/claude-code

再输入开机密码，回车，开始安装

3. 终端输入claude打开

系统要求

• Ubuntu 18.04+、CentOS 7+、Debian 9+ 等主流发行版
• Git 2.23+（运行 git -v 检查）
• Node.js 18+

安装步骤

0. 安装 Git（如未安装）

# Ubuntu / Debian
sudo apt-get update && sudo apt-get install -y git

# CentOS / RHEL
sudo yum install -y git

1. 安装 Node.js

方式一：官网下载安装包

访问 Node.js 官网 下载 Linux 安装包或二进制文件，完成安装后运行 node -v 验证。

方式二：使用 fnm 安装 推荐

fnm (Fast Node Manager) 无需 sudo，不污染系统环境。

# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash

# 重新加载 shell 配置
source ~/.bashrc

# 安装最新 LTS 版本
fnm install --lts
node -v

方式三：使用 NodeSource（Ubuntu/Debian）

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. 安装 Claude Code

npm install -g @anthropic-ai/claude-code

3. 终端输入claude打开

Windows 环境配置

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aixus.cn/",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌"
  }
}

macOS 环境配置

Zsh 用户（macOS 默认）：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://aixus.cn/"' >> ~/.zshrc
source ~/.zshrc

Bash 用户：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://aixus.cn/"' >> ~/.bash_profile
source ~/.bash_profile

Linux 环境配置

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://aixus.cn/"' >> ~/.bashrc
source ~/.bashrc

功能特点

• 一键切换 API 配置，在多个提供商之间快速切换
• 可视化配置管理，通过图形界面轻松管理
• MCP 服务器管理
• 系统托盘快捷操作

下载安装

访问 CC-Switch 下载页面，Windows 用户推荐下载 .msi 安装包。

配置 API

安装扩展

启动方式

常用命令

基础命令

会话管理

高级选项

前置条件

• Node.js 18+（安装方式参考 安装教程）
• Git 2.23+

安装

npm install -g @openai/codex

配置

macOS / Linux

export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_BASE_URL="https://aixus.cn/v1"

Windows (PowerShell)

$env:OPENAI_API_KEY="sk-你的令牌"
$env:OPENAI_BASE_URL="https://aixus.cn/v1"

配置步骤

前置条件

• Node.js 18+（安装方式参考 安装教程）

安装

npm install -g @google/gemini-cli

配置

macOS / Linux

export GEMINI_API_KEY="sk-你的令牌"
export GEMINI_BASE_URL="https://aixus.cn/"

Windows (PowerShell)

$env:GEMINI_API_KEY="sk-你的令牌"
$env:GEMINI_BASE_URL="https://aixus.cn/"

配置步骤

Windows 安装

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

# 方法1：用 pip 安装 uv
pip install uv

# 方法2：如果没有 pip，用 winget 安装
winget install astral-sh.uv

# 方法3：如果以上都不行，用 GitHub 镜像下载
Invoke-WebRequest -Uri "https://ghfast.top/https://github.com/astral-sh/uv/releases/latest/download/uv-x86_64-pc-windows-msvc.zip" -OutFile "$env:TEMP\uv.zip"
Expand-Archive "$env:TEMP\uv.zip" -DestinationPath "$env:LOCALAPPDATA\uv" -Force
$env:Path = "$env:LOCALAPPDATA\uv;" + $env:Path
uv --version

macOS 和 Linux 安装

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

等待安装完成

配置步骤

无法连接到服务

如果出现连接错误：

解决方案（Windows）

powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

令牌无效或余额不足

• 检查令牌是否正确复制（包含 sk- 前缀）
• 登录平台检查账户余额
• 确认令牌分组是否支持你使用的模型

响应速度慢

• 检查网络连接是否稳定
• 尝试切换到速度更快的模型（如 Gemini Flash）
• 减少单次请求的上下文长度

推荐配置

建议在 Claude Code 的配置文件中添加以下环境变量，以获得更稳定的使用体验：

打开配置文件 settings.json（位于 ~/.claude/settings.json，Windows 路径为 %userprofile%\.claude\settings.json），在 env 中添加：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aixus.cn/",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

常用模型推荐

分组说明

• Claude Max 号池：由 Claude Max 账号组成，稳定性高
• Codex 分组：支持 OpenAI 系模型
• Gemini 分组：支持 Google 系模型
• AWS Bedrock 分组：使用 AWS 官方服务，响应快

什么是缓存？

缓存是一种优化机制：

• 首次请求：发送内容时会创建缓存（有额外费用）
• 命中缓存：后续相似请求从缓存读取，价格极低
• 缓存时长：5 分钟适合频繁切换，1 小时适合专注同一项目

什么是上下文？

上下文是模型能处理的内容长度：

• 默认上下文：200K-256K tokens
• 特价分组：上下文可能更短
• 1M 上下文：适合处理超长内容

接入步骤

代码示例

cURL 直接调用

curl https://aixus.cn/v1/images/generations \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫坐在沙发上",
    "size": "3840x2160"
  }'

Python SDK

from openai import OpenAI
import base64

client = OpenAI(
    api_key="sk-你的Token",
    base_url="https://aixus.cn/v1",
)

res = client.images.generate(
    model="gpt-image-2",
    prompt="一只橘猫坐在沙发上",
    size="3840x2160",
)

with open("cat.png", "wb") as f:
    f.write(base64.b64decode(res.data[0].b64_json))

Node.js SDK

import OpenAI from "openai";
import fs from "fs";

const client = new OpenAI({
  apiKey: "sk-你的Token",
  baseURL: "https://aixus.cn/v1",
});

const res = await client.images.generate({
  model: "gpt-image-2",
  prompt: "一只橘猫坐在沙发上",
  size: "3840x2160",
});

fs.writeFileSync(
  "cat.png",
  Buffer.from(res.data[0].b64_json, "base64"),
);

图生图 / 参考图示例

GPT-Image-2 可以在 /v1/images/generations 请求里通过 image 传入参考图。参考图建议使用 Data URL 格式，例如 data:image/png;base64,...；如果只放纯 base64，请确保客户端不会自动加错 MIME 类型。

curl https://aixus.cn/v1/images/generations \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "参考这张图，保持主体和构图，改成高端电商海报风格，背景为浅灰影棚",
    "image": "data:image/png;base64,BASE64_IMAGE_DATA",
    "size": "2048x2048"
  }'

需要多张参考图时，image 可以传数组，例如 ["data:image/png;base64,...", "data:image/jpeg;base64,..."]。参考图越大，请求体越大，建议先压缩到清晰但不过度巨大的尺寸。

图形客户端适配

请求参数

常见错误

接入步骤

方式一：Gemini 原生接口（推荐）

文生图示例

curl "https://aixus.cn/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "生成一张 16:9 的写实产品图：一只透明玻璃杯放在雨后的城市窗台上，柔和自然光"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'

4K 示例

curl "https://aixus.cn/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "画一张电影海报风格的未来城市夜景，主体是一辆红色概念跑车"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "9:16",
        "imageSize": "4K"
      }
    }
  }'

图生图 / 参考图示例

Gemini 原生格式通过 inlineData 传入参考图，data 只放 base64 内容，不要带 data:image/png;base64, 前缀。

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "参考这张图，保持主体不变，改成清晨阳光下的水彩插画风格"
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "BASE64_IMAGE_DATA"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "2K"
    }
  }
}

方式二：OpenAI 兼容聊天接口

如果你的客户端更容易配置 OpenAI Chat Completions，可以调用 /v1/chat/completions。这种方式仍然使用上面的 Gemini 生图模型名，只是请求格式换成 OpenAI 消息格式。

文生图示例

curl "https://aixus.cn/v1/chat/completions" \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "messages": [
      {
        "role": "user",
        "content": "生成一张 16:9 的赛博朋克街景，霓虹灯，雨夜，电影感"
      }
    ],
    "extra_body": {
      "google": {
        "image_config": {
          "aspect_ratio": "16:9",
          "image_size": "2K"
        }
      }
    }
  }'

图生图示例

{
  "model": "gemini-3-pro-image-preview",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "基于参考图生成一张同构图的商业摄影图，背景改成纯白影棚"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,BASE64_IMAGE_DATA"
          }
        }
      ]
    }
  ],
  "extra_body": {
    "google": {
      "image_config": {
        "aspect_ratio": "1:1",
        "image_size": "2K"
      }
    }
  }
}

请求参数

响应格式

常见错误