CoderPlanCoderPlan
HomePricingLotteryAbout
Docs/问题排查

codex unexpected status 401 unauthorized 排查教程

Codex CLI 返回 401 时，检查 Base URL、Key、额度和环境变量。

Browse docs

Docs

  • 开始使用
    • 快速上手
    • API Key 接入配置Important
    • Claude Code 配置
    • Codex CLI 配置
    • Gemini CLI 配置
    • Cursor 配置
    • OpenClaw 配置
    • Hermes Agent 配置
    • Cline 配置
  • 问题排查
    • Anthropic 连接失败
    • Anthropic err_bad_request
    • Codex 401 unauthorized
  • 使用优化
    • RTK 上下文管理
    • Context7 提高准确性
    • 模型选择
    • 成本控制

Docs

  • 开始使用
    • 快速上手
    • API Key 接入配置Important
    • Claude Code 配置
    • Codex CLI 配置
    • Gemini CLI 配置
    • Cursor 配置
    • OpenClaw 配置
    • Hermes Agent 配置
    • Cline 配置
  • 问题排查
    • Anthropic 连接失败
    • Anthropic err_bad_request
    • Codex 401 unauthorized
  • 使用优化
    • RTK 上下文管理
    • Context7 提高准确性
    • 模型选择
    • 成本控制

This article is not available in English yet

This article is not available in English yet. You can view the Chinese source for now.

Codex 401 unauthorized

codex unexpected status 401 unauthorized 表示 Codex CLI 当前请求没有通过认证。先确认 OPENAI_BASE_URL 指向 CoderPlan 的 `/v1` endpoint，OPENAI_API_KEY 是完整的 CoderPlan API Key，再检查账户 API 使用额度、模型权限和项目 `.env` 是否覆盖了当前 shell。

Setup steps

  1. 1

    确认 OPENAI_BASE_URL 包含 `/v1`

    Codex CLI 使用 OpenAI Compatible 接入时，Base URL 应填写 CoderPlan 的 `/v1` endpoint。

    OPENAI_BASE_URL=https://api.coderplan.ai/v1
  2. 2

    确认 OPENAI_API_KEY

    OPENAI_API_KEY 使用 CoderPlan 控制台生成的完整 `sk-` 密钥。少复制字符、多空格或使用旧密钥都会导致 401。

    OPENAI_API_KEY=sk-your-api-key
  3. 3

    排除旧环境变量覆盖

    检查项目 `.env`、shell profile、IDE 运行配置和系统 keychain，确认 Codex CLI 读取的是当前这组值。

  4. 4

    确认 API 使用额度和模型权限

    如果认证字段正确，再检查 CoderPlan API 使用额度、API Key 状态和目标模型是否可用。

FAQ

Codex 401 一定是 API Key 错了吗？

API Key 是最常见原因，但 API 使用额度不可用、模型权限不匹配、OPENAI_BASE_URL 少了 `/v1` 或旧环境变量覆盖，也可能表现为 401。

为什么我已经 export 了新 key，Codex 还是 401？

Codex CLI 可能读取项目 `.env`、IDE 环境或全局配置。建议在同一个终端打印 OPENAI_BASE_URL 和 key 前缀，确认当前进程实际读取的新值。

Search and article contents

Search docs

Article contents

  • 错误现象
  • 常见原因
  • 按顺序检查
  • 常见问题

Related links

  • Codex CLI 接入教程按 OpenAI Compatible 方式配置 CoderPlan `/v1` endpoint 和 API Key。
  • 开始使用首次使用前，先准备账号、额度、API Key 和 endpoint。
  • 定价与模型费用查看模型价格、充值 API 使用额度、缓存复用和按量扣费说明。
  • 问题排查遇到认证失败、endpoint 错误或 401 时，按顺序检查配置。
CoderPlanCoderPlan

An AI coding service platform for developers, making common tools easier to connect and manage.

[email protected]

Product

  • Pricing
  • Sign up

Docs

  • Quickstart
  • API Key setup

Supported services

  • Claude Code
  • OpenAI Codex / GPT
  • Gemini

About

  • About
  • Contact us
  • Service Status

© 2026 CoderPlan. All rights reserved.

Privacy Policy|Terms of Service|Refund Policy
Checking...We only process service access and usage records; we do not store your code content or conversation bodies.