1. API快速配置
魔芋AI开发文档
  • API快速配置
    • CC-Switch快速配置（推荐）
    • Claude Code 与 Codex 安装配置
    • 智能体集成魔芋Skills
  • 魔芋SDK
    • SDK接口规范文档
    • SDK 完整示例
  • 模型
    • 获取可用模型列表
      GET
  • 文本对话
    • OpenAI 对话补全
      POST
    • OpenAI Responses
      POST
    • Anthropic 消息接口
      POST
    • Gemini 内容生成
      POST
  • 图片生成
    • 图片生成
      POST
  • 视频生成
    • 提交视频生成任务
      POST
    • 查询视频生成任务
      GET
    • 查询豆包视频任务状态
      GET
    • 按令牌获取视频任务列表
      GET
  • 素材库
    • 创建素材 / 批量上传
      POST
    • 查询素材列表
      POST
    • 查询单个素材
      POST
    • 按批次查询素材
      POST
    • 更新素材名称
      POST
    • 删除素材
      POST
    • 获取素材库列表
      GET
    • 创建素材库
      POST
    • 删除素材库
      POST
    • 转移素材库
      POST
  • 数据模型
    • ChatMessage
    • ChatCompletionRequest
    • ChatCompletionResponse
    • OpenAIUsage
    • ResponsesRequest
    • ResponsesResponse
    • AnthropicMessageRequest
    • AnthropicMessageResponse
    • GeminiPart
    • GeminiContent
    • GeminiGenerateContentRequest
    • GeminiGenerateContentResponse
    • ModelListResponse
    • ImageGenerationRequest
    • ImageGenerationResponse
    • SeedanceContentItem
    • SeedanceMetadata
    • VideoGenerationRequest
    • VideoTaskSubmitResponse
    • VideoTaskQueryResponse
    • VideoTaskListResponse
    • VideoTaskListItem
    • VideoAutoUploadRequest
    • VideoAutoUploadSubmitResponse
    • VideoFlatQueryResponse
    • AssetItem
    • CreateAssetRequest
    • CreateAssetResponse
    • ListAssetsRequest
    • ListAssetsResponse
    • GetAssetResponse
    • BatchGetAssetsResponse
    • AssetIdResponse
    • AssetGroupListResponse
    • ErrorResponse
  1. API快速配置

Claude Code 与 Codex 安装配置

本教程从零开始，带你完成 Node.js 环境安装 → Claude Code 安装配置 → Codex 安装配置，适用于 Windows / macOS / Linux。

第一部分：环境安装（通用）#

Claude Code 和 Codex 都依赖 Node.js（建议 Node.js 22+ / npm 10+）。

1.1 安装 Node.js#

1.
打开浏览器访问 https://nodejs.org/
2.
点击 "LTS" 版本进行下载（推荐长期支持版本）
3.
下载完成后：
Windows：双击 .msi 文件，按向导一直 Next 保持默认设置完成安装
macOS：双击 .pkg 文件按向导安装，或用 Homebrew：brew install node
Linux：用发行版包管理器安装，或参考官网的 NodeSource 安装方式
安装完成后，打开终端验证：
Windows 打开终端：按 Win + X，选择 "终端管理员" 或 "Windows PowerShell (管理员)"。
显示版本号即安装成功。

1.2 安装 Git Bash（Windows 推荐）#

Windows 上建议安装 Git for Windows，它自带的 Git Bash 是运行 Claude Code / Codex 更稳定的终端环境。
1.
访问 https://git-scm.com/downloads/win
2.
点击 "Download for Windows" 下载安装包
3.
运行 .exe 安装文件，全程保持默认设置，点击 "Next" 完成安装
验证（打开 Git Bash 输入）：
macOS / Linux 通常已自带 Git，无需单独安装。

第二部分：Claude Code 安装与配置#

2.1 安装 Claude Code#

打开终端（Windows 用 PowerShell），运行：
如果安装完成后出现 Setup notes 提示（Windows），运行以下命令补全 PATH：
[Environment]::SetEnvironmentVariable('Path', ([Environment]::GetEnvironmentVariable('Path','User') + ";$HOME\.local\bin"), 'User')
验证安装：

2.2 配置 API（Windows）#

