1. 工具配置教程
谐波AI Hub接口文档
模型接口
  • 模型接口
  • 平台介绍
  • 快速接入指南
  • 各模型接口列表
    • 获取模型（Models）
      • 获取可用模型接口
    • Anthropic（claude code）
      • 官方接口
        • 文本对话（优先）
      • OpenAI格式接口
        • 文本对话
    • OpenAI（codex，gpt-image-2）
      • 官方接口
        • 文本对话（官方推荐/新一代）
        • 文本对话（兼容接口）
        • 生成图像（gpt-image-2）
        • 编辑图像（gpt-image-2）
        • 创建视频
        • 获取视频任务状态
        • 获取视频内容
    • Google（gemini，Nano Banana）
      • 官方接口
        • 文本对话（优先）
        • 生成图像（Nano Banana）
      • OpenAI格式接口
        • 文本对话
        • 生成图像（Nano Banana）
    • xAI（grok）
      • OpenAI格式接口
        • 文本对话（兼容接口）
        • 生成图像（grok）
        • 创建视频（video）
        • 获取视频任务状态
        • 获取视频内容
    • 图像（Images）
      • OpenAI格式接口（doubao）
        • 生成图像
      • 通义千问格式
        • 生成图像
        • 编辑图像
    • 视频（Videos）
      • 通义千问格式（happyhorse-快乐马）
        • 创建视频（文生视频）
        • 创建视频（首帧图-图生视频）
        • 创建视频（参考图-图生视频）
        • 创建视频（编辑视频）
        • 获取视频生成任务状态
      • 火山豆包格式（seed-2.0）
        • 创建视频（文生视频）
        • 创建视频（首帧-图生视频）
        • 创建视频（首尾帧-图生视频）
        • 创建视频（参考图-图生视频）
        • 创建视频（多模态-参考生视频）
        • 获取视频生成任务状态
      • 火山豆包官方格式（doubao-seedance-2-0-260128）
        • 创建视频（文生视频）
        • 创建视频（首帧-图生视频）
        • 创建视频（首尾帧-图生视频）
        • 创建视频（参考图-图生视频）
        • 创建视频（多模态-参考生视频）
        • 获取视频生成任务状态
      • Openai格式（grok，Veo 3.1，seed-2.0）
        • 谷歌Veo 3.1
          • 创建视频（文生视频）
          • 创建视频（参考图-图生视频）
          • 获取视频生成任务状态
        • Openai Sora格式（seed-2.0特价）
          • 创建视频（文生视频）
          • 创建视频（多模态-参考生视频）
          • 获取视频生成任务状态
          • 获取视频内容
        • Openai Sora格式（grok video 1.5）
          • 创建视频（文生视频）
          • 创建视频（首帧图-图生视频）
          • 创建视频（参考图-图生视频）
          • 获取视频生成任务状态
          • 获取视频内容
  • 视频素材相关接口
    • 资源库 API 接入文档（火山官方格式）
    • 资源库 API 接入文档
    • 上传素材
      POST
    • 查询素材列表
      GET
    • 查询单个素材
      GET
    • 修改素材描述
      PUT
    • 删除素材
      DELETE
  • 工具配置教程
    • CC Switch 配置
    • Claude Code配置
    • Codex配置
    • Gemini CLI配置
    • OpenCode 配置
    • Cursor 配置
    • node 安装教程
  • 法律与政策
    • 服务协议
    • 隐私政策
  1. 工具配置教程

Claude Code配置

Claude Code 配置教程#

获取 API Key 后，按照你的操作系统选择对应步骤完成配置。

步骤 1：验证是否安装 Node.js#

Claude Code 基于 Node.js 运行，请先确认已安装 Node.js（建议 LTS 版本）。
打开终端
windows用户（win+R）输入 cmd 回车
分别执行
node -v
npm -v
查看是否有版本号，如果没有显示版本号的可以参考 node 安装教程 进行安装
image.png
如果你是Windows用户，还需要额外安装Git for Windows
验证git是否安装
image.png
如果没有正常显示版本号，你可以访问 https://git-scm.com/install/windows 下载安装程序，按默认选项安装即可。安装完后重启电脑，然后再安装Claude Code。
image.png
Git for Windows提供的Git Bash是Claude Code在Windows原生环境下运行命令的基础工具。macOS和Linux已经有原生的Bash，所以不需要。

步骤 2：安装 Claude Code#

Windows（PowerShell，无需 sudo）#

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

macOS / Linux / WSL2#

如果使用 nvm 管理 Node.js，可以不加 sudo。
验证安装：

步骤 3：配置环境变量#

如果使用CC Switch的可以跳转 CC Switch 配置
将下方变量中的占位符替换为你的实际信息：
YOUR_API_KEY → 你的 API Key

Windows（PowerShell）#

临时生效（仅当前终端会话有效）：
$env:ANTHROPIC_BASE_URL = "https://ai-api.kkidc.com"
$env:ANTHROPIC_AUTH_TOKEN  = "YOUR_API_KEY"
永久生效（推荐，写入系统环境变量）：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai-api.kkidc.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN",  "YOUR_API_KEY",      "User")
设置后需重新打开终端窗口。

macOS / Linux / WSL2#

将以下内容追加到 ~/.bashrc 或 ~/.zshrc（zsh 用户）：
然后使配置立即生效：

步骤 4：验证环境变量#

Windows#

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

macOS / Linux / WSL2#

步骤 5：开始使用#

在任意项目目录下运行：

步骤 6：确认配置已生效#

进入 Claude Code 交互界面后，输入以下命令查看当前配置状态：
/status
执行后会显示如下信息，逐项确认是否正确：
字段说明期望值
Anthropic base URL当前使用的接入地址应显示 https://ai-api.kkidc.com
Model当前模型显示正在使用的模型名称
示例输出（正常）：
╭─────────────────────────────────────────────────╮
│  Status                                         │
│                                                 │
│  Anthropic base URL:  https://ai-api.kkidc.com  │
│  Model:         claude-sonnet-4-5               │
│                                                 │
╰─────────────────────────────────────────────────╯
如果 API endpoint 显示的是 Anthropic 官方地址（https://api.anthropic.com），说明 ANTHROPIC_BASE_URL 环境变量未生效，请退出后重新检查步骤 3。

可选：全局配置文件#

Claude Code 的全局设置文件路径如下，可用于配置主题、快捷键等选项：
系统路径
WindowsC:\Users\你的用户名\.claude\settings.json
macOS / Linux~/.claude/settings.json

常见问题#

Q：环境变量设置后不生效？
重新打开一个终端窗口，或执行 source ~/.bashrc。
Q：Windows 安装时提示权限错误？
以管理员身份运行 PowerShell 后重试。
Q：macOS / Linux 安装时提示权限错误？
命令前加 sudo，或使用 nvm 安装 Node.js（nvm 安装的 npm 无需 sudo）。
修改于 2026-04-16 09:49:57
上一页
CC Switch 配置
下一页
Codex配置
Built with