Claude CLI 使用教程

1

安装 Node.js

访问 nodejs.org 下载并安装 LTS 版本

node --version npm --version

验证安装：显示版本号即成功

2

安装 Claude CLI

打开终端，执行以下命令：

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

验证安装：

claude --version

2.5

安装 Git

打开终端，执行以下命令（推荐）：

xcode-select --install

或使用 Homebrew：

brew install git

或下载安装包：

https://git-scm.com/download/mac

验证安装：

git --version

3

配置环境变量

在终端中执行以下命令（当前终端临时生效）：

export ANTHROPIC_AUTH_TOKEN=sk-您的API密钥 export ANTHROPIC_BASE_URL="https://ai.aigozero.top"

如需永久生效，写入 ~/.zshrc 后执行 source ~/.zshrc。

🎉 终端配置完成

现在您可以在终端中使用 claude 命令了！

💡 在编辑器中使用（可选）

VSCode 用户：前往扩展商店搜索 Dr-XIONG Claude 安装即可

Cursor 用户：将插件文件拖入扩展商店安装（下载插件文件）

安装后点击小猫图标，默认隐藏在下拉菜单中

!

常见问题：启动失败 / /login 无响应

🐛 问题现象

运行 claude 命令后出现以下情况：

Claude Code 无法启动，卡住不动
显示 /login 但没有任何响应
输入命令后长时间无反馈
提示配置错误或认证失败

⚠️ 问题原因

~/.claude/ 目录下的 settings.json 配置文件未正确生效，导致 Claude Code 无法读取 API 配置信息。

✅ 解决方案（推荐）

步骤一：进入用户目录，显示隐藏文件

# 在 Finder 中按快捷键显示隐藏文件 Command + Shift + . (同时按住这三个键)

步骤二：找到 .claude 目录

在用户目录下找到 .claude 文件夹（显示隐藏文件后可见）

步骤三：配置 settings.json 文件

在 ~/.claude/ 目录下创建或编辑 settings.json 文件，写入以下内容：

{ "apiKey": "sk-您的API密钥", "env": { "ANTHROPIC_AUTH_TOKEN": "sk-您的API密钥", "ANTHROPIC_BASE_URL": "https://ai.aigozero.top" }, "CLAUDE_CODE_ATTRIBUTION_HEADER": "0", "baseUrl": "https://ai.aigozero.top" }

⚠️ 请将 sk-您的API密钥 替换为您购买的实际 API 密钥

步骤四：保存并重启 Claude Code

# 保存文件后，在终端中运行 claude

🎉 配置完成

如果配置正确，Claude Code 将正常启动并可以使用！

💡 小提示

1. 确保 JSON 格式正确，注意逗号和引号

2. 文件路径：~/.claude/settings.json（~ 代表用户主目录）

3. 如果仍有问题，可尝试删除 ~/.claude 目录后重新配置

1

安装 Node.js

访问 nodejs.org 下载并安装 LTS 版本

node --version npm --version

验证安装：显示版本号即成功

2

安装 Claude CLI

打开命令提示符（CMD）或 PowerShell，执行以下命令：

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

验证安装：

claude --version

2.5

安装 Git

前往 Git 官网下载并安装：

https://git-scm.com/download/win

安装完成后，在终端中验证：

git --version

3

配置环境变量

在命令提示符（CMD）中执行以下命令：

setx ANTHROPIC_AUTH_TOKEN "sk-您的API密钥" setx ANTHROPIC_BASE_URL "https://ai.aigozero.top"

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

🎉 终端配置完成

现在您可以在终端中使用 claude 命令了！

💡 在编辑器中使用（可选）

VSCode 用户：前往扩展商店搜索 Dr-XIONG Claude 安装即可

Cursor 用户：将插件文件拖入扩展商店安装（下载插件文件）

安装后点击小猫图标，默认隐藏在下拉菜单中

!

常见问题：启动失败 / /login 无响应

🐛 问题现象

运行 claude 命令后出现以下情况：

Claude Code 无法启动，卡住不动
显示 /login 但没有任何响应
输入命令后长时间无反馈
提示配置错误或认证失败

⚠️ 问题原因

C:\Users\你的用户名\.claude\ 目录下的 settings.json 配置文件未正确生效，导致 Claude Code 无法读取 API 配置信息。

✅ 解决方案（推荐）

步骤一：进入用户目录，显示隐藏文件

# 打开文件资源管理器，进入以下路径： C:\Users\你的用户名\ # 然后点击顶部"查看" → 勾选"隐藏的项目"显示隐藏文件

提示：将"你的用户名"替换为你电脑的实际用户名，例如 C:\Users\Administrator\

步骤二：找到 .claude 目录

在用户目录下找到 .claude 文件夹（显示隐藏文件后可见）

步骤三：配置 settings.json 文件

在 .claude 目录下创建或编辑 settings.json 文件，写入以下内容：

{ "apiKey": "sk-您的API密钥", "env": { "ANTHROPIC_AUTH_TOKEN": "sk-您的API密钥", "ANTHROPIC_BASE_URL": "https://ai.aigozero.top" }, "CLAUDE_CODE_ATTRIBUTION_HEADER": "0", "baseUrl": "https://ai.aigozero.top" }

⚠️ 请将 sk-您的API密钥 替换为您购买的实际 API 密钥

步骤四：保存并重启 Claude Code

:: 保存文件后，在终端中运行 claude

🎉 配置完成

如果配置正确，Claude Code 将正常启动并可以使用！

💡 小提示

1. 确保 JSON 格式正确，注意逗号和引号

2. 文件路径：C:\Users\你的用户名\.claude\settings.json

3. 如果仍有问题，可尝试删除 .claude 目录后重新配置