Claude Code 国内直连教程（2026最新）：一键配置指南+API Key获取

一、安装配置指南+API Key获取 🚀

Claude Code 是 Anthropic 推出的终端型 AI 编程助手。它的使用方式不是单独打开一个网页聊天，而是直接在本地项目目录里工作：读代码、辅助排查问题、生成实现、解释逻辑，整体更贴近真实开发流程。

对很多国内用户来说，真正的门槛通常不在工具本身，而在于 API 访问与配置。这篇文章把常见流程重新梳理成一套更清晰的步骤：先准备密钥和地址，再完成 CLI 安装，最后分别在 Windows、macOS、Linux 上完成配置与启动。

---

二、先了解一下 Claude Code 🌏

与传统网页型助手相比，Claude Code 更偏向“开发环境里的智能代理”。它运行在命令行中，通常用于这些场景：

• 在项目目录中直接分析代码结构
• 辅助修复 bug
• 批量重构代码
• 解释复杂逻辑或历史实现
• 根据需求快速生成功能草稿

如果你平时主要在终端、VS Code、远程服务器或本地仓库中工作，这类工具会更顺手。

---

三、常用模型选择思路

不同模型通常适合不同负载：

模型	典型用途	特点
Claude Opus 系列	架构设计、复杂重构、深度分析	质量更高，适合重任务
Claude Sonnet 系列	日常开发、代码解释、一般修改	速度和效果更均衡
Claude Haiku 系列	轻量问答、小任务、快速反馈	响应更快，成本通常更低

一般来说，默认用 Sonnet 做日常开发已经足够。只有在任务复杂度明显升高时，再切到 Opus 会更合适。

---

四、准备 API Key

在正式配置前，你需要先准备好可用的 API Key。常见流程通常是：

1. ❤️注册并登录国内可直连的API平台 QuickRouter API https://quickrouter.ai （这个平台注册就送免费体验额度）
2. ❤️进入令牌或密钥管理页面
3. ❤️新建一个 Key 或者用默认Key都行
4. ❤️复制并妥善保存该密钥

通常这类密钥会以 sk- 开头。实际使用时，不建议把密钥硬编码到脚本或公开仓库里。

---

五、Windows 安装与配置 🏡

1）安装 Node.js

Claude Code CLI 依赖 Node.js 运行环境。Windows 下可以直接安装 LTS 版本。

也可以使用 winget：

winget install OpenJS.NodeJS.LTS

安装后建议执行：

node --version
npm --version

如果两个命令都能正常输出版本号，说明运行环境已经就绪。

---

2）安装 Claude Code CLI

在 PowerShell 或 CMD 中执行：

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

安装完成后，再检查一次：

claude --version

---

3）写入配置文件

Windows 下常见配置路径为：

%USERPROFILE%\.claude\settings.json

如果目录不存在，可以手动创建。

示例配置如下：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换成你自己的APIKey",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai"
  }
}

说明：

• ANTHROPIC_AUTH_TOKEN 用来放 API Key
• ANTHROPIC_BASE_URL 用来指定请求入口
• 不要把示例占位符原样保存
• 地址末尾通常不要随手多加斜杠，除非平台文档明确要求

---

4）进入项目并启动

在终端进入你的项目目录后运行：

claude

首次启动时，CLI 可能会有初始化提示。按引导完成即可。

---

5）临时切换模型

可以在启动时直接指定模型：

claude --model your-model-name

也可以在会话内部切换：

/model your-model-name

---

六、macOS 安装与配置 💻

1）安装 Node.js

如果你使用 Homebrew，可以直接安装：

brew install node

安装完成后执行：

node --version
npm --version

---

2）安装 Claude Code CLI

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

---

3）创建或编辑配置文件

macOS 下常见路径：

~/.claude/settings.json

示例内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换成你自己的APIKey",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai"
  }
}

---

4）启动

cd 你的项目目录
claude

---

七、Linux 安装与配置 🐯

下面以 Ubuntu / Debian 类发行版为例。

1）安装 Node.js

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）配置 settings.json

Linux 与 macOS 类似，通常也是：

~/.claude/settings.json

示例：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换成你自己的APIKey",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai"
  }
}

---

4）启动工具

cd 你的项目目录
claude

---

八、一键配置方式（懒人福音）👍🏻👍🏻👍🏻

如果你不想手动创建 settings.json，可以直接用脚本自动生成。

Windows 一键配置版本（.bat） 🏡

第一步：新建文本文件，复制粘贴以下内容，重命名为 QuickRouter.bat，第二步：双击运行QuickRouter.bat

@echo off
chcp 65001 >nul
setlocal enabledelayedexpansion

echo ========================================
echo Claude Code - QuickRouter 一键配置工具
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="请输入您在 QuickRouter 控制台获取的 API 密钥 (sk-开头): "

(
echo {
echo   "env": {
echo     "ANTHROPIC_AUTH_TOKEN": "%API_KEY%",
echo     "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai"
echo   }
echo }
) > "%CLAUDE_PATH%\settings.json"

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

macOS / Linux 一键配置版本（.sh）💻

第一步：新建文件，复制粘贴以下内容，保存为 quickrouter.sh 第二步：在终端输入 bash quickrouter.sh 然后回车运行

#!/bin/bash

echo "========================================"
echo " Claude Code - QuickRouter 一键配置工具"
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 "请输入您在 QuickRouter 控制台获取的 API 密钥 (sk-开头): " API_KEY

cat > "$CLAUDE_PATH/settings.json" << EOF
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "$API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.quickrouter.ai"
  }
}
EOF

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

---

九、常见问题

1）输入 claude 后提示找不到命令

这通常说明：

• 当前终端还没刷新环境变量
• Node.js 或 npm 的全局安装路径没有被系统识别
• CLI 没安装成功

先关闭终端重新开一个窗口，再执行：

claude --version

如果还是不行，再检查 npm 全局路径是否正常。

---

2）提示 API Key 无效或请求失败

优先检查这些点：

• Key 是否完整复制
• 前后有没有多余空格
• settings.json 是否写成了无效 JSON
• Base URL 是否填写错误
• 请求地址是否与平台文档一致

---

3）Windows 下脚本乱码

可先确认批处理脚本开头是否包含：

chcp 65001 >nul

如果仍有乱码，再检查终端编码设置是否为 UTF-8。

---

4）模型切换后无效

这通常与以下原因有关：

• 模型名填写错误
• 当前平台未开通该模型权限
• 接入网关没有支持该模型
• 会话还在沿用旧模型配置

建议退出当前会话后重新启动，并再次显式指定模型。

---

十、建议的最小可用流程

如果你只想尽快跑通，按下面顺序即可：

1. 安装 Node.js
2. 全局安装 Claude Code CLI
3. 创建 ~/.claude/settings.json 或对应 Windows 配置文件
4. 写入 API Key 与 Base URL
5. 进入项目目录后执行 claude

这就是最基础的可用闭环。

---

十一、结语

Claude Code 真正有价值的地方，不只是“能聊天”，而是它更接近开发者原本的工作场景。只要把本地环境和 API 入口配置好，后续的体验基本就会顺很多。

如果你后面还想继续优化，可以再补充这些内容：

• 默认模型切换策略
• 多 Provider 路由
• 项目级环境隔离
• 与 VS Code、tmux、远程服务器的组合使用
• 团队内部统一配置模板

本文转自由界智通(jieagi)团队

---