安装完成后，推荐使用CC Switch配置Claude Code，可参考CC-Switch配置文档，使用CC Switch无需如下操作。
Claude Code 通过三个环境变量连接中转平台。在 PowerShell 中执行：
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://www.moyu.info", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5-20250929", "User")
变量说明
ANTHROPIC_AUTH_TOKEN你的 API 密钥
ANTHROPIC_BASE_URL平台地址，不带 /v1（Claude Code 会自动拼接 /v1/messages）
ANTHROPIC_MODEL默认使用的 Claude 模型
关闭当前 PowerShell，重新打开一个新窗口，验证是否生效：
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

2.3 配置 API（macOS / Linux）#

编辑 shell 配置文件（zsh 用 ~/.zshrc，bash 用 ~/.bashrc）：
在文件末尾添加：
保存后重新加载并验证：

2.4 使用 Claude Code#

进入你的项目目录，启动即可：
在对话框中输入内容即可与 Claude 交互、编写代码。
会话内可用 /model <模型名> 临时切换模型。

第三部分：Codex 安装与配置#

3.1 安装 Codex CLI#

macOS / Linux 必要时前面加 sudo；macOS 也可用 Homebrew：brew install codex。
验证安装：

3.2 创建配置文件#

安装完成后，推荐使用CC Switch配置Codex，可参考CC-Switch配置文档，使用CC Switch无需如下操作
Codex 读取用户目录下的 .codex 文件夹，需要两个文件：
auth.json — 存放 API 密钥占位
config.toml — 存放模型与网关配置
Windows：进入用户目录的 .codex 文件夹（示例 C:\Users\你的用户名\.codex）。若看不到，先在资源管理器开启 "显示隐藏项目"；没有该文件夹则手动创建，并在其中新建 auth.json 和 config.toml。
macOS / Linux：

3.3 编辑 auth.json#

{
  "OPENAI_API_KEY": null
}
设为 null 表示不使用内置 key，而是通过 config.toml 中 env_key 指定的环境变量读取密钥。

3.4 编辑 config.toml#

model_provider = "moyuai"
model = "gpt-5.1"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
requires_openai_auth = true

[model_providers.moyuai]
name = "moyuai"
base_url = "https://www.moyu.info/v1"
wire_api = "responses"
env_key = "CRS_OAI_KEY"
字段说明
model_provider指向下方 [model_providers.xxx] 段，须一致
model使用的模型，可切换为其他 OpenAI 系列模型
model_reasoning_effort推理强度：low / medium / high
base_url平台地址，Codex 需要带 /v1
env_key读取密钥的环境变量名

3.5 配置环境变量（API Key）#

Windows：
1.
打开 设置 → 系统 → 关于 → 高级系统设置 → 环境变量
2.
在"用户变量"中点击 新建：
变量名：CRS_OAI_KEY
变量值：YOUR_API_KEY
打开新终端验证：
# PowerShell
echo $env:CRS_OAI_KEY

# CMD
echo %CRS_OAI_KEY%
macOS / Linux：
配置改完一定要重启终端让其生效。

3.6 使用 Codex#

进入项目目录，启动：
注意：Codex 启动时才读取模型配置，改完配置后需重启 Codex 才会生效。

第四部分：常见问题#

Q：Base URL 到底带不带 /v1？
A：Claude Code 不带（https://www.moyu.info），Codex 带（https://www.moyu.info/v1）
Q：配置了没生效？
A：环境变量在终端启动时读取。改完后请关闭并重开终端，Codex 还需重启 codex。
Q：提示密钥无效？
A：检查 API Key 是否正确、有无多余空格；Codex 还需确认 auth.json 的 OPENAI_API_KEY 为 null（密钥走环境变量）。
Q：想切换其他模型？
A：Claude 改 ANTHROPIC_MODEL 或会话内 /model；Codex 改 config.toml 的 model 后重启。可用模型名以平台「模型列表」为准（调用 GET /v1/models 获取）。
Q：想在多套平台 / 配置间一键切换？
A：可使用 CC-Switch 桌面工具统一管理，详见「CC-Switch 配置」文档。
修改于 2026-08-03 02:53:41
上一页
CC-Switch快速配置（推荐）
下一页
智能体集成魔芋Skills
Built with