Claude Code 使用指南

这份教程旨在让你在最短时间内完成 FlexAPI与Claude Code 的对接。

右侧为页面导航，可根据需要直接导航到指定位置

注意

Anthropic 官方已更新原生安装方案。

npm install -g @anthropic-ai/claude-code 现在已经是废弃安装方式，不再作为默认推荐。

官方状态

• 官方推荐安装方式：Native Install
• 支持平台：macOS、Linux、Windows
• Windows 额外要求：需要 Git for Windows，或者使用 WSL
• 更新方式：原生安装会自动后台更新；Homebrew 和 WinGet 需要手动更新

Step 1: 获取 API Key

1. 登录 FlexAPI 控制台

前往 FlexAPI，登录并选择对应的分组，创建 FlexAPI API Key。

2. 充值额度或购买订阅

按照使用模式，选择按时长订阅或充值额度按量付费。

3. 获取 API Key

在控制台创建或复制你的 FlexAPI API Key，后续配置 CLI 和客户端时都要用到。

参考：FlexAPI API获取教程

Step 2：Native Install

官方推荐使用 Native 安装方式，具有以下优势：

• 单个可执行文件，无需 Node.js 依赖
• 自动更新机制更稳定
• 启动速度更快

macOS / Linux / WSL

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

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

备选安装方式

如果你的团队已经标准化使用系统包管理器，也可以按官方文档使用：

Homebrew

brew install --cask claude-code

WinGet

winget install Anthropic.ClaudeCode

npm 已废弃

Anthropic 官方当前明确将 npm 安装标记为 deprecated。只有在兼容性原因下，才建议继续保留 npm 安装。

验证安装

claude --version
claude doctor

如果显示版本号，恭喜! Claude Code 已成功安装。

提示

安装前请确保移除任何过期的别名或符号链接。使用 claude doctor 命令可以检查安装类型和版本。

Step 3：配置

选择通过环境变量配置

Claude Code 的 LLM Gateway 官方文档支持通过 ANTHROPIC_BASE_URL 指向自定义网关。

FlexAPI 支持直接通过环境变量配置：

macOS / Linux

export ANTHROPIC_BASE_URL="https://flexapi.me"
export ANTHROPIC_AUTH_TOKEN="your-flexapi-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://flexapi.me"
$env:ANTHROPIC_AUTH_TOKEN = "your-flexapi-api-key"
$env:ANTHROPIC_MODEL = "claude-sonnet-4-6"
claude

选择通过持久化文件配置

Claude Code 官方设置文件位置：

• 用户级：~/.claude/settings.json
• 项目级：.claude/settings.json
• 本地项目级：.claude/settings.local.json

编辑settings.json文件，添加以下内容:

下面这段只是配置的核心片段（最小示例），用于说明关键字段；并不是完整配置，单独使用可能无法直接运行

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://flexapi.me",
    "ANTHROPIC_AUTH_TOKEN": "your-flexapi-api-key"
  },
  "model": "claude-sonnet-4-6"
}

提示

将 your-flexapi-api-key 替换为 FlexAPI 的密钥

其他注意事项

推荐模型写法

Claude Code 官方支持两种思路：

• 直接填完整模型名，例如 claude-sonnet-4-6
• 使用模型别名，例如 sonnet、opus

在使用Claude Code官方工具时

可以通过 /model 显示设置模型和推理强度，不必过于纠结文件中配置的模型型号。

Windows 补充说明

Anthropic 官方说明里，Windows 原生安装依赖 Git for Windows。Claude Code 会内部使用 Git Bash 跑命令。

如果 Claude Code 找不到 Git Bash，可以在 settings.json 里显式指定：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

从旧版 npm 安装迁移

如果你以前是用 npm 装的，官方建议迁到原生安装：

1. 先执行原生安装脚本。
2. 再卸载旧的 npm 全局包。

curl -fsSL https://claude.ai/install.sh | bash
npm uninstall -g @anthropic-ai/claude-code

常见问题

Q: 为什么 claude 还是连到默认 Anthropic 地址

先检查 ANTHROPIC_BASE_URL 是否在当前终端或 settings.json 中真正生效。官方建议也可以用 claude /status 查看当前 URL、认证和代理状态。

Q: 提示 401 或权限错误

优先检查 ANTHROPIC_AUTH_TOKEN 是否正确，再确认你的 FlexAPI Key 是否已经开通 Claude 系列模型。

Q: 提示 model not found

如果你的 Claude Code 客户端并没有接入 Anthropic 相关分组，而是使用其他模型 如 gpt-5.4 ，请确保您所在的分组启用了 /v1/messages 接口。

Q: 需要写 settings.json 吗

不是必须。只要环境变量已经生效，就可以直接运行；settings.json 主要用于长期固定默认配置。

相关页面

• OpenAI / Claude 模型价格表
• Codex 使用指南