注册与充值

创建帐号并为你的帐户充值，开始使用 AI Gate 服务。

注册帐号

▲ AI Gate 注册页面

充值

▲ 充值页面

创建令牌（API Key）

生成 API Key 用于访问 AI Gate 服务。

添加令牌

▲ 添加令牌入口

▲ 填写令牌信息

▲ 选择令牌分组

Windows 安装 Claude Code

在 Windows 系统上安装和配置 Claude Code。

前置条件

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

安装 Git

▲ Git 官网下载页面

git -v

安装 Node.js

官网下载 fnm（推荐）

1

下载 Node.js

访问 Node.js 官网 下载 LTS 版本安装包。

▲ Node.js 官网下载页面

2

安装并验证

powershell复制

node -v

✅

推荐使用 fnm：版本切换方便、升级无痛、不污染系统环境，且跨平台通用。

1

下载 fnm

访问 fnm 发布页面，下载 fnm-windows.zip 压缩包。

2

解压到固定目录

将压缩包内的 fnm.exe 解压到固定位置，例如 C:\fnm。

3

添加环境变量

按 Win + R，输入 SystemPropertiesAdvanced 回车。在「用户变量」中找到 Path，双击编辑，新增 C:\fnm，点击确定保存。

4

安装 Node.js

powershell复制

fnm install --lts
node -v

安装 Claude Code

▲ 打开 PowerShell 终端

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

claude --version

macOS 安装 Claude Code

在 macOS 系统上安装和配置 Claude Code。

系统要求

macOS 10.15 (Catalina) 或更高版本，需要 Git 2.23+ 和 Node.js 18+。

安装步骤

1. 安装 Node.js

node -v
npm -v

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

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

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

brew install node
node -v

2. 安装 Claude Code

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

3. 验证并启动

claude --version
claude

Linux 安装 Claude Code

在 Linux 系统上安装和配置 Claude Code。

系统要求

Ubuntu 18.04+、CentOS 7+、Debian 9+ 等主流发行版，需要 Git 2.23+ 和 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

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

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

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

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

sudo apt install nodejs npm
node -v

2. 安装 Claude Code

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

3. 终端输入 claude 打开

claude --version
claude

常规环境配置

手动配置 Claude Code 的 API 环境变量，连接到 AI Gate 服务。

Windows 环境配置

%userprofile%\.claude

▲ .claude 配置目录

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

▲ Claude Code 成功启动

macOS 环境配置

Zsh 用户（macOS 默认）：

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

Bash 用户：

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

Linux 环境配置

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

CC-Switch 配置

使用图形化工具管理 API 配置，支持一键切换多个 API 来源。

功能特点

下载安装

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

▲ CC-Switch GitHub 发布页面

配置 AI Gate API

▲ CC-Switch 主界面

▲ 添加 API 配置

▲ 填写 API Key 和请求地址

▲ 高级选项中填写模型名称

Codex CLI 设置教程

透过 AI Gate API 配置 Codex CLI，在终端中使用 OpenAI 模型能力。

Codex CLI 是 OpenAI 面向代码与终端任务设计的命令行工具，适合在本地终端完成代码修改、分析、生成和工程化操作。

前提条件

安装 Codex CLI

npm install -g @openai/codex
codex --version

配置文件位置

Codex CLI 使用 config.toml 进行配置：

快速配置（一键写入）

npm install -g @openai/codex

$configPath = "$env:USERPROFILE\.codex"
New-Item -ItemType Directory -Force -Path $configPath | Out-Null

@"
model = "gpt-4o"
model_reasoning_effort = "medium"
model_provider = "aigiva"

[model_providers.aigiva]
name = "AI Gate API"
base_url = "https://api.aigiva.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
"@ | Out-File -FilePath "$configPath\config.toml" -Encoding utf8

[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'sk-你的令牌', 'User')

codex --version
echo $env:OPENAI_API_KEY
codex "Hi"

npm install -g @openai/codex

mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
model = "gpt-4o"
model_reasoning_effort = "medium"
model_provider = "aigiva"

[model_providers.aigiva]
name = "AI Gate API"
base_url = "https://api.aigiva.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF

export OPENAI_API_KEY="sk-你的令牌"
codex "Hi"

设置 API Key

[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'sk-你的AI Gate令牌', 'User')

# Zsh (macOS 默认)
echo 'export OPENAI_API_KEY="sk-你的AI Gate令牌"' >> ~/.zshrc
source ~/.zshrc

# Bash (Linux)
echo 'export OPENAI_API_KEY="sk-你的AI Gate令牌"' >> ~/.bashrc
source ~/.bashrc

# Windows PowerShell
$env:OPENAI_API_KEY="sk-你的AI Gate令牌"

# macOS / Linux
export OPENAI_API_KEY="sk-你的AI Gate令牌"

验证配置

node -v && npm -v && codex --version

# Windows
echo $env:OPENAI_API_KEY

# macOS/Linux
echo $OPENAI_API_KEY

codex "Hi"

使用技巧

Claude Code 的常用命令、快捷操作与使用建议。

启动方式

claude

▲ Claude Code 启动界面

▲ 信任当前目录

常用命令速查

基础命令

会话管理

高级选项

交互式命令

实战练习路线

第一次使用 Claude Code，推荐按以下顺序练习：

需求模板

我想做一个【项目名称】。
目标用户是：【谁会用它】。
核心功能包括：
1. 【功能一】
2. 【功能二】
3. 【功能三】
请先给我项目结构和实现计划，等我确认后再创建文件。

AI 应用推荐

透过 AI Gate API，快速接入主流 AI 聊天与办公应用，让您的工作流程更加智能高效。

🍒 Cherry Studio

接入 AI Gate API

🚀 AionUi

核心特性

接入 AI Gate API

💬 Lobe Chat

手动配置步骤

🌊 流畅阅读（FluentRead）

专案地址：github.com/Bistutu/FluentRead

安装方式

配置方法

🔀 CC Switch

常见问题

使用过程中的常见问题及解决方案。

无法连接到服务

如果出现连接错误：

▲ 连接错误示例

解决方案（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"

常见问题汇总

node -v
npm -v

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

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

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