jiniu.ai
    • 平台介绍
    • 快速接入指南
    • Claude Code 配置教程
    • Cursor 配置教程
    • OpenAI Codex CLI 配置教程
    • Gemini CLI 配置教程
    • OpenCode 配置教程
    • CC Switch 配置教程
    • Node.js 安装教程
    • Trae IDE 配置教程
    • 模型管理
      • 获取可用模型列表
        GET
    • OpenAI 格式接口
      • 文本对话（OpenAI 格式）
        POST
    • Anthropic Claude 格式接口
      • 文本对话（Anthropic Claude 格式）
        POST
    • Google Gemini 格式接口
      • 文本对话（Gemini 格式）
        POST
      • 文本对话 - 流式输出（Gemini 格式）
        POST
    • 图像生成接口
      • 生成图像（文生图）
        POST
    • 图像编辑接口
      • 编辑图像（图生图）
        POST
    • 视频生成(Seedance)
      • 素材组
        • 创建素材组
        • 查询素材组
        • 查询素材组列表
        • 删除素材组
      • 素材
        • 上传素材
        • 查询素材
        • 查询素材列表
        • 删除素材
      • 真人认证
        • 创建真人认证 H5 会话
        • 查询真人认证结果
        • 创建真人认证 H5 临时链接（平台提供）
        • [H5] 创建真人认证会话（rt_ 令牌）
        • [H5] 查询真人认证结果（rt_ 令牌）
      • 视频生成 · New-API 兼容
        • 文生视频（New-API 兼容）
        • 图生视频（New-API 兼容）
        • 视频生视频（New-API 兼容）
        • 素材引用生视频（New-API 兼容）
        • 查询任务（New-API 兼容）
      • 视频生成 · 原生格式
        • 文生视频（原生格式）
        • 图生视频（原生格式）
        • 视频生视频（原生格式）
        • 素材引用生视频（原生格式）
        • 查询任务（原生格式）
    • 数据模型
      • OpenAIMessage
      • ResponseMetadata
      • NativeContentItem
      • ChatCompletionRequest
      • BusinessError
      • VideoMetadata
      • ChatCompletionResponse
      • NativeCreateRequest
      • OpenAIUsage
      • IdResult
      • NewApiCreateRequest
      • ClaudeMessage
      • AssetGroup
      • NativeCreateResponse
      • ClaudeMessagesRequest
      • AssetGroupListItem
      • NativeQueryResponse
      • ClaudeMessagesResponse
      • Asset
      • NewApiCreateResponse
      • GeminiContent
      • AssetListItem
      • NewApiQueryResponse
      • GeminiGenerateContentRequest
      • GatewayError
      • GeminiGenerateContentResponse
      • ImageGenerationRequest
      • ImageEditRequest
      • ImageResponse
      • ModelList

    OpenAI Codex CLI 配置教程

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

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

    Codex CLI 基于 Node.js 运行，请先确认已安装 Node.js（建议 v18+ LTS 版本）。
    打开终端（Windows 用户按 Win+R 输入 cmd 回车）：
    如果没有显示版本号，请参考「Node.js 安装教程」进行安装。

    步骤 2：安装 Codex CLI#

    Windows（PowerShell，无需 sudo）#

    npm install -g @openai/codex

    macOS / Linux / WSL2#

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

    步骤 3：创建配置文件#

    如果使用 CC Switch，可以跳转「CC Switch 配置教程」，通过图形界面完成配置。
    Codex CLI 通过配置文件指定模型提供商和认证方式。

    配置文件路径#

    系统路径
    Windows%USERPROFILE%\.codex\config.toml
    macOS / Linux~/.codex/config.toml

    创建目录#

    Windows：
    New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"
    macOS / Linux / WSL2：

    写入配置文件#

    将以下内容写入 config.toml：
    model_provider = "custom"
model = "gpt-4o"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.custom]
name        = "custom"
base_url    = "https://jiniu.ai/v1"
wire_api    = "responses"
env_key     = "OPENAI_API_KEY"
    💡 model 可以替换为平台上你想使用的任意模型名称。

    步骤 4：配置 API Key#

    将 API Key 设置为环境变量。

    Windows（PowerShell）#

    临时生效（仅当前终端会话有效）：
    $env:OPENAI_API_KEY = "YOUR_API_KEY"
    永久生效（推荐）：
    [System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", "User")
    设置后需重新打开终端窗口。

    macOS / Linux / WSL2#

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

    步骤 5：开始使用#

    在任意项目目录下运行：
    输入 /status 查看当前配置状态。

    常见问题#

    Q：环境变量设置后不生效？
    A：重新打开一个终端窗口，或执行 source ~/.bashrc。
    Q：Windows 安装时提示权限错误？
    A：以管理员身份运行 PowerShell 后重试。
    Q：启动后提示找不到模型提供商？
    A：检查 config.toml 中 base_url 是否填写正确，路径末尾不要带多余的斜杠。
    修改于 2026-05-25 15:00:40
    上一页
    Cursor 配置教程
    下一页
    Gemini CLI 配置教程
    Built with