放心API接口
控制台模型广场
控制台模型广场
  1. Claude Code
  • 放心API 新手入门指南（以 LobeHub 为例）
  • Agent配置教程
    • Claude Code
      • MacOS/Linux 安装指南
      • Windows 安装指南
      • Obsidian × Claudian × Skills：构建你的AI第二大脑
    • Codex
      • macOS / Linux 安装指南
      • Windows 安装指南
    • OpenClaw
      • OpenClaw 配置API
  • 列出模型
    • Models（列出模型）
      GET
  • OpenAI 格式(支持各大原厂模型)
    • 聊天(Responses)
      • 创建网络搜索
      • 创建模型响应 gpt-5启用思考
      • 创建函数调用
      • 创建模型响应
      • 创建函数调用
      • 创建模型响应(流式返回)
      • 创建模型响应 (控制思考长度)
    • ChatGpt 接口
      • ChatGPT音频（Audio）
        • 音频转文字 gpt-4o-transcribe
        • 创建翻译 (不支持)
        • GPT-4o-audio
        • 音频转文字 whisper-1
        • 音频转文字 gpt-4o-transcribe
        • 创建语音 gpt-4o-mini-tts
        • 创建翻译 (不支持)
      • ChatGPT聊天（Chat）
        • 列出模型
        • 创建聊天识图 （非流）
        • 创建聊天识图 （流式）
        • 创建聊天识图 （流式） best64
        • 官方N测试
        • 创建结构化输出
        • 控制推理模型努力程度
        • 创建聊天函数调用
        • deepseek-ocr 识别
        • 创建聊天补全 （非流）
      • ChatGPT自动补全（Completions）
        • 创建完成
    • 图像
      • gpt-image2图片生成(images)
      • 修改图片(images)
      • 创建聊天补全 （流式）
      • 创建聊天补全 qwen-mt-turbo
      • 创建聊天补全 deepseek v3.1思考程度 (流式）
    • 语音
      • 语音识别(audio)
      • 语音合成(audio)
      • 官方Function calling调用
      • 创建聊天创作图 （非流）
    • 向量化
      • 文本向量化
    • Grok
      • Grok 视频生成
    • 图生图URL 请求方式
      • gpt-image-2-all 生图
  • Anthropic 格式
    • 聊天
      POST
    • 聊天(prompt cache)
      POST
    • 流式返回
      POST
    • 聊天(深度思考)
      POST
    • 工具调用(function call)
      POST
    • 工具调用(MCP)-待支持
      POST
    • 分析图片
      POST
  • 谷歌Gemini 接口
    • 原生格式
      • 文生图片 控制宽高比 +清晰度
      • 生成图片
      • 文本生成
      • 文本生成-流
      • 文本生成+思考-流
      • 图片生成
      • 格式化输出
      • 函数调用
      • URL context [原生格式]
      • 代码执行
      • google search
      • 图像理解
      • 文档理解
      • 视频理解
      • 视频理解-url [原生格式]
      • URL context
      • Imagen 4 开发中
      • 音频理解
      • Embeddings
      • 聊天
      • 编辑图片
    • 图生图Base64请求方式(官方推荐)
      • 多图融合片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
      • 图片编辑
      • 单图片 gemini-3-pro-image-preview 控制宽高比 +清晰度
      • 图片生成 gemini-2.5-flash-image
      • 图片生成 gemini-2.5-flash-image 控制宽高比
      • 图片理解
    • 图生图URL请求方式Gemini 格式
      • 多图融合片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
      • 图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
    • 图生图URL请求返回 URL请求格式OpenAI
      • 单图生图 gemini-3-pro-image-preview 控制宽高比 +清晰度
      • 多图融合片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
      • 图片编辑
      • 图片理解
    • 图生图 URL请求方式(暂不支持)
      • 多图融合 gemini-3-pro-image-preview 控制宽高比 +清晰度
      • 图片编辑
      • 图片理解
  • NanoBanana
    • 图生图Base64请求方式(官方推荐)
      • 多图融合片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
      • 图片编辑
      • 单图片 gemini-3-pro-image-preview 控制宽高比 +清晰度
      • 图片生成 gemini-2.5-flash-image
      • 图片生成 gemini-2.5-flash-image 控制宽高比
      • 图片理解
    • gemini 请求方式
      • 生成图片
      • 编辑图片
    • OpenAI 请求方式
      • 编辑图像
      • OpenAI 图像格式
  • Midjourney 格式
    • 任务查询接口
    • 上传图片
    • 获取种子(Seed)
    • 提交Imagine任务
    • 根据ID列表查询任务
    • 换脸(FaceSwap)
    • 执行Action动作
    • 提交Blend任务
    • 提交Describe任务
    • 提交Modal
    • 刷新链接(Refresh)
    • 编辑图片(Edit)
    • 根据任务ID 查询任务状态
    • 获取任务图片的seed
  • 豆包系列-视频生成
    • 文生视频示例
    • 图生视频-首帧
    • seedance-lite-首尾帧
    • 图生视频-base64编码
    • seedance-lite-参考图
    • 查询单个任务
    • 查询视频生成任务列表-默认
    • 查询视频生成任务列表-搜索多个任务 ID
  • 豆包系列-绘画
    • doubao-seededit-3-0-i2i-250628
    • doubao-seedream-4-0-250828-文生图
    • doubao-seedream-4-0-250828-图生图
    • doubao-seedream-4-0-250828-多图生图
  • flux-kontext-max系列
    • flux-kontext-max
  • 即梦 AI
    • 即梦 AI-绘画
      • seedream-4.5
      • seedream-4.5-文生图
      • seedream-4.5-图生图
      • seedream-4.5-多图生图
    • 即梦 AI-视频
      • 统一任务提交接口
      • 统一查询接口
  • Rerank 重排序模型
    • 重排序
  • 文生音乐 Suno
    • 任务提交
      • 生成歌曲(灵感模式)
      • 生成歌曲(自定义模式)
      • 生成歌曲(续写模式)
      • 生成歌曲(歌手风格)
      • 生成歌曲(上传歌曲二次创作)
      • 生成歌曲(拼接歌曲)
      • 生成歌词
      • 歌曲拼接
    • 查询接口
      • 批量获取任务
      • 查询单个任务
  1. Claude Code

MacOS/Linux 安装指南

本指南面向 macOS 和 Linux 用户，使用 放心API 作为 API 服务商，完成 Claude Code 的完整安装与配置。

系统要求#

macOS
Linux
macOS 10.15 (Catalina) 及以上
网络可正常访问（无需科学上网，放心API已做国内加速）
磁盘空间：至少 500MB 可用空间

安装步骤#

步骤 1：打开终端#

macOS
Linux
按 Cmd + Space 搜索「Terminal」，回车打开
或在「访达 → 应用程序 → 实用工具 → 终端」中找到

步骤 2：安装 Node.js#

Claude Code 是一个 npm 包，需要 Node.js 运行环境。
macOS
Linux
方法一：使用 Homebrew（推荐）
如果还没有安装 Homebrew，先执行：
然后安装 Node.js：
方法二：官网下载
访问 https://nodejs.org/zh-cn/download 下载 macOS 安装包（.pkg 文件），双击安装，一路默认即可。
验证安装：
两条命令都应输出版本号，例如 v22.x.x 和 10.x.x。

步骤 3：卸载旧版 Claude Code（未安装请跳过）#

步骤 4：安装 Claude Code#

安装过程需要 1-3 分钟。完成后验证：
输出版本号说明安装成功。
遇到权限问题（EACCES: permission denied）
说明 npm 全局目录权限不足，执行以下命令修复：
然后根据你的 Shell 写入 PATH：
完成后重新执行安装命令。

步骤 5：注册放心API并获取 API Key#

1.
打开浏览器，访问 https://fangxinapi.com
2.
注册账号并登录
3.
进入「API 密钥」或「令牌管理」页面，点击「新建密钥」
4.
复制生成的 API Key（格式通常为 sk- 开头的字符串），妥善保存，页面关闭后无法再次查看
5.
同时记录放心API提供的 Base URL： https://fangxinapi.com

步骤 6：配置环境变量#

需要设置以下两个环境变量，将 你的API_KEY 替换为步骤 5 中复制的实际密钥：
变量名变量值
ANTHROPIC_BASE_URLhttps://fangxinapi.com
ANTHROPIC_AUTH_TOKEN你的API_KEY
如何确认 Base URL
登录放心API控制台，在「接入文档」或「快速开始」页面可以找到正确的 Base URL。

方法一：临时设置（仅当前终端会话有效）#

适合快速测试，关闭终端后失效，下次需重新设置。

方法二：永久设置（推荐）#

写入 Shell 配置文件，重启终端后依然有效。
第一步：确认你使用的 Shell
输出包含 zsh → macOS Catalina 及以上默认
输出包含 bash → Linux 默认或旧版 macOS
第二步：写入配置文件
macOS（zsh）
Linux（bash）
在文件末尾添加以下内容：
保存退出（Ctrl + X → Y → 回车），然后重新加载配置：

验证环境变量已生效#

预期输出：
https://fangxinapi.com
你的API_KEY
输出为空怎么办
1.
重新打开文件确认内容是否保存成功
2.
确认已执行 source 命令重新加载
3.
关闭终端，重新打开后再次验证

步骤 7：验证完整配置#

重新打开终端，启动 Claude Code：
首次启动会出现交互引导页面，在「yes/no(recommended)」选项中选择 yes，完成初始化。

开始使用#

安装完成后，在任何项目目录中启动 Claude Code：
常用命令：

常见问题#

❌ Unable to connect to Anthropic services#

原因：ANTHROPIC_BASE_URL 未生效或地址填写有误。
排查步骤：
1.
运行 echo $ANTHROPIC_BASE_URL，确认输出了正确的地址
2.
若输出为空，说明环境变量未写入配置文件，或当前终端未重新加载配置
3.
手动执行 source ~/.zshrc（或 source ~/.bash_profile）后再试
4.
确认 Base URL 末尾没有多余的斜杠（/）

❌ command not found: claude#

原因：npm 全局安装路径不在 $PATH 中。
macOS
Linux

❌ macOS 提示「无法验证开发者」#

原因：macOS Gatekeeper 安全限制。
解决方法：

❌ Linux 提示 node: command not found#

原因：Node.js 未正确安装或路径未加入 $PATH。
解决方法：重新按步骤 2 安装，安装完成后执行 source ~/.bashrc 刷新环境变量。
修改于 2026-04-21 09:01:08
上一页
放心API 新手入门指南（以 LobeHub 为例）
下一页
Windows 安装指南
Built with