本教程詳細(xì)介紹 Codex 與 Claude Code 在 Windows、Mac、Linux 三大主流操作系統(tǒng)上的安裝與配置方法，兩款工具均通過(guò) xuedingmao.com 站點(diǎn)進(jìn)行 API 調(diào)用配置。

第一部分：Codex 安裝與配置教程

Codex 是 OpenAI 推出的 AI 編程工具，可在終端或 VSCode 中使用。

Windows 版本教程

系統(tǒng)要求

• Windows 10 或 Windows 11
• Node.js 22+
• npm 10+
• 網(wǎng)絡(luò)連接

安裝步驟

?? 前置步驟：安裝 Git Bash

請(qǐng)?jiān)L問(wèn) Git - Downloads 下載對(duì)應(yīng)您電腦系統(tǒng)的版本，之后一直點(diǎn)擊"下一步"即可完成安裝。

1. 安裝 Node.js

訪問(wèn) Node.js 官網(wǎng) 下載并安裝最新 LTS 版本。

2. 安裝 codex

打開命令提示符 (CMD) 或 PowerShell，運(yùn)行：

npm install -g @openai/codex

3. 驗(yàn)證安裝

打開命令提示符 (CMD) 或 PowerShell，運(yùn)行：

codex --version

配置 API

1. 獲取 Auth Token

訪問(wèn) xuedingmao.com 站點(diǎn)頁(yè)面進(jìn)行以下操作：

• 點(diǎn)擊 控制臺(tái) → API令牌 頁(yè)面
• 點(diǎn)擊 添加令牌
• 令牌分組請(qǐng)選擇：codex專屬（務(wù)必選擇此分組，否則無(wú)法使用）
• 令牌名稱隨意
• 額度建議：設(shè)置為 無(wú)限額度
• 其他選項(xiàng)保持默認(rèn)

2. 配置文件

重要提示：請(qǐng)將下方的 sk-xxx 替換為您在 xuedingmao.com 生成的實(shí)際 API 密鑰！

進(jìn)入當(dāng)前用戶的用戶目錄下的 .codex 文件夾中，例如：C:\Users\testuser\.codex

注意：如果看不到該目錄，說(shuō)明您沒(méi)有打開 Windows 的"顯示隱藏的項(xiàng)目"，請(qǐng)先在文件資源管理器中開啟。

如果沒(méi)有 .codex 文件夾，請(qǐng)手動(dòng)創(chuàng)建該文件夾，然后在其中創(chuàng)建 config.toml 以及 auth.json 兩個(gè)文件。

填寫配置（需要將 sk-xxx 替換成您自己創(chuàng)建的真實(shí) SK）

auth.json 中的配置：

{"OPENAI_API_KEY": "sk-xxx"}

config.toml 中的配置：

model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.api111]
name = "api111"
base_url = "https://xuedingmao.com/v1"
wire_api = "responses"

model_reasoning_effort 可選值為 high、medium、low，分別代表模型思考的努力程度（高、中、低）。

啟動(dòng) codex

?? 重啟終端！然后進(jìn)入到您的工程目錄：

cd your-project-folder

運(yùn)行以下命令啟動(dòng)：

codex

VSCode 插件 codex

以上配置完成后，在 VSCode 擴(kuò)展商店中搜索并安裝 codex 即可。

安裝完成后會(huì)出現(xiàn)在側(cè)邊欄。

Mac 版本教程

系統(tǒng)要求

• macOS 12 或更高版本
• Node.js 22+
• npm 10+
• 網(wǎng)絡(luò)連接

安裝步驟

1. 安裝 Node.js

• 方式一：直接訪問(wèn) Node.js 官網(wǎng) 下載并安裝最新 LTS 版本
• 方式二：使用 Homebrew（推薦）

# 如果尚未安裝 Homebrew，請(qǐng)先運(yùn)行此命令
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安裝 Node.js
brew install node

2. 安裝 codex

打開終端 (Terminal)，運(yùn)行（可能需要加 sudo）：

npm install -g @openai/codex

3. 驗(yàn)證安裝

打開終端 (Terminal)，運(yùn)行：

codex --version

配置 API

1. 獲取 Auth Token

訪問(wèn) xuedingmao.com 站點(diǎn)頁(yè)面進(jìn)行以下操作：

• 點(diǎn)擊 控制臺(tái) → API令牌 頁(yè)面
• 點(diǎn)擊 添加令牌
• 令牌分組請(qǐng)選擇：codex專屬（務(wù)必選擇此分組，否則無(wú)法使用）
• 令牌名稱隨意
• 額度建議：設(shè)置為 無(wú)限額度
• 其他選項(xiàng)保持默認(rèn)

2. 配置文件

重要提示：請(qǐng)將下方的 sk-xxx 替換為您在 xuedingmao.com 生成的實(shí)際 API 密鑰！

1. 創(chuàng)建目錄和文件：

mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml

2. 編輯 auth.json 文件：

vi ~/.codex/auth.json

按 i 進(jìn)入插入模式，粘貼以下內(nèi)容（將 sk-xxx 替換為您的密鑰），然后按 ESC 鍵，輸入 :wq 并回車保存退出。

