Api4Model

📦 安装指南

详细的 Claude Code 和 CodeX 安装配置指南

⚡ Claude Code 快速开始

只需三步，即可开始使用 Claude Code

安装 Claude Code

确保已安装 Node.js 18+，然后运行：

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

如未安装 Node.js，请访问 Node.js 官网下载安装

获取 API Key

访问 Api4Model 控制台，创建令牌：

点击控制台 → API 令牌页面
点击 添加令牌
令牌分组必须选择：Claude Code 专用
令牌名称随意，额度建议设置为无限
复制生成的令牌（以 sk- 开头）

创建配置文件

创建 ~/.claude/settings.json 文件（Windows: %USERPROFILE%\.claude\settings.json）

📁 Windows:

# 创建配置目录
mkdir %USERPROFILE%\.claude

# 创建并编辑配置文件
notepad %USERPROFILE%\.claude\settings.json

📁 macOS / Linux:

# 创建配置目录
mkdir -p ~/.claude

# 创建并编辑配置文件
nano ~/.claude/settings.json

settings.json 配置内容

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换为您的Claude Code专用令牌",
    "ANTHROPIC_BASE_URL": "https://one.api4model.com",
    "API_TIMEOUT_MS": "600000"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

⚙️ 配置参数说明

ANTHROPIC_AUTH_TOKEN 您在 Api4Model 控制台创建的 Claude Code 专用 API 密钥

ANTHROPIC_BASE_URL Api4Model API 服务地址：https://one.api4model.com

CLAUDE_CODE_MAX_OUTPUT_TOKENS 最大输出 Token 数量（建议 32000）

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 禁用非必要网络流量（提升性能和稳定性）

API_TIMEOUT_MS API 请求超时时间（600000ms = 10分钟）

💡

开始使用

配置完成后，在任意项目目录运行 claude 命令即可开始编程。首次启动需要选择主题、确认安全须知等，按回车使用默认配置即可。

CodeX 安装指南

系统要求

Windows 10 或 Windows 11
Node.js 18+
网络连接

安装 CodeX CLI

打开命令提示符 (CMD) 或 PowerShell，运行：

# 全局安装 CodeX CLI
npm install -g @openai/codex-cli

验证安装：

# 验证 CodeX 版本
codex --version

获取 CodeX API 令牌

访问 Api4Model 控制台：

点击 添加令牌
令牌分组选择：CodeX 专用（务必选择此分组）
令牌名称随意填写
复制生成的令牌

注意：CodeX 专用令牌与 Claude Code 令牌不同，请务必选择正确的分组！

创建配置目录

创建 CodeX 配置目录：

# 创建配置目录
mkdir %USERPROFILE%\.codex

# 进入配置目录
cd %USERPROFILE%\.codex

创建配置文件

创建 config.toml

在 %USERPROFILE%\.codex\ 目录下创建 config.toml 文件，填入以下内容：

model_provider = "api4model"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.api4model]
name = "api4model"
base_url = "https://one.api4model.com/v1"
wire_api = "responses"

配置说明：

model_provider: 模型提供商名称
model: 使用的模型（gpt-5-codex）
model_reasoning_effort: 推理强度（high/medium/low）
disable_response_storage: 禁用响应存储
base_url: Api4Model API 服务地址
wire_api: API 响应格式

创建 auth.json

在 %USERPROFILE%\.codex\ 目录下创建 auth.json 文件，填入以下内容：

{
  "OPENAI_API_KEY": "替换为您的 CodeX 专用令牌"
}

重要：请将 OPENAI_API_KEY 的值替换为您在控制台获取的 CodeX 专用令牌！

设置环境变量（可选）

除了配置文件外，也可以通过环境变量设置 API 密钥：

# 设置 CodeX API 密钥
setx OPENAI_API_KEY "your-codex-token"

注意：环境变量设置后需要重启终端才能生效。API 基础 URL 已在 config.toml 中配置。

开始使用 CodeX

常用 CodeX 命令：

# 代码分析
codex analyze

# 生成提交信息
codex commit

# 代码重构建议
codex refactor

# 代码质量评估
codex review

系统要求

macOS 10.15 (Catalina) 或更高版本
Node.js 18+
网络连接

安装 CodeX CLI

