跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt

Use this file to discover all available pages before exploring further.

​
快速开始

本指南将帮助您在几分钟内使用由 AIHubMix 提供的 Claude Code.

​
1. 安装 Claude Code

​
本地安装

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

​
使用 npm 安装

需要 Node.js 18 或更高版本 
npm install -g @anthropic-ai/claude-code

​
2. 配置 AIHubMix API

要通过兼容 Anthropic API 的方式来接入 AIHubMix 的模型服务，需要配置以下环境变量。
  1. 将ANTHROPIC_BASE_URL 设置为https://aihubmix.com
  2. ANTHROPIC_AUTH_TOKEN 设置为从 AIHubMix 平台 获取的 API Key
  3. ANTHROPIC_MODEL：设置为模型列表中支持的模型。
  1. 在终端中执行以下命令，查看默认 Shell 类型。
echo $SHELL
  1. 根据 Shell 类型设置环境变量，命令如下：
# AIHUBMIX_API_KEY 替换为你从 AIHUBMIX 平台获取的 Key
echo 'export ANTHROPIC_BASE_URL="https://aihubmix.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="AIHUBMIX_API_KEY"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5"' >> ~/.zshrc
  1. 在终端中执行下列命令，使环境变量生效。
source ~/.zshrc
  1. 打开一个新的终端，执行下列命令，查看环境变量是否生效。
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_MODEL

​
3. 开始使用

完成配置后，进入你的工作目录，在终端运行 claude 命令开始使用 Claude Code。 
$ cd /path/your-project
> claude
初次使用 Claude Code 时，可能会强制要求登录 Anthropic 账户。请按以下步骤操作以跳过该流程： Cc 7
  1. 定位用户主目录下的 .claude.json 文件，具体路径如下：
    • macOS / Linux: ~/.claude.json
    • Windows: C:\Users\%USERNAME%\.claude.json
  2. 设置hasCompletedOnboarding 字段的值为 true
{
  "hasCompletedOnboarding": true
}
  1. 保存文件，然后在终端中重新运行 claude 。

​
（可选）更多配置模型的方式

Claude Code 支持以下模型配置方式，按优先级从高到低排列，优先级高的配置会覆盖优先级低的配置。
  1. 对话期间： 执行/model <模型名称>命令切换模型。适用于临时切换模型。
/model claude-sonnet-4-5
  1. 启动 Claude Code 时： 执行claude --model <模型名称>指定模型。适用于单次会话。
claude --model claude-sonnet-4-5
  1. 设置环境变量：可按任务复杂度配置不同级别的模型，Claude Code 会根据任务类型自动选择合适的模型。适用于全局生效。
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
其中：
  • ANTHROPIC_DEFAULT_OPUS_MODEL：用于复杂推理、架构设计等高难度任务。
  • ANTHROPIC_DEFAULT_SONNET_MODEL：用于代码编写、功能实现等日常任务。
  • ANTHROPIC_DEFAULT_HAIKU_MODEL：用于语法检查、文件搜索等简单任务。
  1. 在 setting.json 配置文件中永久设置：在项目根目录或用户主目录创建settings.json文件，并写入模型配置信息，可分别进行项目级或用户级的永久配置。
{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

​
通过 cc-switch 配置

  1. 运行 CC-Switch，点击「添加供应商」。
Cc 1
  1. 在预设列表中选择「AiHubMix」。
Cc 2
  1. 在「API Key」栏中填写你的密钥。
Cc 3
  1. 配置完成后，复制想要选择的模型ID（以claude-opus-4-7 为例），点击「添加」保存设置。
    Img V3 02116 2b161aa5 E317 4cbb 800f 5933d520b55g
  2. 返回首页，在供应商列表中选择「AiHubMix」，点击「启动」即可使用。
Cc 5
Image
Tip: 终端打开 Claude Code后，输入 /status 可查询模型ID，输入/models 可选择配置的其他模型

​
通过 VS Code 插件配置

  1. 运行 VS Code，安装插件。
I Shot 2026 03 25 11 44 03
  1. 按下 Ctrl + Shift + P (或 Cmd + Shift + P)，输入 Settings 打开设置。
I Shot 2026 03 25 11 47 48
  1. 搜索 Claude Code ，找到 Claude Code: Environment Variable → Edit in settings.json 。
I Shot 2026 03 25 11 49 37
  1. 在 claudeCode.environmentVariables 中填入 AIHubMix 相关信息。
I Shot 2026 03 25 11 53 07

​
Wechat-Agent-SDK

通过简单的接口调用，一键将 Claude Code、Codex、Kimi 等主流 AI 智能体接入微信。支持 ACP 协议，纯本地运行，无需服务器、无需数据库，内置断点续传、自动重连等企业级特性，让您的 AI 助手轻松在微信中智能对话。
安装地址：https://github.com/AIhubmix/wechat-agent-sdk

​
常见问题

​
Q：在 Claude Code 中使用，提示「401 , No token provided…」

打开 Claude 终端，输入 /config ，找到 Use custom API key 选项，检查 Token 是否正确配置。 install

​
Q：macOS 中安装成功后仍然报错：zsh: command not found: claude

这是因为 Claude CLI 已安装，但其可执行目录未加入系统 PATH。
  1. 确认 Claude 安装路径。Claude Code 官方脚本通常安装在以下目录之一：
  • ~/.claude/bin
  • ~/.local/bin
在终端执行： 
ls -l ~/.claude/bin
或
ls -l ~/.local/bin | grep claude
如果看到 claude 文件，说明安装成功，只是 PATH 未配置。
  1. 将安装目录加入 PATH。根据实际安装位置执行对应命令：
情况 A：安装在 ~/.claude/bin
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
情况 B：安装在 ~/.local/bin
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
  1. 验证是否生效。执行：
which claude
claude -v
若能看到 claude 路径及版本号，说明安装成功。

​
Q：Claude Code 无法连接 Anthropic 服务

升级到最新版本的 Claude Code 后，若出现无法连接 Anthropic 服务或认证失败的情况，通常是由于认证请求头名称已发生调整所致。新版本要求将请求头由 ANTHROPIC_API_KEY 修改为 ANTHROPIC_AUTH_TOKEN，API Key 的值无需更换，仅需更新请求头名称并重新加载配置即可。具体操作可参考本文档重新配置。

​
更多资源

祝你使用愉快！