{"OPENAI_API_KEY": "sk-xxx"}

3. 編輯 config.toml 文件：

vi ~/.codex/config.toml

按 i 進(jìn)入插入模式，粘貼以下內(nèi)容，然后按 ESC 鍵，輸入 :wq 并回車保存退出。

model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.api111]
name = "api111"
base_url = "https://xuedingmao.com/v1"
wire_api = "responses"

啟動(dòng) codex

?? 重啟終端！然后進(jìn)入到您的工程目錄：

cd your-project-folder

運(yùn)行以下命令啟動(dòng)：

codex

VSCode 插件 codex

以上配置完成后，在 VSCode 擴(kuò)展商店中搜索并安裝 codex 即可，安裝完成后會(huì)出現(xiàn)在側(cè)邊欄。

Linux 版本教程

系統(tǒng)要求

• 主流 Linux 發(fā)行版 (Ubuntu 20.04+、Debian 10+、CentOS 7+ 等)
• Node.js 22+
• npm 10+
• 網(wǎng)絡(luò)連接

安裝步驟

1. 安裝 Node.js

• Ubuntu/Debian

sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

• CentOS/RHEL/Fedora

# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)
sudo dnf install nodejs npm
# 或
sudo yum install nodejs npm

• Arch Linux

sudo pacman -S nodejs npm

2. 安裝 codex

打開終端 (Terminal)，運(yùn)行：

sudo npm install -g @openai/codex

3. 驗(yàn)證安裝

打開終端 (Terminal)，運(yùn)行：

codex --version

配置 API

1. 獲取 Auth Token

訪問(wèn) xuedingmao.com 站點(diǎn)頁(yè)面進(jìn)行以下操作：

• 點(diǎn)擊 控制臺(tái) → API令牌 頁(yè)面
• 點(diǎn)擊 添加令牌
• 令牌分組請(qǐng)選擇：codex專屬（務(wù)必選擇此分組，否則無(wú)法使用）
• 令牌名稱隨意
• 額度建議：設(shè)置為 無(wú)限額度
• 其他選項(xiàng)保持默認(rèn)

2. 配置文件

重要提示：請(qǐng)將下方的 sk-xxx 替換為您在 xuedingmao.com 生成的實(shí)際 API 密鑰！

1. 創(chuàng)建目錄和文件：

mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml

2. 編輯 auth.json 文件：

vi ~/.codex/auth.json

按 i 進(jìn)入插入模式，粘貼以下內(nèi)容（將 sk-xxx 替換為您的密鑰），然后按 ESC 鍵，輸入 :wq 并回車保存退出。

{"OPENAI_API_KEY": "sk-xxx"}

3. 編輯 config.toml 文件：

vi ~/.codex/config.toml

按 i 進(jìn)入插入模式，粘貼以下內(nèi)容，然后按 ESC 鍵，輸入 :wq 并回車保存退出。

model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.api111]
name = "api111"
base_url = "https://xuedingmao.com/v1"
wire_api = "responses"

啟動(dòng) codex

?? 重啟終端！然后進(jìn)入到您的工程目錄：

cd your-project-folder

運(yùn)行以下命令啟動(dòng)：

codex

VSCode 插件 codex

以上配置完成后，在 VSCode 擴(kuò)展商店中搜索并安裝 codex 即可。

安裝完成后會(huì)出現(xiàn)在側(cè)邊欄。

Codex 常見(jiàn)問(wèn)題

出現(xiàn)錯(cuò)誤請(qǐng)按照如下步驟排查：

1. 確認(rèn) API Key 創(chuàng)建是否正確：額度選擇無(wú)限額度，不要限制模型，分組選擇 codex專屬
2. 確認(rèn)配置文件中的 sk-xxx 已替換為您的實(shí)際密鑰
3. 確認(rèn) .codex 文件夾已正確創(chuàng)建在用戶目錄下

更多 codex 配置及使用詳情請(qǐng)參考 codex 官方教程。

第二部分：Claude Code 安裝使用教程

Claude Code 是一個(gè)強(qiáng)大的 AI 編程助手，讓您可以直接在終端中與 AI 協(xié)作編程。本教程將指導(dǎo)您完成安裝和配置過(guò)程。

系統(tǒng)要求

• Node.js 版本 ≥ 18.0
• 支持的操作系統(tǒng)：macOS、Linux、Windows (WSL)

快速開始

1. 安裝 Node.js

?? 提示：如果您已經(jīng)安裝了 Node.js 18.0 或更高版本，可以跳過(guò)此步驟。

Ubuntu / Debian 用戶

# 安裝 Node.js LTS 版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs
# 驗(yàn)證安裝
node --version

macOS 用戶

# 安裝 Xcode 命令行工具
sudo xcode-select --install
# 安裝 Homebrew（如果尚未安裝）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 通過(guò) Homebrew 安裝 Node.js
brew install node
# 驗(yàn)證安裝
node --version

2. 安裝 Claude Code

使用 npm 全局安裝 Claude Code：

npm install -g @anthropic-ai/claude-code
# 驗(yàn)證安裝
claude --version

3. 配置并開始使用

