自由空间

自由AI空间·开放分享平台

API 配置指南

全面的 Claude Code 和 Codex CLI 配置教程，帮助你快速接入第三方 API 中转服务。

Windows 系统配置教程

本教程将指导你在 Windows 系统上配置 Claude Code 和 Codex CLI 使用第三方 API 中转服务。

一、环境准备

1. 安装 Node.js

首先确保你的系统已安装 Node.js (建议 v18 或更高版本)：

# 检查 Node.js 版本
node --version

# 如未安装，请从官网下载: https://nodejs.org/

2. 安装 Claude Code CLI

# 使用 npm 全局安装
npm install -g @anthropic-ai/claude-code

3. 安装 Codex CLI

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

二、配置 Claude Code 使用第三方 API

方法一：使用环境变量配置

打开 PowerShell 或命令提示符，设置环境变量：

# 设置 API 基础地址（替换为你的中转服务地址）
set ANTHROPIC_BASE_URL=https://your-api-proxy.com

# 设置 API 密钥（替换为你的密钥）
set ANTHROPIC_API_KEY=sk-your-api-key-here

# 启动 Claude Code
claude

方法二：永久配置环境变量

右键点击"此电脑" → "属性" → "高级系统设置"
点击"环境变量"按钮
在"用户变量"中点击"新建"
添加以下变量：
变量名: ANTHROPIC_BASE_URL 变量值: https://your-api-proxy.com 变量名: ANTHROPIC_API_KEY 变量值: sk-your-api-key-here
点击"确定"保存，重启终端生效

三、配置 Codex CLI 使用第三方 API

# 设置 OpenAI API 基础地址
set OPENAI_BASE_URL=https://your-api-proxy.com/v1

# 设置 API 密钥
set OPENAI_API_KEY=sk-your-api-key-here

# 启动 Codex
codex

提示： 建议将环境变量添加到系统的永久配置中，避免每次重启后需要重新设置。

四、验证配置

# 测试 Claude Code
claude --version
claude "Hello, this is a test"

# 测试 Codex
codex --version
codex "Write a hello world in Python"

macOS 系统配置教程

本教程将指导你在 macOS 系统上配置 Claude Code 和 Codex CLI 使用第三方 API 中转服务。

一、环境准备

1. 安装 Homebrew（如未安装）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 Node.js

# 使用 Homebrew 安装
brew install node

# 验证安装
node --version
npm --version

3. 安装 Claude Code 和 Codex CLI

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

# 安装 Codex
npm install -g @openai/codex

二、配置 Claude Code 使用第三方 API

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

# 设置 API 基础地址
export ANTHROPIC_BASE_URL="https://your-api-proxy.com"

# 设置 API 密钥
export ANTHROPIC_API_KEY="sk-your-api-key-here"

# 启动 Claude Code
claude

方法二：永久配置（推荐）

编辑你的 shell 配置文件：

# 如果使用 zsh（macOS 默认）
nano ~/.zshrc

# 如果使用 bash
nano ~/.bash_profile

在文件末尾添加以下内容：

# Claude Code API 配置
export ANTHROPIC_BASE_URL="https://your-api-proxy.com"
export ANTHROPIC_API_KEY="sk-your-api-key-here"

# Codex API 配置
export OPENAI_BASE_URL="https://your-api-proxy.com/v1"
export OPENAI_API_KEY="sk-your-api-key-here"

保存后执行以下命令使配置生效：

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

三、验证配置

# 检查环境变量是否设置成功
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

# 测试 Claude Code
claude "Hello, this is a test"

# 测试 Codex
codex "Write a hello world in Python"

注意： 请妥善保管你的 API 密钥，不要将其提交到公开的代码仓库中。

Linux 系统配置教程

本教程将指导你在 Linux 系统上配置 Claude Code 和 Codex CLI 使用第三方 API 中转服务。

一、环境准备

1. 安装 Node.js

使用 NodeSource 仓库安装最新版 Node.js：

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# CentOS/RHEL/Fedora
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

# Arch Linux
sudo pacman -S nodejs npm

# 验证安装
node --version
npm --version

2. 安装 Claude Code 和 Codex CLI

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

# 安装 Codex
sudo npm install -g @openai/codex

二、配置 Claude Code 使用第三方 API

方法一：临时配置

# 设置环境变量并启动
export ANTHROPIC_BASE_URL="https://your-api-proxy.com"
export ANTHROPIC_API_KEY="sk-your-api-key-here"
claude

方法二：永久配置

编辑 ~/.bashrc 或 ~/.zshrc 文件：

# 使用你喜欢的编辑器
vim ~/.bashrc
# 或
nano ~/.bashrc

在文件末尾添加：

# ===== API 配置 =====
# Claude Code
export ANTHROPIC_BASE_URL="https://your-api-proxy.com"
export ANTHROPIC_API_KEY="sk-your-api-key-here"

# Codex
export OPENAI_BASE_URL="https://your-api-proxy.com/v1"
export OPENAI_API_KEY="sk-your-api-key-here"

使配置生效：

source ~/.bashrc

方法三：使用 systemd 用户环境变量（适用于桌面环境）

# 创建或编辑环境变量文件
mkdir -p ~/.config/environment.d
nano ~/.config/environment.d/api.conf

添加以下内容：

ANTHROPIC_BASE_URL=https://your-api-proxy.com
ANTHROPIC_API_KEY=sk-your-api-key-here
OPENAI_BASE_URL=https://your-api-proxy.com/v1
OPENAI_API_KEY=sk-your-api-key-here

三、验证配置

# 验证环境变量
env | grep -E "(ANTHROPIC|OPENAI)"

# 测试 Claude Code
claude --version
claude "Hello, this is a test"

# 测试 Codex
codex --version
codex "Write a hello world in Python"

提示： 如果遇到权限问题，可以考虑使用 nvm (Node Version Manager) 来管理 Node.js，这样可以避免使用 sudo 安装全局包。

四、常见问题排查

# 检查网络连接
curl -I https://your-api-proxy.com/v1

# 检查 DNS 解析
nslookup your-api-proxy.com

# 如果使用代理
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890

通用配置说明

支持的环境变量

工具	环境变量	说明
Claude Code	ANTHROPIC_BASE_URL	API 基础地址
Claude Code	ANTHROPIC_API_KEY	API 密钥
Codex	OPENAI_BASE_URL	API 基础地址
Codex	OPENAI_API_KEY	API 密钥

安全提醒：

不要将 API 密钥提交到公开的代码仓库
定期轮换你的 API 密钥
使用环境变量而非硬编码密钥
在共享设备上使用完毕后清除环境变量