Easy Claude Code
本文档由 Easy Claude Code 出品，辅助用户简单高效优惠地使用 Claude Code。国内用户无需 VPN，推荐使用中转服务，稳定优惠。
重要提示
- ✅ 国内用户无需翻墙：使用中转服务即可
- ✅ 无需 WSL：直接在 Windows 系统操作即可
- ⚠️ 使用前必做：使用
/model sonnet命令切换模型，省钱且效果够用
开始前准备：
目录
一键脚本安装（推荐新手）
如果您是第一次使用 Claude Code，推荐使用一键脚本进行无脑安装。
安装步骤
下载安装包
- 下载地址：https://pan.quark.cn/s/0f78c1a384a7
- 进入下载后的
Windows文件夹
观看视频教程
- 先点击
安装使用说明.mp4查看视频教程 - 视频非常简单，建议先看完
- 先点击
执行安装脚本
- 双击
启动前安装.bat文件 - 按照提示一步步操作即可
- 双击
配置密钥
- 已购买密钥：直接填入即可
- 未购买密钥：联系购买（微信：jopanda）
注意事项：
- 遇到问题请查看下方「常见问题解决」部分
- 如果一键脚本执行成功，后续步骤可以跳过
经验用户：配置密钥
如果您已经有使用经验，可以直接更换密钥即可。
获取密钥
没有密钥的用户请点击此处购买：https://easyclaude.com/store
激活流程：
- 获取密钥后访问控制台
- 登录即可自动激活使用（激活后开始计时）
- 如不想立即使用，可稍后再激活
密钥信息查看：
- API Key
- 已使用配额
- 剩余配额
- 有效期
必配参数：绕过认证
为什么需要绕过认证？
首次启动 Claude Code 时，如果不翻墙，会报以下错误（这是正常的）：
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
Please check your internet connection and network settings.
Note: Claude Code might not be available in your country.
Check supported countries at https://anthropic.com/supported-countries
此时会生成 .claude.json 配置文件，我们需要修改它来绕过 Claude Code 认证，跳过国家地区检查。
配置步骤
打开用户目录
- 按
Win + R键，弹出运行窗口 - 输入
%USERPROFILE% - 按回车键
- 按
编辑配置文件
- 找到
.claude.json文件 - 用记事本打开
- 在第一行添加以下配置：
- 找到
{
"hasCompletedOnboarding": true,
"numStartups": 102,
"installMethod": "unknown",
"autoUpdates": true,
"customApiKeyResponses": {
"approved": [
"y5uzksiX1SLzSL0k0J7F",
"0UbcFxYkBy8H5wG3SYhc",
"oLlWkmUntNeZGOxAXUAB",
"LWv0Rv44RiPJ6oSNZiQp",
"b6c41f4dd0e75de43a19"
]
}
}
重点：
"hasCompletedOnboarding": true这一行放在大括号后的第一行- 注意逗号位置，确保 JSON 格式正确
启动方式
Claude Code 提供三种启动方式，推荐使用方式 1（命令行执行）。
方式 1：命令行执行（推荐）
优势：
- ✅ 最简单快捷
- ✅ 无需修改系统配置
- ✅ 每次启动都有效
步骤：
打开命令提示符
- 按
Win + R - 输入
cmd - 按回车
- 按
执行启动命令
set ANTHROPIC_API_KEY=你的密钥 && set ANTHROPIC_BASE_URL=https://api.easyclaude.com && claude
注意：
- 将
你的密钥替换为从 Ecc 购买的实际密钥 - 命令必须在一行执行
如果执行成功，后面的方式 2 和方式 3 就不需要操作了。
方式 2：修改全局变量
如果您希望每次启动都自动加载配置，可以设置系统环境变量。
步骤：
打开系统属性
- 按
Win + R - 输入
sysdm.cpl - 按回车
- 按
进入环境变量设置
- 点击「高级」选项卡
- 点击「环境变量」按钮
新建环境变量
点击「新建」按钮（用户变量或系统变量均可），创建以下两个环境变量：
| 变量名 | 变量值 |
|---|---|
ANTHROPIC_API_KEY |
你的密钥（从 Ecc 获取） |
ANTHROPIC_BASE_URL |
https://api.easyclaude.com |
- 保存并重启
- 点击「确定」保存
- 重启命令提示符（或重启电脑）
方式 3：修改配置文件
通过配置文件的方式持久化配置。
步骤：
打开用户目录
- 按
Win + R - 输入
%USERPROFILE% - 按回车
- 按
创建/编辑配置文件
- 找到
.claude文件夹（如不存在，先运行claude命令生成） - 进入文件夹，找到
settings.json文件 - 用记事本打开
- 找到
修改配置内容
{
"env": {
"ANTHROPIC_API_KEY": "你的密钥",
"ANTHROPIC_BASE_URL": "https://api.easyclaude.com"
}
}
注意：
- 保留引号和逗号
- 确保 JSON 格式正确
- 将
你的密钥替换为实际密钥
常见问题解决
Q1: 提示 Invalid API Key
原因：密钥复制粘贴出现错误。
排查方法：
- 检查配置文件
按 Win + R，输入 %USERPROFILE%，检查以下两个文件：
%USERPROFILE%\.claude\settings.json%USERPROFILE%\.claude.json
- 确认密钥格式
{
"env": {
"ANTHROPIC_API_KEY": "你的密钥",
"ANTHROPIC_BASE_URL": "https://api.easyclaude.com"
}
}
- 验证密钥
- 检查密钥是否有多余空格
- 确认密钥是否已激活
- 登录 Ecc 控制台查看密钥状态
Q2: 如何查看消耗用量？
方法 1：查看当前会话消耗
在 Claude Code 对话框中输入：
/cost
输出示例：
Total cost: $0.0166
Total duration (API): 2m 33.5s
Total duration (wall): 26m 6.9s
Total code changes: 0 lines added, 0 lines removed
Usage by model:
claude-3-5-haiku: 531 input, 72 output, 0 cache read, 0 cache write
claude-sonnet: 3 input, 13 output, 10.8k cache read, 3.3k cache write
方法 2：统计详细用量
打开新的命令行窗口，执行：
# 安装 ccusage 工具
npm install -g ccusage --registry=https://registry.npmmirror.com
# 查看消耗
ccusage
输出示例：
Claude Code Token Usage Report - Daily
Date | Models | Input | Output | Cache Create | Cache Read | Total Tokens | Cost (USD)
2025-08-04 | -sonnet-4 | 2,551 | 111,243 | 5,985,450 | 36,096,143 | 42,195,387 | $34.95
2025-08-05 | -opus-4 | 8,150 | 222,905 | 34,937 | 116,038,103 | 116,304,095 | $172.57
| -sonnet-4 | | | | | |
Total | | 10,701 | 334,148 | 6,020,387 | 152,134,246 | 158,499,482 | $207.52
用量计算标准（以日卡举例）：
- 金额和本地计算的 $10 靠齐
- Token 差不多一千万
Q3: 启动报错 claude: command not found
原因：Claude Code 未正确安装或环境变量未配置。
解决方法：
重新安装 Claude Code：
npm install -g @anthropic-ai/claude-code --ignore-scripts
验证安装：
claude --version
Q4: Windows WSL 下 Ubuntu 设置密钥报错
报错信息：
export key显示command not foundexport url显示no such file or directory
解决方法：
执行以下命令创建配置文件：
cat <<EOF | tee ~/.claude/settings.json
{
"env": {
"ANTHROPIC_API_KEY": "你的密钥",
"ANTHROPIC_BASE_URL": "https://api.easyclaude.com"
}
}
EOF
Q5: 如何安装 Node.js？
访问 Node.js 官网：https://nodejs.org/en/download
下载要求：
- 选择正确的架构（通常是 x64）
- 确保版本为 18.0 以上
安装方式：
- Windows Installer (.msi) - 推荐
- Standalone Binary (.zip) - 便携版
验证安装：
node -v # 应显示 v22.17.1 或更高
npm -v # 应显示 10.9.2 或更高
Q6: 如何升级 Claude Code？
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com
Q7: 如何重装 Claude Code？
卸载：
npm uninstall -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
清除缓存数据（可选）：
打开 PowerShell，执行：
# 删除配置文件
if (Test-Path "$HOME\.claude.json") { Remove-Item "$HOME\.claude.json" -Force }
if (Test-Path "$HOME\.claude") { Remove-Item "$HOME\.claude" -Recurse -Force }
# 清除环境变量
$vars = @(
"ANTHROPIC_API_KEY", "ANTHROPIC_AUTH_TOKEN", "ANTHROPIC_MODEL",
"CLAUDE_CODE_DISABLE_NON_ESSENTIAL_TRAFFIC", "DISABLE_AUTO_UPDATER",
"DISABLE_TELEMETRY", "DISABLE_ERROR_REPORTING", "HTTP_PROXY", "HTTPS_PROXY",
"SHELL", "NPM_CONFIG_IGNORE_SCRIPTS", "CLAUDE_CODE_GIT_BASH_PATH"
)
foreach ($v in $vars) { [Environment]::SetEnvironmentVariable($v, $null, "User") }
重装：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
重装后：
- 参考「必配参数：绕过认证」部分重新配置
- 重新设置密钥
总结
核心步骤回顾
✅ 选择安装方式：
- 新手：使用一键脚本
- 经验用户：直接配置密钥
✅ 配置绕过认证：
- 编辑
.claude.json - 添加
"hasCompletedOnboarding": true
- 编辑
✅ 选择启动方式：
- 推荐：命令行执行（方式 1）
- 可选：全局变量（方式 2）或配置文件（方式 3）
✅ 验证配置：
- 启动 Claude Code
- 查看是否正常工作
推荐配置流程（命令行方式）
# 1. 绕过认证（首次必做）
# 编辑 %USERPROFILE%\.claude.json，添加 "hasCompletedOnboarding": true
# 2. 启动 Claude Code
set ANTHROPIC_API_KEY=你的密钥 && set ANTHROPIC_BASE_URL=https://api.easyclaude.com && claude