跳转到主要内容

​
概述

Claude Code 是 Anthropic 官方推出的命令行工具，可将 Claude 的智能直接带入你的终端。它能够理解你的代码库、编辑文件、运行命令，并帮助你更快地构建软件。 通过将 Claude Code CLI 连接到 FoxAPI，你可以借助 FoxAPI 稳定可靠的 API 基础设施来使用 Claude 的全部能力。
FoxAPI 提供了专为 Claude Code CLI 优化的端点。请使用 https://aicode.cookai.cc 作为 Base URL 以获得最佳体验。

​
前置条件

FoxAPI API Key

你需要一个有效的 FoxAPI API Key，并确保其有权限访问 Claude 模型。

Node.js 18+

通过 npm 安装 Claude Code CLI 时需要 Node.js 18 或更高版本。你也可以使用 curl 安装脚本。

​
安装与配置

1

第一步：安装 Claude Code CLI

根据你的操作系统选择安装方式：
npm install -g @anthropic-ai/claude-code
安装完成后，验证安装是否成功：
claude --version
2

第二步：配置 FoxAPI API

你需要让 Claude Code 通过 FoxAPI 发送请求。创建或编辑 Claude Code 的配置文件：
编辑 ~/.claude/settings.json：
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-foxapi-api-key",
    "ANTHROPIC_BASE_URL": "https://aicode.cookai.cc",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 设置是必须的。它会阻止 Claude Code 向 Anthropic 官方服务器发送遥测和其他非必要请求。如果不设置此项，这些请求会因缺少官方 API Key 而失败，可能导致异常。
3

第三步：开始使用

在你的项目目录中启动 Claude Code：
cd /path/to/your/project
claude
这将打开一个交互式会话，你可以在其中与 Claude 讨论你的代码库。你也可以直接运行单次命令：
claude "解释一下这个项目的架构"

​
验证连接

运行以下命令确认 Claude Code 已正确通过 FoxAPI 路由： 
claude "你好，请确认你正在正常工作。"
如果配置正确，Claude 会正常回复。如果看到错误信息，请查看下方的常见问题部分。

​
使用示例

claude "给我一个这个项目架构的概览"

claude "登录流程中有一个 Bug，用户认证后被重定向到 404 页面，请找到并修复它。"

claude "为 UserService 类编写单元测试"

claude "将 src/repositories 中的数据库查询重构为参数化查询"

​
常见问题

  • 仔细检查 ANTHROPIC_AUTH_TOKEN 的值，它应该是你的 FoxAPI API Key（以 sk- 开头）。
  • 确认 API Key 未过期且账户余额充足。
  • 确认该 Key 在你的 FoxAPI 账户中有权限访问 Claude 模型。
  • 确认 ANTHROPIC_BASE_URL 设置为 https://aicode.cookai.cc（末尾不要加斜杠）。
  • 检查你的网络连接，确保能够访问 aicode.cookai.cc。
  • 如果你在公司代理后面，请确保代理允许 HTTPS 流量访问 aicode.cookai.cc。
  • 确保 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 已设置为 1。
  • 如果使用 settings.json，确保 JSON 格式正确（没有多余的逗号、引号正确配对）。
  • 修改环境变量或配置文件后，重新启动终端。
  • 确认文件位于 ~/.claude/settings.json（不是项目目录内部）。
  • 使用 jq 等工具验证 JSON 格式： 
    cat ~/.claude/settings.json | jq .
  • 确保 Shell 配置文件中没有设置冲突的环境变量覆盖了配置文件的设置。

​
注意事项

  • 不要将 API Key 提交到版本控制系统。如果使用环境变量，请将其添加到 Shell 配置文件而非项目文件中。
  • 尽量使用专用 Key。FoxAPI 允许你创建多个 API Key，建议为 Claude Code 创建专用 Key，以便在需要时可以单独撤销。
  • 在 FoxAPI 控制台监控用量，以便及时发现异常消耗。