Claude Code 使用说明

摘要

针对Claude Code安装难、费用高、使用门槛高等痛点,提供免墙低价版本和详细教程,支持Windows/Mac一键安装,搭配Claude 4官方直连,助你快速掌握AI编程工具。

最近 Claude Code 非常火,它其实已经超出了传统 AI 编程的范畴了,变成了通用 Agent,可以一句话去爬虫、开发网站、甚至调用 MCP 去扩展无限玩法。

但很多人还没用上,1 是设备装不上、翻不出去,2 是官方费用太高了,3 是不知道怎么玩

针对这些问题,饼干哥哥来帮大家解决了,我们团队开发了 免墙低价的 Claude Code 版本,可以:

  1. 不论 windows 还是 mac 都一键安装

  2. 接入 Claude4,底层基于官方 Max 账号直连,稳定可靠,不掺假

  3. 免墙、中文低价计费,提供日卡、周卡、月卡爽用

  4. 搭配 Claude Code 交流群(仅付费),日常分享玩法经验,不定时送 token 活动

✅ 目前正在内测阶段,1 元体验 9.9 日卡尝鲜 一千万 token,加入交流群占坑,快人一步用上领先的 AI 生产力。

想要的直接私信 v 我即可,我逐个处理~

claude-code-tutorial-free-proxy

MAC

Mac 下 Claude Code 使用教程

安装

访问 nodejs 的下载链接 https://nodejs.org/en/download ,需要注意,选择正确的芯片结构,不对的话就选另一个,请确保 Node.js 版本为 18.0 以上或更高版本的。

claude-code-tutorial-free-proxy

确认安装成功:

node --version
npm --version

安装客户端,打开终端,执行:

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

如果执行报错:

claude-code-tutorial-free-proxy

执行如下命令:

npm prefix -g
sudo chown -R $(whoami) $(npm prefix -g)/{lib/node_modules,bin,share}
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

设置 Key

执行命令:

cat <<EOF | tee ~/.claude/settings.json
{
    "env": {
      "ANTHROPIC_API_KEY": "你的 Key 改下",
      "ANTHROPIC_BASE_URL": "https://ai.api123.pro"
    }
}
EOF

或者执行时候修改:

export ANTHROPIC_API_TOKEN=""
export ANTHROPIC_API_KEY=我们给的key
export ANTHROPIC_BASE_URL=https://ai.api123.pro

# 执行,如果挂了🪜请先关掉
clade

# 如果报错 Unable to connect to Anthropic services
# 请继续执行操作绕过 Claude Code 认证👇🏻

必做:绕过 Claude Code 认证

如果出现:

claude-code-tutorial-free-proxy

我们需要设置下不访问 Anthropic services,打开项目文件夹,终端启动 Claude Code:

# 一定要选你自己某个具体想要和 claude code 进行编程的目录
cd your_project
claude

这时候就会弹出登录认证网页或者提示网络连接失败,不用管,我们编辑 $HOME/.claude.json 添加新字段"hasCompletedOnboarding": true 即可:

vim ~/.claude.json

# 增加配置到顶层结构

最后我们在终端启动 claude 就可以开始对话了:

claude-code-tutorial-free-proxy

常见问题

查看消耗用量

如果你想看当前回话的消耗,直接在 claude 的对话框输入: /cost

claude-code-tutorial-free-proxy

如果你想统计具体的用量,打开一个新的终端,执行:

npm install -g ccusage --registry=https://registry.npmmirror.com
# 执行 ccusage 查看消耗
ccusage

claude-code-tutorial-free-proxy

如何重装 Claude Code

# 卸载
npm uninstall -g @anthropic-ai/claude-code
# 清除缓存数据
 rm -Rf ~/.claude
 rm -f ~/.claude.json

# 重装
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

更新完之后一定要看前面设置 KEY 下面的绕过 Claude Code 认证进行操作。

Windows

[!TIP]
不要用 wsl 客户端了,直接在 windows 系统里面操作即可
开始前请根据系统下载好相关软件,网盘地址见:xxx

小白用户一键安装脚本

[!TIP]
使用过请忽略这一步,这是针对没有操作安装过的用户一键无脑安装

下载后进入下载后的 Widnows 文件夹,先看以下视频教程,非常简单。看完之后双击启动前安装.bat文件按照流程一步步按照提示操作即可。

遇到问题往下查看 👉 常见问题部分。

关于视频中的密钥,已经购买有密钥的直接填入即可,如果没有,加微购买(还会定期分享使用经验)

经验用户:配置密钥

如果你是已经有使用经验的用户,那么直接换成从我们平台购买的 Key 即可,这里提供三个方法,请大家逐步尝试:

推荐 👉 命令行执行

按下键盘组合键 Win + R,弹出运行命令窗口,在运行窗口中输入 cmd,然后执行下面的命令,记得将命令里你的密钥更换下:

set ANTHROPIC_API_KEY=你的密钥 && set ANTHROPIC_BASE_URL=https://ai.api123.pro && claude

修改全局变量

按 Win + R,输入 sysdm.cpl

claude-code-tutorial-free-proxy

点击高级-> 环境变量

claude-code-tutorial-free-proxy

点击新建(加系统的环境变量),然后创建两个环境变量:

  • ANTHROPIC_API_KEY

  • ANTHROPIC_BASE_URL

