Claude Code 是 Anthropic 推出的一款专注于 AI Coding 的 Agent 工具，默认由 Claude 系列大模型驱动。它能够为开发者提供以下核心功能：

• 实时代码建议：智能代码补全和优化建议
• 代码解释与优化：深度分析代码逻辑，提供性能改进方案
• 多语言支持：支持主流编程语言如 Python、JavaScript、Java、Go 等
• IDE 集成：无缝集成 VS Code、IntelliJ IDEA 等主流开发环境
• 自然语言交互：通过对话方式进行代码开发和问题解决

🪜七牛云 AI 大模型推理服务API https://api.qnaigc.com 也兼容了 Anthropic API协议，使用户可以为 Claude Code 配置更便宜、更具性价比的其他大模型，享受Code带来的强大 AI Coding功能。

前置要求

• 七牛云账号
• Node.js 环境（版本 >= 18.0）

接入教程

第一步：获取 API 配置信息

1. BaseURL（服务端点）

   https://api.qnaigc.com
   

2. 获取 API Key

   • 访问：https://portal.qiniu.com/ai-inference/api-key
   • 登录您的七牛云账号
   • 创建或复制现有的 API Key

第二步：安装 Claude Code

# 通过 npm 全局安装（官方推荐）
npm install -g @anthropic-ai/claude-code

第三步：配置 Claude Code（推荐方式）

方式一：使用 settings.json 配置（推荐）⭐

使用 settings.json 配置文件是 Claude Code 官方推荐的配置方式，相比环境变量更加灵活和易于管理。

1. 创建用户级配置文件

创建全局配置文件 ~/.claude/settings.json，适用于所有项目：

mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-api-key-here",
    "ANTHROPIC_BASE_URL": "https://api.qnaigc.com",
    "ANTHROPIC_MODEL": "moonshotai/kimi-k2-thinking",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "moonshotai/kimi-k2-thinking",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "moonshotai/kimi-k2-thinking",
    "ANTHROPIC_SMALL_FAST_MODEL": "moonshotai/kimi-k2-thinking"
  },
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "companyAnnouncements": [
    "您正在使用七牛云 AI 大模型推理服务 🚀"
  ]
}
EOF

2. settings.json 配置说明

方式二：使用环境变量配置

如果您更习惯使用环境变量，可以在 shell 配置文件中添加：

# Claude Code 环境变量配置

# 配置鉴权密钥，ANTHROPIC_API_KEY （或 ANTHROPIC_AUTH_TOKEN，二者只能任选一个配置，不可同时配）
export ANTHROPIC_API_KEY="sk-your-api-key-here"
# export ANTHROPIC_AUTH_TOKEN ="sk-your-api-key-here"

# 配置接口地址🪜
export ANTHROPIC_BASE_URL="https://api.qnaigc.com"

# 配置默认主要的模型
export ANTHROPIC_MODEL="moonshotai/kimi-k2-thinking"

# 配置默认的 SONNET 模型
export ANTHROPIC_DEFAULT_SONNET_MODEL="moonshotai/kimi-k2-thinking"

# 新版本针对简单问题的处理模型配置
export ANTHROPIC_DEFAULT_HAIKU_MODEL="moonshotai/kimi-k2-thinking"

# 老版本针对简单问题的处理模型配置，根据测试，建议新版本也配上，减少报错情况
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-thinking"

配置完成之后需要确保加载变量：

source ~/.zshrc  # 或 source ~/.bashrc

注意：请将 sk-your-api-key-here 替换为您从七牛云获取的真实 API Key。

第三步：验证配置

使用 /status 命令在 Claude Code 中验证配置：

claude
# 在 Claude Code 中输入
/status

检查以下配置项：

• 验证 Base URL 是否正确设置为 https://api.qnaigc.com
• 确认模型配置正确

第四步：启动和使用

启动 Claude Code

claude "使用 HTML 实现一个数独游戏"

授权访问

首次进入可能需要为 claude code 授予当前目录访问权限

高级配置

settings.json 高级特性

1. 权限控制

通过 permissions 配置精细化控制 Claude Code 的访问权限：

{
  "permissions": {
    "allow": [
      "Bash(git diff:*)",
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Bash(rm:*)",
      "WebFetch",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)"
    ],
    "additionalDirectories": [
      "../docs/"
    ],
    "defaultMode": "acceptEdits"
  }
}

权限规则说明：

• allow：明确允许的操作，支持通配符
• deny：拒绝的操作，用于保护敏感文件和危险命令
• additionalDirectories：额外允许访问的目录
• defaultMode：默认权限模式（acceptEdits、ask、deny 等）

2. 自定义 API Key 生成

使用 apiKeyHelper 配置动态生成 API Key：

{
  "apiKeyHelper": "/bin/generate_temp_api_key.sh",
  "env": {
    "CLAUDE_CODE_API_KEY_HELPER_TTL_MS": "3600000"
  }
}

这对于需要定期轮换 API Key 的企业场景特别有用。

3. 查看Claude Code日志

在运行Claude Code时，它会分项目产生*.jsonl日志到~/.claude/projects目录下，
使用claude-code-log可以将日志转化为更可读的html文件格式。

# 安装
pip install claude-code-log

# 运行
claude-code-log

支持的模型

如何查看最新支持的模型

访问 七牛云 AI 推理模型广场 可以查看：

• 最新上线的模型
• 各模型的定价信息
• 模型的具体能力特点

最佳实践

1. 优先使用 settings.json 配置 ⭐

推荐原因：

• 版本控制友好：项目配置可以提交到 Git，团队共享
• 灵活性高：支持用户级、项目级、企业级多层配置
• 功能完整：支持权限控制、沙箱、钩子等高级特性
• 易于管理：通过 /config 命令可视化管理

2. 合理设置权限

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(**/*.key)",
      "Read(**/*.pem)",
      "Bash(rm:*)",
      "Bash(curl:*)"
    ]
  }
}

建议：

• 始终拒绝访问敏感文件（.env、密钥文件等）
• 限制危险的 Bash 命令（rm、curl 等）
• 使用白名单方式明确允许的操作

3. 保护 API Key

不要在代码中硬编码：

# ❌ 错误做法
export ANTHROPIC_API_KEY="sk-xxxxx"  # 不要提交到 Git

# ✅ 正确做法
# 使用 settings.local.json（不提交到 Git）
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-xxxxx"
  }
}

4. 定期更新

保持 Claude Code 为最新版本：

# 更新 Claude Code
npm update -g @anthropic-ai/claude-code

# 查看当前版本
claude --version

5. 监控使用情况

定期检查 API 使用情况和成本：

• 访问 七牛云控制台 查看用量统计
• 使用 cleanupPeriodDays 控制本地聊天记录保留时间
• 根据使用情况调整模型选择以优化成本

结语

通过以上步骤，您应该已经成功接入了 Claude Code。如果在使用过程中遇到问题，可以参考故障排除部分，或联系七牛云技术支持获得帮助。