使用 Homebrew（推荐）：

# 使用 Homebrew 安装
brew install codex

或者使用 npm：

# 使用 npm 全局安装
npm install -g @openai/codex-cli

验证安装：

# 验证 CodeX 版本
codex --version

获取 CodeX API 令牌

访问 Api4Model 控制台：

点击 添加令牌
令牌分组选择：CodeX 专用（务必选择此分组）
令牌名称随意填写
复制生成的令牌

注意：CodeX 专用令牌与 Claude Code 令牌不同，请务必选择正确的分组！

创建配置目录

创建 CodeX 配置目录：

# 创建配置目录
mkdir -p ~/.codex

# 进入配置目录
cd ~/.codex

创建配置文件

创建 config.toml

在 ~/.codex/ 目录下创建 config.toml 文件，填入以下内容：

model_provider = "api4model"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.api4model]
name = "api4model"
base_url = "https://one.api4model.com/v1"
wire_api = "responses"

配置说明：

model_provider: 模型提供商名称
model: 使用的模型（gpt-5-codex）
model_reasoning_effort: 推理强度（high/medium/low）
disable_response_storage: 禁用响应存储
base_url: Api4Model API 服务地址
wire_api: API 响应格式

创建 auth.json

在 ~/.codex/ 目录下创建 auth.json 文件，填入以下内容：

{
  "OPENAI_API_KEY": "替换为您的 CodeX 专用令牌"
}

重要：请将 OPENAI_API_KEY 的值替换为您在控制台获取的 CodeX 专用令牌！

设置环境变量（可选）

除了配置文件外，也可以通过环境变量设置 API 密钥：

# 添加 API 密钥到配置文件
echo 'export OPENAI_API_KEY="your-codex-token"' >> ~/.zshrc

# 重新加载配置
source ~/.zshrc

如果使用 bash，则替换 ~/.zshrc 为 ~/.bash_profile

注意：API 基础 URL 已在 config.toml 中配置。

开始使用 CodeX

常用 CodeX 命令：

# 代码分析
codex analyze

# 生成提交信息
codex commit

# 代码重构建议
codex refactor

# 代码质量评估
codex review

系统要求

Ubuntu 18.04+, CentOS 7+, Debian 9+
Node.js 18+
网络连接

安装 CodeX CLI

使用 npm：

# 全局安装 CodeX CLI
npm install -g @openai/codex-cli

验证安装：

# 验证 CodeX 版本
codex --version

获取 CodeX API 令牌

访问 Api4Model 控制台：

点击 添加令牌
令牌分组选择：CodeX 专用（务必选择此分组）
令牌名称随意填写
复制生成的令牌

注意：CodeX 专用令牌与 Claude Code 令牌不同，请务必选择正确的分组！

创建配置目录

创建 CodeX 配置目录：

# 创建配置目录
mkdir -p ~/.codex

# 进入配置目录
cd ~/.codex

创建配置文件

创建 config.toml

在 ~/.codex/ 目录下创建 config.toml 文件，填入以下内容：

model_provider = "api4model"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.api4model]
name = "api4model"
base_url = "https://one.api4model.com/v1"
wire_api = "responses"

配置说明：

model_provider: 模型提供商名称
model: 使用的模型（gpt-5-codex）
model_reasoning_effort: 推理强度（high/medium/low）
disable_response_storage: 禁用响应存储
base_url: Api4Model API 服务地址
wire_api: API 响应格式

创建 auth.json

在 ~/.codex/ 目录下创建 auth.json 文件，填入以下内容：

{
  "OPENAI_API_KEY": "替换为您的 CodeX 专用令牌"
}

重要：请将 OPENAI_API_KEY 的值替换为您在控制台获取的 CodeX 专用令牌！

设置环境变量（可选）

除了配置文件外，也可以通过环境变量设置 API 密钥：

# 添加 API 密钥到配置文件
echo 'export OPENAI_API_KEY="your-codex-token"' >> ~/.bashrc

# 重新加载配置
source ~/.bashrc

如果使用 zsh，则替换 ~/.bashrc 为 ~/.zshrc

注意：API 基础 URL 已在 config.toml 中配置。

开始使用 CodeX

常用 CodeX 命令：

#代码分析
codex analyze

# 生成提交信息
codex commit

