Claude Code 使用指南

这页先把账号和令牌准备好，再配置 Claude Code。

先准备什么

• 一个可用的 Filifili 账号
• 一个可用的 API Key 或令牌
• 控制台给出的 Base URL
• Node.js 18 或更高版本

Windows

1. 安装 Node.js LTS。
2. 验证安装：

node --version
npm --version

3. 安装 Claude Code：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

4. 配置 .claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 Filifili API Key",
    "ANTHROPIC_BASE_URL": "你的 Filifili Base URL"
  }
}

5. 启动：

claude

macOS

1. 安装 Node.js：

brew install node

2. 安装 Claude Code：

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

3. 写入环境变量：

echo 'export ANTHROPIC_BASE_URL="你的 Filifili Base URL"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的 Filifili API Key"' >> ~/.zshrc
source ~/.zshrc

4. 启动：

claude

Linux

1. 安装 Node.js：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

2. 安装 Claude Code：

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

3. 写入环境变量：

echo 'export ANTHROPIC_BASE_URL="你的 Filifili Base URL"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的 Filifili API Key"' >> ~/.bashrc
source ~/.bashrc

4. 启动：

claude

VS Code

如果你还要在 VS Code 里用 Claude Code，建议先保证终端里的 CLI 能正常运行，再安装扩展。

配置思路不变：

• Base URL 填 Filifili 控制台给出的地址
• API Key 填你创建的令牌
• 如果客户端支持环境变量，就优先用环境变量

常见检查点

• 如果能启动但不能对话，先看 Base URL 是否写错。
• 如果提示鉴权失败，先确认 API Key 是否复制完整。
• 如果模型列表空白，先去 创建令牌 检查令牌状态，再确认模型名是否和控制台一致。

如果你要配桌面工具

如果不是 CLI，而是要配桌面工具，优先看 CC-Switch 快速配置，它可以先把同一套网关信息统一到一个地方，再让不同工具读取相同配置。