Claude Code 国内使用完整教程：API Key 获取 + 三端安装配置指南（2026最新） - 文章 - 开发者社区

🔧 Claude Code 国内使用完整教程：API Key 获取 + 三端安装配置指南

很多国内开发者想用 Claude Code，却卡在"API Key 怎么搞"这一步。本文手把手带你搞定，从获取密钥到启动使用，三个平台都有详细说明，还附了一键配置脚本，复制粘贴就能跑。

什么是 Claude Code？

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，直接集成在你的终端里。它不是那种得切换窗口、手动复制代码的工具——你可以直接在项目目录里跟它对话，让它读代码、改 bug、写功能、解释逻辑，效率提升非常明显。

picture.image

国内使用 Claude Code 的主要障碍是 API 访问问题。本文采用的方案是通过 uiuiAPI 聚合平台来转发请求——它为 Claude Code 提供了专属高速节点，配置方式也很简单，只需改一个配置文件。

支持的模型版本

目前 uiuiAPI 完整支持以下 Claude 主流模型：

模型	模型 ID	适用场景
Claude Opus 4.6（最强）	`claude-opus-4-6`	复杂任务、深度推理
Claude Sonnet 4.6（默认）	`claude-sonnet-4-6`	日常编程首选，速度与质量均衡
Claude Haiku 4.5（最快）	`claude-haiku-4-5-20251001`	轻量任务、快速响应

💡 默认启动时使用的是 Sonnet 4.6，大多数场景够用。如果你在做架构设计或复杂重构，可以切换到 Opus 4.6。

第一步：获取 API Key

访问 uiuiAPI 控制台 并注册登录
进入"令牌管理"，点击"新建令牌"
复制生成的密钥（格式通常为 sk- 开头）

picture.image

🪟 Windows 平台安装教程

步骤 1：安装 Node.js

推荐直接去 [Node.js 官网]https://nodejs.org 下载 LTS 版本的 .msi 安装包，一路下一步即可。

如果你喜欢用命令行，也可以用 winget：

winget install OpenJS.NodeJS.LTS

安装完成后，打开一个新的 CMD 或 PowerShell 窗口，验证一下：

node --version
npm --version

两个命令都有版本号输出就说明安装成功了。

步骤 2：安装 Claude Code CLI

以管理员身份打开命令行，执行：

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

安装完毕后运行 claude --version 确认是否正常。

步骤 3：配置 uiuiAPI

找到（或手动创建）以下路径的配置文件：

%USERPROFILE%.claude\settings.json

将以下内容填入文件中，把密钥替换成你自己的：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 uiuiAPI 密钥（sk-开头）",
    "ANTHROPIC_BASE_URL": "https://sg.uiuiapi.com"
  }
}

⚠️ ANTHROPIC_AUTH_TOKEN 必须填你自己的真实密钥，不能留占位符。

步骤 4：启动使用

打开命令行，cd 进你的项目目录，然后直接运行：

claude

首次启动会有一些初始化提示，按照指引操作即可。之后每次进项目目录敲 claude 就能用了。

步骤 5：切换模型

启动时指定模型：

claude --model claude-opus-4-6
claude --model claude-haiku-4-5-20251001

或者在已启动的会话中，直接输入：

/model claude-opus-4-6

picture.image

🍎 macOS 平台安装教程

步骤 1：安装 Node.js

推荐用 Homebrew 管理：

# 没装 Homebrew 的话先装它
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

验证：node --version 和 npm --version。

步骤 2：安装 Claude Code CLI

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

步骤 3：配置 uiuiAPI

在用户主目录下创建或编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 uiuiAPI 密钥",
    "ANTHROPIC_BASE_URL": "https://sg.uiuiapi.com"
  }
}

步骤 4：启动使用

cd 你的项目目录
claude

🐧 Linux 平台安装教程

步骤 1：安装 Node.js（以 Ubuntu/Debian 为例）

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

