配置 Claude Code

Claude Code 配置第三方 API Key，从安装 Node.js、理解配置本质，到 macOS / Windows 写入配置文件并验证可用，超详细图文教程。

本文介绍如何用「AI 灵动」的 API 密钥配置 Claude Code。如果还没有 API 密钥，请先阅读 AI 灵动新手指南完成注册并获取密钥。

1. 安装 Node.js（如已安装可跳过）

无论 Mac 还是 Windows，Claude Code 都依赖 Node.js（≥ v18，建议 LTS）。

安装好 Node.js 后，验证：

node --version   # 应输出 v18.x.x 或更高
npm --version

然后全局安装 Claude Code：

npm install -g @anthropic-ai/claude-code
# 国内网络慢可加镜像源：--registry=https://registry.npmmirror.com

验证安装：

claude --version

2. 理解配置的本质

Claude Code 通过两个核心环境变量决定「请求发到哪、用什么密钥」：

变量	含义
`ANTHROPIC_BASE_URL`	https://ailindo.com
`ANTHROPIC_AUTH_TOKEN`	AI 灵动的 API Key

3. 创建 API 密钥

创建步骤见 AI 灵动新手指南 - 第二步：获取 API 密钥，已有密钥可跳过。

4. 配置 Claude Code

macOS 系统配置方法

这个操作的目的是，在文件 ~/.claude/settings.json 中写入配置，如果你能找到文件，直接修改即可。

打开「终端」，分别执行以下命令：

mkdir -p ~/.claude
nano ~/.claude/settings.json

把下面这段文本复制过去：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-ClZQs27fBVvCxxxxxxxxxxymF881AmxD3OO7",
    "ANTHROPIC_BASE_URL": "https://ailindo.com"
  }
}

保存，按 Ctrl + O
确认，按 Enter
退出，按 Ctrl + X

检查配置是否成功：

cat ~/.claude/settings.json

不建议设置到环境变量中，因为在 ~/.claude/settings.json 有任何其他值，都不会使用环境变量，也就是说这里的优先级更高。

Windows 系统配置 Claude Code

配置文件路径固定为：C:\Users\<你的用户名>\.claude\settings.json

打开 PowerShell，把下面这段代码复制进去后，按回车键：

$dir = Join-Path $env:USERPROFILE ".claude"
$settingsFile = Join-Path $dir "settings.json"
New-Item -ItemType Directory -Path $dir -Force | Out-Null

$settingsJson = @'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-ClZQs27fBVvCxxxxxxxxxxymF881AmxD3OO7",
    "ANTHROPIC_BASE_URL": "https://ailindo.com"
  }
}
'@
[System.IO.File]::WriteAllText($settingsFile, $settingsJson, (New-Object System.Text.UTF8Encoding($false)))
Write-Host "配置完成"

注意用 UTF-8 无 BOM 写入（上面脚本已处理），否则可能解析报错。

检查是否配置成功：

Get-Content "$env:USERPROFILE\.claude\settings.json"

5. 验证 Claude 是否可用

在你的项目目录下，打开终端，执行：

claude

初次使用会展示这样的界面：

Claude Code 初次运行界面

一直回车，显示这样的页面，就可以正常输入文字使用了：

Claude Code 可以正常使用