Claude Code

安装并验证

官方推荐用原生安装脚本，无需 Node 环境；npm 方式仍可用，但已不再是推荐做法。装完运行版本号确认命令可用。

# macOS / Linux / WSL（推荐）
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell（推荐）
irm https://claude.ai/install.ps1 | iex

# npm 方式（仍可用，官方已不推荐）
npm install -g @anthropic-ai/claude-code

# 验证
claude --version

找到配置文件

Claude Code 从 settings.json 读取配置。写在用户级文件里所有项目都能复用；也可以在项目根目录放一份，只对该项目生效（项目级优先于用户级）。

Windows

%USERPROFILE%\.claude\settings.json

macOS

~/.claude/settings.json

Linux

~/.claude/settings.json

项目级

<项目根目录>/.claude/settings.json

写入配置

在 settings.json 的 env 块里填三项：接口地址、鉴权令牌、默认模型。地址走原生协议，不用带 /v1，Claude Code 会自己补全请求路径。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xylemnode.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_MODEL": "gpt-5.6-sol"
  }
}

或用系统环境变量

不想写进文件，也可以把同样三项设成系统环境变量，效果一致。Windows 用 setx 写入后要重开终端。

# Windows（PowerShell / CMD）
setx ANTHROPIC_BASE_URL "https://api.xylemnode.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"
setx ANTHROPIC_MODEL "gpt-5.6-sol"

# macOS / Linux
export ANTHROPIC_BASE_URL="https://api.xylemnode.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="gpt-5.6-sol"

首次启动前放行 onboarding

全新安装的 Claude Code 会先读取用户目录下的 .claude.json，检查里面的 onboarding 标记；标记缺失时它不读你刚配好的自定义地址，而是直接去连 api.anthropic.com，于是地址和密钥明明都填对了，首次运行照样报 Unable to connect to Anthropic services、Failed to connect to api.anthropic.com（403 或 ERR_BAD_REQUEST），卡在门口进不去。手动补上这个标记即可放行：文件不存在就照下面新建，已存在则把这一行并进最外层对象、保留原有内容，保存后重新运行 claude。注意 .claude.json 与前面 .claude 目录里的 settings.json 不是同一份，它和 .claude 目录同级——这类全局状态写进 settings.json 会被静默忽略，别放错位置。

Windows

%USERPROFILE%\.claude.json

macOS / Linux

~/.claude.json

{
  "hasCompletedOnboarding": true
}

启动并测试

进入项目目录运行 claude，发一条简单消息确认通路；用 /status 可以查看当前接入的地址和模型。

claude

# 非交互快速验证
claude -p "只回复 OK"