Claude Code 安装、API 配置与 Windows 排错

使用 I Code Easy API Key 接入 Claude Code：先安装 CLI，再配置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL，重新打开终端后在项目目录运行 claude。Claude Desktop 则在图形界面单独设置 Gateway，步骤见本文后半部分。

开始前：账号、密钥和模型

1. 注册账号，登录后从 API Keys 复制本站密钥；不要填入登录密码。
2. 在 端点选择 为准备使用的模型系列选择并保存端点，具体流程见 快速开始。
3. 查看 价格、余额与用量 和 模型能力，确认模型 ID、适用条件与协议支持；安装客户端不代表获得 API 余额或模型权限。

密钥只保存在自己的客户端配置中。不要提交到 Git 或粘贴到公开截图；如泄露，请在 API Keys 页面轮换密钥。

第一步：安装 Claude Code

原生安装与 npm 安装选一种即可；npm 所需的 Node.js 和终端准备见 环境准备。

MacOS / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

原生安装会自动在后台更新，保持最新版本。

npm 安装（需先完成「环境准备」）

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

第二步：配置 API

下面的环境变量仅用于 Claude Code CLI；Desktop 不读取这里的 ANTHROPIC_BASE_URL 或 CLI 的 settings.json，请使用后文的独立设置。

Linux / MacOS 配置

下面的命令用于当前 shell；若要长期生效，添加到与你使用的 shell 对应的 ~/.bashrc 或 ~/.zshrc。把密钥占位符替换为自己的 API Key：

export ANTHROPIC_AUTH_TOKEN="你的API Key"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

不要设置 CLAUDE_CODE_ATTRIBUTION_HEADER=0；部分 Claude Code 专用通道会校验客户端原生归因信息。

如果 api.icodeeasy.cc 连接慢，可以把 ANTHROPIC_BASE_URL 换成 https://jp.icodeeasy.cc 或 https://sg.icodeeasy.cc。

保存后运行 source ~/.bashrc 或 source ~/.zshrc 使配置生效。

Windows 配置

在 PowerShell 中运行：

# 设置 API 密钥
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API Key", "User")

# 设置 API 接入地址
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.icodeeasy.cc", "User")

# 禁用非必要流量
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")

如果 api.icodeeasy.cc 连接慢，可以把 ANTHROPIC_BASE_URL 换成 https://jp.icodeeasy.cc 或 https://sg.icodeeasy.cc。

设置后需要重新打开 PowerShell 才能生效。

可以在新的 PowerShell 窗口中验证用户级环境变量：

-not [string]::IsNullOrWhiteSpace([Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User"))
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "User")

SetEnvironmentVariable 写入的是用户级持久环境变量，不会立即更新当前 PowerShell 会话。新开一个 PowerShell 窗口后再用 claude 启动。

检查 CLI 配置是否进入当前进程

macOS / Linux / WSL：下面只显示密钥是否存在，不会打印密钥：

[ -n "$ANTHROPIC_AUTH_TOKEN" ] && echo "Token configured" || echo "Token missing"
printf '%s\n' "$ANTHROPIC_BASE_URL"

Windows 请在新开的 PowerShell 中检查进程实际读到的值：

-not [string]::IsNullOrWhiteSpace($env:ANTHROPIC_AUTH_TOKEN)
$env:ANTHROPIC_BASE_URL

第一项应为 True，地址应与你选择的域名一致。只在用户级配置中存在密钥，而当前进程为 False，说明启动环境尚未刷新。VS Code 集成终端也可能继承编辑器启动时的旧变量，需要完全退出再打开编辑器。

WSL 使用 Linux 环境；在 Windows PowerShell 设置变量后，仍需在 WSL 的 shell 中按 Linux 步骤配置。Base URL 填域名，不要把 /v1/messages 请求路径拼到这里。

第三步：启动 Claude Code

先在终端确认安装版本：

claude --version

cd your-project-folder
claude

启动后输入 /status，核对当前模型、账号、凭证来源与网关 URL。它用于确认配置，不能代替一次真实请求验证。

先发送一个简短问题，确认收到回复，再到 请求日志 核对模型、状态和用量。安装完成、能打开 CLI 或能看见密钥存在，都不能单独证明 API 请求成功。

Claude Code 常见问题与恢复顺序

备用地址为 https://jp.icodeeasy.cc、https://sg.icodeeasy.cc，保留同一把本站密钥。它们用于连接恢复，不是更换账号或模型的步骤。更多网络排查见 连接与恢复。

反馈问题时提供客户端版本、操作系统、北京时间、脱敏错误正文和请求标识即可；不要发送 API Key 或完整环境变量转储。

在 Claude Code 中使用 Kimi 或 GLM

客户端、API 地址与模型名称是不同配置。仅设置 Base URL 并不会自动选择 Kimi 或 GLM。按 Kimi 配置 或 GLM 配置 设置模型，并在启动后核对选择；当前模型能力与使用条件以对应教程和能力目录为准。

Claude Desktop 图形版配置

Claude 桌面端图形版可以通过开发者模式直接配置第三方 API 网关。

Desktop 使用独立的 third-party inference 配置，不继承上文 CLI 环境变量。界面入口以安装版本为准；模型是否可用还需满足本站目录与端点条件，填写模型名不等于完成兼容性验证。

开启开发者模式

在菜单栏依次点击 Help -> Troubleshooting -> Enable Developer mode，然后重启 Claude Desktop。

配置 API 网关

重启后在菜单栏依次点击 Developer -> Configure third-party inference，按下面填写：

如果 api.icodeeasy.cc 连接慢，可以把 Base URL 换成 https://jp.icodeeasy.cc 或 https://sg.icodeeasy.cc。

设定模型

在模型名称中填入要使用的模型，例如 claude-opus-5-5 或 claude-sonnet-5-5，保存后重启 Claude Desktop。

同一套网关也可用于 Kimi、GLM；模型配置分别见 Kimi 配置 和 GLM 配置。固定使用 Claude Fable 5 时，见 Claude Fable 5 使用指南。

官方参考

• 安装与更新
• 环境变量
• 模型配置
• 第三方网关与 Desktop