验证版本：node --version 和 npm --version。

步骤 2：安装 Claude Code CLI

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

步骤 3：配置 uiuiAPI

编辑 ~/.claude/settings.json，内容与 macOS 相同：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 uiuiAPI 密钥",
    "ANTHROPIC_BASE_URL": "https://sg.uiuiapi.com"
  }
}

步骤 4：启动使用

cd 你的项目目录
claude

一键配置脚本（省去手动编辑步骤）

如果觉得手动创建配置文件繁琐，直接用下面的脚本就行——运行后输入密钥，配置文件自动生成。

🪟 Windows 一键配置（.bat）

新建文本文件，粘贴以下内容，重命名为 uiuiAPI_Claude_Windows.bat，双击运行：

@echo off
chcp 65001 >nul
setlocal enabledelayedexpansion

echo ========================================
echo Claude Code - uiuiAPI Windows 一键配置工具
echo ========================================
echo.

set "CLAUDE_PATH=%USERPROFILE%.claude"

if not exist "%CLAUDE_PATH%" (
    mkdir "%CLAUDE_PATH%"
    echo [√] 已自动创建文件夹: %CLAUDE_PATH%
) else (
    echo [*] 文件夹已存在: %CLAUDE_PATH%
)

echo.
echo ========================================
set /p API_KEY="请输入您在 uiuiAPI 控制台获取的 API 密钥 (sk-开头): "

(
echo {
echo   "env": {
echo     "ANTHROPIC_AUTH_TOKEN": "%API_KEY%",
echo     "ANTHROPIC_BASE_URL": "https://sg.uiuiapi.com"
echo   }
echo }
) > "%CLAUDE_PATH%\settings.json"

echo.
echo [√] 配置文件已写入: %CLAUDE_PATH%\settings.json
echo.
echo 🎉 配置完成！打开新的命令行窗口，输入 claude 即可开始体验。
echo ========================================
echo.
pause

🍎🐧 macOS / Linux 一键配置（.sh）

新建文件，粘贴以下内容，保存为 uiuiAPI_Claude_MacLinux.sh，终端运行 bash uiuiAPI_Claude_MacLinux.sh：

#!/bin/bash

echo "========================================"
echo " Claude Code - uiuiAPI Mac/Linux 一键配置工具"
echo "========================================"
echo ""

CLAUDE_PATH="$HOME/.claude"

if [ ! -d "$CLAUDE_PATH" ]; then
    mkdir -p "$CLAUDE_PATH"
    echo "[√] 已自动创建文件夹: $CLAUDE_PATH"
else
    echo "[*] 文件夹已存在: $CLAUDE_PATH"
fi

echo ""
read -p "请输入您在 uiuiAPI 控制台获取的 API 密钥 (sk-开头): " API_KEY

cat > "$CLAUDE_PATH/settings.json" << EOF
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "$API_KEY",
    "ANTHROPIC_BASE_URL": "https://sg.uiuiapi.com"
  }
}
EOF

echo ""
echo "[√] 配置文件已写入: $CLAUDE_PATH/settings.json"
echo ""
echo "🎉 配置完成！在终端输入 claude 即可开始体验。"
echo "========================================"

picture.image

常见问题

Q：运行 claude 提示找不到命令？ 关掉当前终端窗口，重新打开一个新窗口再试，通常是环境变量需要刷新。

Q：提示 API 密钥无效或请求失败？ 检查 settings.json 里的密钥是否完整粘贴，前后不要有多余空格，BASE_URL 末尾不要加斜杠。

Q：Windows 上 .bat 脚本乱码？ 脚本开头已经加了 chcp 65001 切换为 UTF-8，如果还有问题可以在系统设置里把终端默认编码改成 UTF-8。

📢 版权声明：本文由界智通(jieagi)团队原创，转载请注明出处。我们专注于AI工具的深度评测和实用教程，关注我们不迷路！