# 代码重构建议
codex refactor

# 代码质量评估
codex review

VSCode 扩展配置指南

安装 Claude Code 插件

在 VSCode 扩展市场搜索并安装 "Claude Code" 官方插件。

步骤2：使用 config.json 配置

创建 Claude Code 配置文件：

配置文件位置

Windows: %USERPROFILE%\.claude\config.json
macOS: ~/.claude/config.json
Linux: ~/.claude/config.json

配置文件内容

{
  "primaryApiKey": "你的Claude Code专用令牌"
}

重要：请将 primaryApiKey 的值替换为您在 Api4Model 控制台获取的 Claude Code 专用令牌！

步骤3：使用 settings.json 配置

打开 VSCode 的 settings.json 文件：

Windows: Ctrl+Shift+P → "Preferences: Open Settings (JSON)"
macOS: Cmd+Shift+P → "Preferences: Open Settings (JSON)"
Linux: Ctrl+Shift+P → "Preferences: Open Settings (JSON)"

添加以下配置：

{
  "claude-code.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "你的Claude Code专用令牌"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://one.api4model.com"
    }
  ]
}

注意：

请将 ANTHROPIC_AUTH_TOKEN 的值替换为您的 Claude Code 专用令牌
配置完成后重启 VSCode 以确保设置生效

验证配置

重启 VSCode 后，打开 Claude Code 插件，应该可以正常使用 Api4Model 服务了。

CodeX VSCode 插件说明

CodeX 主要作为命令行工具使用。如果您使用了第三方 AI 编程助手插件（如 ChatGPT、Copilot 等），可以通过以下方式配置。

CodeX VSCode 插件配置

如果您使用了支持 CodeX 的 VSCode AI 插件，打开 settings.json 并添加以下配置：

{
  "chatgpt.apiBase": "https://one.api4model.com/v1",
  "chatgpt.config": {
    "preferred_auth_method": "你的CodeX专用令牌",
    "model": "gpt-5-codex",
    "model_reasoning_effort": "high",
    "disable_response_storage": true,
    "wire_api": "responses"
  }
}

配置参数说明：

model: 使用的模型（gpt-5-codex）
model_reasoning_effort: 推理强度（high/medium/low）
disable_response_storage: 禁用响应存储
wire_api: API 响应格式
apiBase: Api4Model API 服务地址
apiKey: 您的 CodeX 专用令牌

获取 CodeX API 令牌

访问 Api4Model 控制台获取 CodeX 专用令牌：

点击控制台 → API 令牌页面
点击 添加令牌
令牌分组必须选择：CodeX 专用
令牌名称随意填写
复制生成的令牌并替换配置中的 apiKey 值

重要：请确保使用 CodeX 专用分组令牌，不是普通令牌！

验证配置

配置完成后，重启 VSCode 并验证 CodeX 插件是否正常工作：

重启 VSCode
打开 CodeX 插件或相关 AI 助手功能
测试代码生成或分析功能
确认能够正常使用 Api4Model 服务

提示：如果遇到问题，请检查 API 令牌是否正确，以及网络连接是否正常。

命令	描述
/help	显示可用命令列表和简短描述
/clear	清除当前会话历史记录
/exit	退出 Claude Code
/model	选择或更改 AI 模型
/status	查看账户和系统状态
/update	检查并更新到最新版本

命令	描述
/edit	打开文件进行编辑
/file	查看或创建文件
/diff	查看文件变更
/ls	列出目录内容
/cd	更改当前工作目录
/grep	在文件中搜索文本

命令	描述
/commit	创建 Git 提交
/branch	创建或切换 Git 分支
/pr	创建拉取请求
/pr_comments	查看拉取请求评论

命令	描述
/browse	浏览网页获取信息
/ide	连接到 IDE
/login	登录到您的 Anthropic 账户
/logout	从您的 Anthropic 账户登出
/memory	编辑 CLAUDE.md 内存文件
/permissions	查看或更新权限
/review	请求代码审查
/vim	进入 vim 模式，在插入和命令模式之间切换

常见问题

⚠️ Invalid API Key · Please run /login 怎么解决？

这表明 Claude Code 没有检测到环境变量，不要使用 /login 命令，只需参考上面的安装配置部分设置环境变量或 settings.json 文件即可。

