Claude Code 接入

Claude Code 可以通过 Anthropic 兼容接口连接 FlashCoding.AI。配置只对启动 Claude Code 的终端生效，适合先做独立验证，再决定是否写入本机的终端启动配置。

适用场景

• 已安装 Claude Code，希望在终端中使用 FlashCoding.AI 的模型。
• Claude Code 能启动，但仍在使用其他服务地址或登录方式。
• 需要用临时环境变量测试一把新 API Key，不修改项目文件。

前置条件

开始前准备好：

1. 已安装可正常启动的 Claude Code；可先执行 claude --version 检查。
2. 从 FlashCoding.AI 控制台创建的 API Key。下文用 sk-your-key 作为占位符。
3. 从控制台复制的完整模型 ID。下文用 your-model-id 作为占位符。
4. 当前密钥与模型支持 Anthropic Messages 协议。

不要提交密钥

环境变量中的真实 API Key 不应写进项目的 .env、Shell 脚本或版本库。共享终端输出和截图前，也要检查其中是否包含密钥。

操作步骤

1. 在当前终端设置环境变量

macOS / Linux：

export ANTHROPIC_BASE_URL="https://flashcoding.ai"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
export ANTHROPIC_MODEL="your-model-id"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://flashcoding.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
$env:ANTHROPIC_MODEL = "your-model-id"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

ANTHROPIC_BASE_URL 填服务根地址，不要追加 /v1 或 /v1/messages。Claude Code 会自行拼接 Messages 接口路径。

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 用于关闭与模型调用无关的流量，避免这些请求仍访问默认服务。它不会代替 API Key 或模型配置。

2. 核对占位符

把 sk-your-key 替换为真实 API Key，把 your-model-id 替换为控制台显示的完整模型 ID。不要根据旧教程猜测模型名称。

若希望每次手动选模型，可以暂不设置 ANTHROPIC_MODEL，启动后按 Claude Code 当前版本提供的模型选择方式，从控制台复制模型 ID。排障阶段建议先固定模型，减少变量。

3. 从同一个终端启动

claude

环境变量通常只在当前终端及其子进程中有效，因此不要设置完后换到另一个终端窗口启动。

进入 Claude Code 后，在一个不含敏感文件的测试目录中发送：

请只回复：Claude Code 连接成功

首次测试只做普通文本对话。确认连接正常后，再授权读取或修改项目文件。

4. 按需保存配置

临时测试成功后，可以把非敏感变量放入自己的 Shell 启动配置。API Key 更适合交给操作系统凭据管理、受保护的环境注入工具或每次会话临时设置。

若修改了启动配置，需要新开终端，或重新加载对应的 Shell 配置，才能让 Claude Code 读取新值。

成功验证

接入成功时应同时满足：

• Claude Code 可以正常返回测试文本，没有跳转到其他服务的登录流程。
• 请求使用的模型与控制台中复制的模型 ID 一致。
• FlashCoding.AI 控制台的使用记录中出现本次请求。
• 记录的请求时间、模型和状态与终端中的测试相符。

还可以退出 Claude Code，修改 ANTHROPIC_MODEL 后重新启动，确认新进程确实读取了当前终端的配置。

常见错误

启动后仍要求登录

确认 ANTHROPIC_AUTH_TOKEN 已在启动 Claude Code 的同一个终端中设置，变量名没有拼错。若机器上已有其他 Claude Code 配置，也要检查是否存在冲突的认证变量或启动脚本。

401 或鉴权失败

重新从控制台复制 API Key，检查前后是否多了空格、引号或换行，并确认密钥未被停用。不要把 sk-your-key 原样使用。

404 或请求路径错误

ANTHROPIC_BASE_URL 应为 https://flashcoding.ai。若填写成 https://flashcoding.ai/v1 或完整 Messages 路径，Claude Code 再次拼接路径后可能产生错误地址。

模型不存在或不可用

回到控制台复制当前密钥可用的完整模型 ID，并确认它支持 Anthropic Messages 协议。模型名正确但协议不匹配时，同样可能无法调用。

修改变量后没有生效

完全退出正在运行的 Claude Code，再从已设置变量的终端重新启动。已启动的进程不会自动读取后续修改的环境变量。

响应卡住或出现额外网络错误

确认 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 的值为字符串 1，并先关闭代理或插件带来的额外变量。若基础请求仍失败，记录时间、状态码和错误正文后继续排查。

下一步

• 了解 Claude Code 使用的接口格式：阅读 Anthropic Messages。
• 不确定为什么 Base URL 不带 /v1：查看 Base URL 与协议。
• 遇到持续的鉴权、模型或网络错误：按故障排查收集信息。