上手指南
上手指南 / Claude Code

Claude Code 命令行版

Claude Code 是 Anthropic 官方出的编程助手，在终端里运行。分三步：安装 → 写配置 → 启动验证。全程大约 5 分钟。

还没有密钥的，先看 创建密钥。不知道怎么打开终端的，先看 开始前先看这一页。

一、安装

macOS

打开「终端」，复制下面这行命令，粘贴后按回车：

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

看到 Installation complete! 就装好了。接着关掉终端窗口，重新打开一个，输入下面的命令检查：

bash
claude --version

显示一串版本号（如 2.1.319 (Claude Code)）就成功了。

注意

如果提示 command not found: claude，复制下面这行运行一次，然后再试 claude --version：

bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Windows

  1. 先装 Git（官方推荐，装了以后 Claude Code 干活更顺）：打开 git-scm.com/downloads/win，下载安装包，一路点「Next」用默认设置装完。

  2. 打开「Windows PowerShell」，复制下面这行命令，粘贴后按回车：

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

  3. 看到安装完成的提示后，关掉 PowerShell，重新打开一个，输入下面的命令检查：

    powershell
    claude --version

    显示一串版本号就成功了。

注意

如果提示"无法将 claude 项识别为……"，复制下面这行运行一次，关掉 PowerShell 重新打开，再试 claude --version：

powershell
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin", "User")

二、写配置（连到本站）

这一步把"本站地址"和"你的密钥"写进 Claude Code 的配置文件。写好之后，Claude Code 不会再要求你登录 Anthropic 账号，直接走本站。

先把你的密钥粘贴到页面顶部的输入框里，下面命令中的 sk-你的密钥 会自动换掉。然后复制对应系统的整段命令，粘贴到终端，按回车。

macOS：

bash
mkdir -p ~/.claude
[ -f ~/.claude/settings.json ] && cp ~/.claude/settings.json ~/.claude/settings.json.bak
cat > ~/.claude/settings.json <<'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://demo.aiplayer.club",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}
EOF
cat ~/.claude/settings.json

Windows（PowerShell）：

powershell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null
$f = "$env:USERPROFILE\.claude\settings.json"
if (Test-Path $f) { Copy-Item $f "$f.bak" -Force }
@'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://demo.aiplayer.club",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}
'@ | Set-Content -Encoding ascii $f
Get-Content $f

运行完，终端里会把文件内容显示一遍。检查两点：

  • ANTHROPIC_BASE_URL 后面是 https://demo.aiplayer.club。
  • ANTHROPIC_AUTH_TOKEN 后面是你自己的密钥，不是 sk-你的密钥 这几个字。
说明

以前用过 Claude Code 的，旧配置已经自动备份成 settings.json.bak。命令会用新内容覆盖原文件；原来有其他自定义设置的，从备份里手动合并回去。

三、启动并验证

1. 新建一个文件夹并进去启动。 Claude Code 会在你启动它的文件夹里干活，先建一个练习用的文件夹：

macOS：

bash
mkdir -p ~/ai-demo && cd ~/ai-demo && claude

Windows（PowerShell）：

powershell
New-Item -ItemType Directory -Force "$HOME\ai-demo" | Out-Null; cd "$HOME\ai-demo"; claude

2. 第一次启动会依次出现三个页面，照下面操作：

页面上写着 怎么做
Choose the text style that looks best with your terminal（选界面配色） 直接按回车
Security notes……Press Enter to continue（安全提示） 直接按回车
Quick safety check: Is this a project you created or one you trust?（是否信任这个文件夹） 按一下键盘 ↓ 方向键，选中 Yes, I trust this folder，再按回车
注意

第三个页面默认选中的是 No, exit（不信任并退出）。直接按回车会退出 Claude Code，重新运行一次 claude 再选就行。

3. 看到输入框就成功了。 界面上方会显示 Claude Code 的版本、当前模型和 API Usage Billing，下方有一个 ❯ 开头的输入框。全程不会出现登录页面。

4. 发一句话试试。 输入 你好，回复 OK 就行，按回车，几秒后看到回复，就说明连通了。

5. 到网站上确认。 回到 https://demo.aiplayer.club，点左侧「使用记录」，能看到一条刚产生的记录。

日常怎么用

  • 启动：打开终端，进入你的项目文件夹，输入 claude。
  • 退出：输入 /exit 回车，或连按两次 Ctrl + C。
  • 换模型：在输入框里输入 /model 回车，用方向键选择。模型越强价格越高，日常写代码用 Sonnet 就够了。
  • 查看当前配置：输入 /status 回车，能看到当前连的地址（应该是 https://demo.aiplayer.club）。

遇到报错，看 常见问题。