🔴 显示 `offline` 是什么原因？

Claude Code 会通过检查是否能连接到 Google 来判断网络状态，显示 `offline` 并不影响正常使用，只是表明无法访问 Google（可能是网络环境限制）。

📋 为什么浏览网页的 Fetch 会失败？

这是因为 Claude Code 在访问页面前需要调用 Claude 官方服务来询问是否可以访问，建议确保网络连接，必要时使用国际网络环境。

🔵 如何退出 Claude Code？

按两次 Ctrl+C 或者按两次 Ctrl+D 即可退出。

🔄 如何更新 Claude Code？

一行命令搞定：claude update

⚠️ 出现 529、549 报错怎么解决？

这是上游服务器负载过高的临时错误，建议：

稍等/分钟后重试
尝试切换到 Sonnet 模型（使用 /model 命令）
如持续出现可联系技术支持

🔴 API Error: Cannot read properties of undefined (reading 'filter') 报错？

这是网络连接不稳定导致的临时错误，建议：

检查网络连接是否正常
重新启动 Claude Code
如问题持续，可尝试技术支持热线

💭 推荐使用哪个模型？

推荐使用 Sonnet 模型：

性价比最高：比 Opus 便宜约 5 倍
性能优秀：智能程度与 Opus 基本相同
切换方法：在 Claude Code 中输入 /model 命令选择

🔧 CodeX 配置文件找不到怎么办？

确保在正确的位置创建 .codex 文件夹：

Windows: %USERPROFILE%\.codex\
macOS/Linux: ~/.codex/

文件夹需要手动创建，确保包含 config.toml 和 auth.json 两个文件。

🔑 CodeX 显示 "No API key found" 错误？

这表示环境变量或配置文件中的 API 密钥未正确设置：

检查 auth.json 中的 OPENAI_API_KEY 是否正确
确认环境变量已设置并重启终端
务必使用 CodeX 专用分组令牌，不是普通令牌

🔀 Claude Code 和 CodeX 有什么区别？

Claude Code: Anthropic 官方 CLI 工具，使用 Claude 模型，适合交互式编程

CodeX: OpenAI 代码助手，使用 GPT-5 模型，推理能力更强，擅长代码重构和提交信息生成

两者可以同时使用，互为补充。

📝 CodeX 如何生成更好的提交信息？

CodeX 的 codex commit 命令会：

自动分析代码变更
理解变更的意图和影响
生成符合 Conventional Commits 规范的提交信息
建议合适的提交类型（feat/fix/docs 等）

查看更多常见问题 →

Claude Code & CodeX 提供商

什么是 Claude Code & CodeX？

Claude Code

CodeX

实际开发体验对比

使用 Claude Code

传统开发方式

使用 CodeX

主要功能

智能代码生成

代码分析

调试助手

文档生成

命令行集成

支持平台与系统要求

Windows

macOS

Linux

为什么选择 Api4Model？

价格优势

高稳定性

简单配置

📦 安装指南

⚡ Claude Code 快速开始

安装 Claude Code

获取 API Key

创建配置文件

⚙️ 配置参数说明

CodeX 安装指南

系统要求

安装 CodeX CLI

获取 CodeX API 令牌

创建配置目录

创建配置文件

创建 config.toml

创建 auth.json

设置环境变量（可选）

开始使用 CodeX

系统要求

安装 CodeX CLI

获取 CodeX API 令牌

创建配置目录

创建配置文件

创建 config.toml

创建 auth.json

设置环境变量（可选）

开始使用 CodeX

系统要求

安装 CodeX CLI

获取 CodeX API 令牌

创建配置目录

创建配置文件

创建 config.toml

创建 auth.json

设置环境变量（可选）

开始使用 CodeX

VSCode 扩展配置指南

安装 Claude Code 插件

步骤2：使用 config.json 配置

配置文件位置

配置文件内容

步骤3：使用 settings.json 配置

验证配置

CodeX VSCode 插件说明

CodeX VSCode 插件配置

获取 CodeX API 令牌

验证配置

推荐使用 CLI

命令参考

基础命令

文件操作命令

Git 命令

高级命令

实战场景示例

基础代码生成

代码审查和修复

自动化 Git 操作

常见问题

准备开始了吗？