獲取必要的配置信息

您需要準(zhǔn)備兩個(gè)重要的配置項(xiàng)：

?? 創(chuàng)建令牌時(shí)的建議設(shè)置：

• 名稱：隨意命名
• 額度：設(shè)為無(wú)限額度
• 分組：選擇 Claude code專屬 或者 官轉(zhuǎn)克勞德3及以上
• 其他選項(xiàng)：保持默認(rèn)設(shè)置

啟動(dòng) Claude Code

在您的項(xiàng)目目錄下運(yùn)行：

Linux/Unix 系統(tǒng)

# 進(jìn)入項(xiàng)目目錄
cd your-project-folder
# 設(shè)置環(huán)境變量
export ANTHROPIC_BASE_URL=https://xuedingmao.com
export ANTHROPIC_AUTH_TOKEN=sk-...   # 替換為您的實(shí)際令牌
export API_TIMEOUT_MS=300000         # 設(shè)置為 300 秒超時(shí)
# 啟動(dòng) Claude Code
claude

Windows PowerShell 系統(tǒng)

# 進(jìn)入項(xiàng)目目錄
cd your-project-folder
# 設(shè)置環(huán)境變量
$env:ANTHROPIC_BASE_URL = "https://xuedingmao.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-..."   # 替換為您的實(shí)際令牌
$env:API_TIMEOUT_MS = "300000"          # 設(shè)置為 300 秒超時(shí)
# 啟動(dòng) Claude Code
claude

Windows CMD 系統(tǒng)

# 進(jìn)入項(xiàng)目目錄
cd your-project-folder
# 設(shè)置環(huán)境變量
set ANTHROPIC_BASE_URL=https://xuedingmao.com
set ANTHROPIC_AUTH_TOKEN=sk-...   # 替換為您的實(shí)際令牌
set API_TIMEOUT_MS=300000           # 設(shè)置為 300 秒超時(shí)
# 啟動(dòng) Claude Code
claude

初次運(yùn)行配置

啟動(dòng)后，您將看到以下配置步驟：

1. 選擇主題 → 選擇您喜歡的主題 + 按 Enter
2. 安全須知 → 確認(rèn)安全須知 + 按 Enter
3. Terminal 配置 → 使用默認(rèn)配置 + 按 Enter
4. 工作目錄信任 → 信任當(dāng)前目錄 + 按 Enter

? 恭喜！ 現(xiàn)在您可以開始與您的 AI 編程搭檔一起寫代碼了！

Claude Code 常見(jiàn)問(wèn)題解答

Q: 遇到 “Invalid API Key · Please run /login” 錯(cuò)誤？

A: 這表明 Claude Code 未檢測(cè)到環(huán)境變量。請(qǐng)檢查：

• 是否正確設(shè)置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
• 環(huán)境變量值是否正確（令牌以 sk- 開頭）
• 如果使用了永久配置，是否重啟了終端

Q: 為什么顯示 “offline” 狀態(tài)？

A: Claude Code 通過(guò)連接 Google 來(lái)判斷網(wǎng)絡(luò)狀態(tài)。顯示 “offline” 不影響正常使用，只是表明無(wú)法連接到 Google。

Q: 為什么瀏覽網(wǎng)頁(yè)的 Fetch 會(huì)失??？

A: Claude Code 在訪問(wèn)網(wǎng)頁(yè)前需要調(diào)用 Claude 服務(wù)進(jìn)行安全檢查。您需要：

• 保持穩(wěn)定的國(guó)際互聯(lián)網(wǎng)連接
• 必要時(shí)使用全局代理

Q: 請(qǐng)求總是顯示 “fetch failed”？

A: 可能是網(wǎng)絡(luò)環(huán)境導(dǎo)致的問(wèn)題。解決方案：

1. 退出 Claude Code（Ctrl+C）
2. 重新運(yùn)行 claude 命令
3. 如果問(wèn)題持續(xù)，請(qǐng)稍后再試

Q: API 報(bào)錯(cuò)如何處理？

A: 可能是轉(zhuǎn)發(fā)代理不穩(wěn)定導(dǎo)致的，建議：

• 退出 Claude Code（Ctrl+C）
• 重新運(yùn)行 claude 命令
• 如果問(wèn)題持續(xù)，請(qǐng)稍后再試

Q: 網(wǎng)頁(yè)登錄錯(cuò)誤？

A: 嘗試清除本站的 Cookie，然后重新登錄。

注意事項(xiàng)

• 本站在 xuedingmao.com 直接接入官方 Claude Code 轉(zhuǎn)發(fā)服務(wù)
• 僅支持 Claude Code 的 API 流量，不支持其他 API 調(diào)用
• 請(qǐng)妥善保管您的 API 令牌，避免泄露

相關(guān)鏈接

• Claude Code 官方文檔
• Node.js 官方網(wǎng)站

?? 提示：如遇到其他問(wèn)題，請(qǐng)查看官方文檔或聯(lián)系技術(shù)支持。

到此這篇關(guān)于Codex 與 Claude Code 安裝配置完全指南的文章就介紹到這了,更多相關(guān)Codex 與 Claude Code 安裝配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論