Claude Code 安装使用教程

先完成终端版的最小直连验证

进入 apizt 控制台 → API 令牌 → 新建，选择支持目标模型及协议的分组，设置额度后复制令牌。已有令牌可继续使用；模型目录和权限不是同一回事。查看创建分组令牌的图文步骤。

export ANTHROPIC_BASE_URL="https://api.apizt.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_tokenba_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude --version
claude -p --model claude-sonnet-5 "What is 2 + 2? Answer with only the number."

原生目标是 /v1/messages。AUTH_TOKEN 对应 Bearer 鉴权；不要同时设置来源不明的 ANTHROPIC_API_KEY。持久配置合并到 ~/.claude/settings.json，不要提交含令牌的项目配置。

终端、桌面与路由分别配置

CLI 的环境变量不能直接作为 Claude Desktop 的通用设置。当前官方网关文档为桌面提供独立 third-party inference 入口；它与普通 Claude 聊天、Cowork 及 CLI 不应混为一谈。使用 CC Switch时，先区分原生 Messages 直连与 Chat/Responses 转换，再核对本地路由地址。

Claude Code 是 Anthropic 官方命令行工具，通过 apizt API 接入 Claude 大模型。它直接在本地项目目录里工作：读代码、辅助排查问题、生成实现、解释逻辑，整体更贴近真实开发流程。

https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/

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

claude --version

cd D:\your-project

claude

setx ANTHROPIC_BASE_URL "https://api.apizt.com"
setx ANTHROPIC_AUTH_TOKEN "你的 apizt API Key"

# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 通过 Homebrew 安装 Node.js
brew install node
# 验证安装
node --version

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

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
    "ANTHROPIC_BASE_URL": "https://api.apizt.com",
    "API_TIMEOUT_MS": "300000"
  }
}

cd your-project-folder

claude

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version

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

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
    "ANTHROPIC_BASE_URL": "https://api.apizt.com",
    "API_TIMEOUT_MS": "300000"
  }
}

cd your-project-folder

claude

直连与本地路由不要混用

本文设置 ANTHROPIC_BASE_URL，要求 Messages 兼容上游。如果使用 CC Switch 将 Chat Completions 转成 Messages，请改看 CC Switch 配置教程，由路由管理地址，不要再用旧环境变量覆盖。

真实调用记录与验证范围

测试日期：2026-09-28（Asia/Shanghai）；macOS 26.3。查看脱敏记录、软件版本和真实生成图片。一次文本成功仅证明本次请求，不代表其他模型、工具执行、多轮上下文或桌面版均已通过。

Claude Code 2.1.177
model: claude-sonnet-5
prompt: What is 2 + 2? Answer with only the number.
exit_code: 0
is_error: false
result: 4

首次提示“Reply exactly tokenba_OK”收到“I can't discuss that.”；不能把拒答当作认证失败。复核正常文本后返回 4。本次使用独立 CLAUDE_CONFIG_DIR 和 safe-mode，不改用户配置，关闭工具与会话持久化。

认证冲突、401、模型失败：鉴权与模型权限排查；使用本地路由的配置见 CC Switch 教程。