Linux/macOS 系統配置

本文說明在 Linux 和 macOS 中配置 Claude Code 第三方 API 環境變數的常用方式。請將示例中的 sk-xxxx-uocode 替換為你在 UoCode 令牌管理中建立的 API Key。

方案一：Shell 配置文件（永久設定）

Bash（Linux 和舊版 macOS）

編輯 ~/.bashrc 文件：

nano ~/.bashrc

也可以使用你習慣的編輯器，例如：

vim ~/.bashrc

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

# Claude Code 第三方 API 配置
export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

保存後執行：

source ~/.bashrc

驗證是否生效：

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

Zsh（macOS Catalina+ 預設）

編輯 ~/.zshrc 文件：

nano ~/.zshrc

在文件末尾添加：

# Claude Code 第三方 API 配置
export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

保存後執行：

source ~/.zshrc

Fish Shell

編輯 ~/.config/fish/config.fish 文件：

nano ~/.config/fish/config.fish

在文件末尾添加：

# Claude Code 第三方 API 配置
set -gx ANTHROPIC_AUTH_TOKEN "sk-xxxx-uocode"
set -gx ANTHROPIC_BASE_URL "https://www.uocode.com"
set -gx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC "1"

保存後重啟 Fish Shell。

方案二：臨時設定（當前終端會話）

如果只想在當前終端會話中使用，可以臨時設定環境變數：

export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

# 驗證
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

# 啟動 Claude Code
claude

關閉終端後，這些變數會失效。

方案三：項目級配置（.env 文件 + 啟動腳本）

步驟 1：在項目根目錄建立 .env 文件

cd your-awesome-project

cat > .env << 'EOF'
ANTHROPIC_AUTH_TOKEN=sk-xxxx-uocode
ANTHROPIC_BASE_URL=https://www.uocode.com
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF

步驟 2：建立啟動腳本 run-claude.sh

cat > run-claude.sh << 'EOF'
#!/bin/bash

# 加載 .env 文件中的環境變數
if [ -f .env ]; then
  echo "加載環境變數..."
  export $(cat .env | xargs)
  echo "環境變數已加載"
else
  echo "警告: 未找到 .env 文件"
fi

# 驗證環境變數
echo "當前配置:"
echo "ANTHROPIC_AUTH_TOKEN: $ANTHROPIC_AUTH_TOKEN"
echo "ANTHROPIC_BASE_URL: $ANTHROPIC_BASE_URL"

# 啟動 Claude Code
echo "啟動 Claude Code..."
claude
EOF

步驟 3：添加執行權限

chmod +x run-claude.sh

步驟 4：運行腳本

./run-claude.sh

步驟 5（可選）：建立系統級快捷方式

# 建立軟連結到用戶 bin 目錄
ln -s $(pwd)/run-claude.sh ~/bin/my-claude

# 驗證
which my-claude

# 之後可以在任何地方使用
my-claude

編輯 settings.json（推薦，更直觀）

如果你是在 VS Code、Cursor 或其他相容編輯器中使用 Claude Code，可以直接在 settings.json 裡配置環境變數，不必修改 Shell 啟動文件。

打開編輯器的 settings JSON 文件，新增或更新以下配置：

{
  "claudeCode.allowDangerouslySkipPermissions": true,
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-xxxx-uocode"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://www.uocode.com"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    }
  ],
  "claudeCode.preferredLocation": "panel",
  "claudeCode.initialPermissionMode": "bypassPermissions",
  "claudeCode.selectedModel": "claude-haiku-4-5-20251001"
}

保存後，重啟編輯器並重新打開 Claude Code。

命令行 CLI 使用

如果你直接在終端使用 Claude Code，可以先設定環境變數，再啟動 claude：

export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

claude

也可以在啟動時指定模型：

ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode" ANTHROPIC_BASE_URL="https://www.uocode.com" CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1" claude -m claude-haiku-4-5-20251001

驗證 CLI 是否安裝正常：

claude --version
claude doctor

快速開始

如果使用 Bash，可以直接執行：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://www.uocode.com"' >> ~/.bashrc
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"' >> ~/.bashrc
source ~/.bashrc
claude

如果使用 Zsh，請把 ~/.bashrc 換成 ~/.zshrc。