这两个变量的值我们客服都会发送给你。

修改配置文件

  • 打开运行窗口

    • 按下键盘组合键 Win + R
    • 弹出运行命令窗口
  • 访问用户目录

    • 在运行窗口中输入 %USERPROFILE%
    • 按回车键打开当前用户目录
  • 编辑配置文件

    • 找到 .claude/settings.json 文件(若不存在请先运行 Claude 程序生成或者手动创建)
    • 用记事本打开该文件
  • 修改 API 配置(保留引号和逗号)

    • "ANTHROPIC_API_KEY": "替换为你的 key",
    • "ANTHROPIC_BASE_URL": "替换为你的 url"
{
    "env": {
      "ANTHROPIC_API_KEY": "我们的 Key",
      "ANTHROPIC_BASE_URL": "https://ai.api123.pro"
    }
}

claude-code-tutorial-free-proxy

配置好密钥之后就可以启动 Claude 了,在 Windows 系统中启动 Claude 命令行工具,首先按下 Win+R 组合键打开运行窗口,输入 cmd 并回车进入命令提示符界面。

在终端中输入 claude 命令后回车执行,等待 5-10 秒初始化,当出现">"提示符即表示启动成功。

常见问题

无法上传图片

我去翻了下相关 issue 确定了就是 终端模拟器 支持度不够导致的无法粘贴渲染成 [image] 这样

claude-code-tutorial-free-proxy

绕过 Claude Code 认证,跳过国家地区检查

👇🏻 或者运行提示:Unable to connect to Anthropic services

claude-code-tutorial-free-proxy

这是因为 Claude Code 是海外产品,国内环境会受到影响,如果你有 🪜 就翻墙设置代理,没有的话也没关系,请按照以下的操作:

界面交互操作,按下键盘上的 Win+R 键,会弹出一个小窗口,在这个小窗口里输入 %USERPROFILE%,按下回车键。此时你会看到一些目录文件。

第一次进来没有 .claude.json 文件,先运行 claude 一次,报错如下(不要翻墙):

claude-code-tutorial-free-proxy

此时就会生成.claude.json 文件,用记事本打开.claude.json,编辑增加:

"hasCompletedOnboarding":true,

claude-code-tutorial-free-proxy

注意这里有逗号,放在大括号后第一行即可,继续启动 claude:

# win+r 输入 cmd, 打开终端命令行输入

set ANTHROPIC_API_KEY=你的密钥 && set ANTHROPIC_BASE_URL=https://ai.api123.pro && claude

claude-code-tutorial-free-proxy

大功告成。

提示 InvalidAPIKey

一般是因为密钥复制粘贴出现了差错,怎么排查?

按下键盘上的 Win+ 键,会弹出一个小窗口,在这个小窗口里输入 %USERPROFILE%,按下回车键。此时你会看到一些目录文件。

查看这两个文件:

  • %USERPROFILE%.claude\settings.json

  • %USERPROFILE%.claude.json

然后找到环境变量设置密钥即可:

参考配置密钥部分教程。

查看消耗用量

如果你想看当前回话的消耗,直接在 claude 的对话框输入: /cost

如果你想统计具体的用量,打开一个新的命令行窗口,执行:

npm install -g ccusage --registry=https://registry.npmmirror.com
# 执行 ccusage 查看消耗
ccusage

claude-code-tutorial-free-proxy

启动报错:claude:commandnotfound

建议重新安装:

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

Windows WSL 下 Ubuntu 设置密钥报错

报错:export key, export url,export key 的时候显示 command not found,export url 的时候显示 no such file or directory

执行命令:

cat <<EOF | tee ~/.claude/settings.json
{
    "env": {
      "ANTHROPIC_API_KEY": "你的 Key 改下",
      "ANTHROPIC_BASE_URL": "https://ai.api123.pro"
    }
}
EOF

Node 如何安装

访问 Node 官网 https://nodejs.org/en/download ,需要注意,选择正确的芯片结构,不对的话就选另一个,请确保 Node.js 版本为 18.0 以上或更高版本的

claude-code-tutorial-free-proxy

下载后点击安装。

如何升级 Claude Code

npm install -g @anthropic-ai/claude-code@latest  --registry=https://registry.npmmirror.com

如何重装 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_NONESSENTIAL_TRAFFIC","DISABLE_AUTOUPDATER",
 "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 Code 认证,跳过国家地区检查,请看第一个常见问题。

通用问题

出现以下问题,属于正常波动,输入 继续,让 Claude code 接上前面的任务继续跑即可。

claude-code-tutorial-free-proxy

怎么看自己花了多少 token?

npx ccusage@latest

claude-code-tutorial-free-proxy

Claude Code 各种玩法合集

成为代理

如果你也有用户资源,欢迎加微沟通成为代理:

claude-code-tutorial-free-proxy




👤 关于作者:饼干哥哥 & NGS
我是饼干哥哥,数据分析师、AI 博主,和出海业务专家朋友创立了公司 NGS NextGrowthSail,专注 AI 在出海营销场景下的落地。上周我们内部复盘 AI SEO 流量优化数据时,发现如果用上Claude Code这样的工具,内容生成效率能提升30%以上。

发表评论