Claude Code CLI 接入指南

概述#

Claude Code 是 Anthropic 推出的终端编程助手。APIMAX 提供兼容 Claude Messages API 的接口，因此只需配置 API 地址和 API Key，就可以继续使用 Claude Code 的项目分析、代码修改、命令执行和多轮会话能力。

本文使用以下配置：

API Key 属于敏感凭证。不要写入 Git 仓库、截图、工单正文或公开脚本。

使用前准备#

1. 登录 APIMAX 控制台。
2. 进入 API Keys，创建或复制一个可用 Key。
3. 在模型列表中确认账号可用的 Claude 模型名称。
4. 准备一个独立项目目录，不要直接在系统目录或包含大量私密文件的目录中启动 Claude Code。

安装 Claude Code#

已安装 Node.js 的 Windows、macOS 和 Linux 用户可以执行：

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

macOS 或 Linux 也可以使用官方安装脚本：

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

如果提示找不到 npm，请先安装 Node.js LTS；如果提示权限不足，优先使用 Node 版本管理器，避免长期使用管理员权限安装全局包。

永久配置#

Claude Code 的用户配置文件位于：

• Windows：%USERPROFILE%\.claude\settings.json
• macOS / Linux：~/.claude/settings.json

文件不存在时可以手动创建。写入以下内容，并将占位 Key 替换为控制台生成的 Key：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-apimax-key",
    "ANTHROPIC_BASE_URL": "https://api.apimax.ai",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

如果原文件已经包含其他设置，请只合并 env 字段，不要直接覆盖整个文件。JSON 不能包含注释、中文标点或多余逗号。

临时配置#

临时配置适合首次验证，关闭终端后失效。

PowerShell#

$env:ANTHROPIC_BASE_URL="https://api.apimax.ai"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-apimax-key"
claude

CMD#

set ANTHROPIC_BASE_URL=https://api.apimax.ai
set ANTHROPIC_AUTH_TOKEN=sk-your-apimax-key
claude

macOS / Linux#

export ANTHROPIC_BASE_URL="https://api.apimax.ai"
export ANTHROPIC_AUTH_TOKEN="sk-your-apimax-key"
claude

启动与验证#

进入项目目录后启动：

cd your-project
claude

也可以执行一次性验证：

claude "只回复：连接成功"

成功时会收到模型回复。进入交互模式后可使用 /model 查看或切换当前账号可用的模型。

常见问题#

401 或 API Key invalid#

• 检查 Key 是否完整，前后不能有空格或换行。
• 确认变量名是 ANTHROPIC_AUTH_TOKEN。
• 修改永久配置后重新打开终端。

403 或 model not allowed#

• 当前 Key 可能没有该模型权限。
• 在控制台模型列表确认模型名称，或在 Claude Code 中使用 /model 切换。

Network error#

• 检查 ANTHROPIC_BASE_URL 是否为 https://api.apimax.ai，不要额外拼接 /v1/messages。
• 检查代理、防火墙和 DNS 设置。
• 主入口不可达时，可临时将地址切换为控制台公布的备用 API 入口进行排查。

修改配置后没有生效#

• 确认编辑的是当前用户目录下的 settings.json。
• 用 JSON 校验工具检查格式。
• 完全关闭旧终端和 Claude Code 进程后重新启动。

安全建议#

• 为 Claude Code 单独创建 API Key，便于轮换和停用。
• 仅在可信项目目录中启动，并在执行命令前检查 Claude Code 的权限提示。
• 不要把 API Key 写进项目的 .env.example、README 或提交记录。
• Key 疑似泄露时，立即在控制台删除并创建新 Key。