使用教程

三步接入：安装工具 → 一键配置 → 验证。

图文详细教程 ↗
尚未检测到可用的 API 令牌，请先到 API 令牌页面创建，然后把命令中的 your-token 替换为你的令牌。
STEP 1 · 安装
Terminal
# 官方安装脚本（推荐）
curl -fsSL https://claude.ai/install.sh | bash
 
# 或使用 Homebrew
brew install --cask claude-code
 
# 或使用 npm（需要 Node.js 22+，不要加 sudo）
npm install -g @anthropic-ai/claude-code
STEP 2 · 配置

推荐使用一键配置脚本，会自动写入环境变量与配置文件，并备份原有配置：

Terminal
curl -fsSL https://aicoding.inc/sh/claude-code-setup-obfuscated.sh | bash -s "your-token"

脚本会写入 ~/.zshrc / ~/.bashrc（fish 为 config.fish），完成后执行 source 或重开终端。

手动配置（可选）
Terminal
# 追加到 ~/.zshrc 或 ~/.bashrc，然后执行 source 或重开终端
export ANTHROPIC_BASE_URL="https://api.aicoding.inc"
export ANTHROPIC_AUTH_TOKEN="your-token"

请使用 ANTHROPIC_AUTH_TOKEN，不要同时设置 ANTHROPIC_API_KEY，否则会出现 Auth conflict。Base URL 不要带 /v1。

STEP 3 · 验证
Terminal
# 查看版本，能输出版本号即安装成功
claude --version
 
# 在项目目录中启动
claude

启动后发送任意一句话，能正常回复即配置成功；控制台「请求日志」中也能看到对应记录。

常见问题
提示 Auth conflict 或 401
  • 检查是否同时设置了 ANTHROPIC_API_KEY，如有请删除，只保留 ANTHROPIC_AUTH_TOKEN
  • 确认令牌未被删除或禁用，账户余额充足
  • 修改配置后需重新打开终端，旧会话中的环境变量不会自动更新
启动后仍要求登录 Anthropic 账号
  • 说明环境变量未生效，请重新打开终端后再启动 claude
  • 执行 echo $ANTHROPIC_BASE_URL 确认输出为 https://api.aicoding.inc
提示 command not found: claude
  • 官方脚本会安装到 ~/.local/bin，请确认该目录已加入 PATH
  • 重新打开终端，或运行 claude doctor 查看诊断信息