Claude Code CLI

Anthropic 官方的命令行编码助手。装好后在终端里用 claude 启动。

第一步：安装

官方给了几种安装方式，选一种。安装包都从 Anthropic 官方渠道下载， 与本站无关 —— 网关是装完之后才配的。

方式一：官方安装脚本（推荐）

macOS / Linux：

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

方式二：包管理器

macOS 用 Homebrew：

brew install --cask claude-code

Windows 用 WinGet：

winget install Anthropic.ClaudeCode

方式三：npm

官方仍支持，但不是首选。需要 Node.js 22 以上：

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

确认装上了（三种方式通用）：

claude --version

正常会输出形如 2.1.211 (Claude Code) 的版本号 —— 看到版本号才算装好。

第二步：配置网关地址

Claude Code 读取环境变量决定请求发往哪里。把下面两行加进 shell 配置文件 （macOS / Linux 是 ~/.zshrc 或 ~/.bashrc）， 然后重开终端。

export ANTHROPIC_BASE_URL="https://api.juheai.shop"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

Windows PowerShell

临时生效（当前窗口）：

$env:ANTHROPIC_BASE_URL = "https://api.juheai.shop"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"

永久生效：

setx ANTHROPIC_BASE_URL "https://api.juheai.shop"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"

setx 写入后需要重开一个终端窗口才会读到。

第三步：启动并跳过首次登录引导

第一次运行 claude 时，它会引导你登录 Anthropic 官方账号。走网关时不需要登录， 正确的做法是用 ANTHROPIC_AUTH_TOKEN（第二步已经设置）—— 官方文档写明：AUTH_TOKEN 会立即优先于已保存的登录状态，因此不会再弹登录引导。

claude

启动后提示符上方会显示版本号、当前模型和工作目录；随便问一句能正常回答，就说明接通了。

一个容易被忽略的副作用：工具搜索被关

官方文档写明：ANTHROPIC_BASE_URL 指向非官方主机时， Claude Code 会默认关闭「工具搜索」（tool search，即工具的延迟加载）。 如果你的网关会转发 tool_reference 相关字段，可以显式打开：

export ENABLE_TOOL_SEARCH=true

不用 MCP、也不接一堆工具的话，这一节可以直接忽略。取值还支持 false / auto / auto:N。

常用命令

命令	作用
claude	在当前目录启动交互式会话
claude "帮我修这个 bug"	带一句初始指令启动
claude -p "解释这个文件"	单次提问后退出（脚本里用）
claude -c	继续上一次会话
/help	会话内查看全部斜杠命令
/clear	会话内清空上下文重新开始

项目级配置（可选）

不想改全局环境变量时，可以在项目根目录放一个 .claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.juheai.shop",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}

排查

报认证失败 / 一直让我登录

• 确认变量名是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY
• 确认 ANTHROPIC_BASE_URL 不带 /v1 —— 本站用 https://api.juheai.shop
• 改完环境变量要重开终端；setx 尤其如此
• 用 echo $ANTHROPIC_AUTH_TOKEN 确认它真的被读到了

提示模型不存在

模型名错了，或该模型你的分组没有权限。去网站「可用渠道」页面确认。 本站不支持的模型名不会自动回退，会直接报错。

连接超时

• 先确认网络能打开 https://api.juheai.shop
• 公司网络或代理软件可能拦截，试试关掉代理再连
• 确认密钥没过期、额度没用完

官方文档：code.claude.com/docs。 安装方式与变量名以其为准，本站不代为分发安装包。