ZEVORN.blog

January 5, 2026

基于 codex 搭建本地 AI 工作流

article2.4 min to read

codex 国内使用可以选择中转站,这里推荐:https://codex.packycode.com/

购买套餐获取 key,以后,使用下面脚本来一键安装,需要将 "sk-tC8cF...jyi" 替换成真正的 key:

#!/bin/bash
# Codex Setup Script

# 1. Create .codex directory
mkdir -p ~/.codex

# 2. Create config.toml
cat > ~/.codex/config.toml << 'EOF'
model_provider = "packycode"
model = "gpt-5" #可更改为model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.packycode]
name = "packycode"
base_url = "https://codex-api.packycode.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

# 3. Create auth.json
cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "sk-tC8cF...jyi"
}
EOF

# 4. Start Codex
echo "Setup complete! You can now run 'codex' to start."
codex

安装一些常用的 mcp,命令如下:

# 创建全局 npm 目录
mkdir -p ~/.npm-global

# 配置 npm 使用该目录
npm config set prefix '~/.npm-global'

# 将该目录添加到 PATH(添加到 ~/.bashrc 或 ~/.zshrc)
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 现在可以无 sudo 安装全局包
npm install -g @modelcontextprotocol/server-sequential-thinking @modelcontextprotocol/server-memory @mook_wy/mook-task-manager @tosin2013/mcp-shrimp-task-manager

然后在 ~/.codex/config.toml 里面配置 mcp,其中 exa 需要在官网 https://docs.exa.ai/reference/exa-mcp 注册以后获取 key,替换 YOUR_KEY_VALUE:

[mcp_servers.sequential-thinking]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-sequential-thinking"]
startup_timeout_sec = 60000

[mcp_servers.exa]
command = "npx"
args = ["-y", "exa-mcp-server", "tools=web_search_exa,get_code_context_exa,crawling_exa,company_research_exa,linkedin_search_exa,deep_researcher_start,deep_researcher_check"]
env = { "EXA_API_KEY" = "YOUR_KEY_VALUE" }
startup_timeout_sec = 60000

[mcp_servers.shrimp-task-manager]
command = "npx"
args = ["-y", "@mook_wy/mook-task-manager@latest"]
env = {"DATA_DIR" = ".shrimp", "TEMPLATES_USE" = "zh", "ENABLE_GUI" = "false"}
startup_timeout_sec = 60000

[mcp_servers.memory]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-memory"]
startup_timeout_sec = 60000

然后设置一个好用的 ~/.codex/AGENTS.md

【全局 AGENTS 约束(简要)】

本指南适用于仓库全部目录,除非子目录另有 AGENTS.md 覆盖。
所有沟通全部使用中文、所有的代码注释、文档全部使用英文(并且只写关键部分的注释),新文件使用 UTF-8(无 BOM)。
禁用一切 CI/CD 自动化;构建、测试、发布必须人工操作。
编码前必须先使用 Sequential-Thinking 进行分析,然后使用 shrimp-task-manager 规划工作流程,并保持最小变更边界。
默认采取破坏性改动并拒绝向后兼容,主动清理过时代码、接口、文档;如无迁移需求需说明“无迁移,直接替换”。
回复格式必须:
在开头提供【前置说明】(简要说明:本次任务、假设、是否调用工具等)。
若有工具/MCP/外部调用,在结尾提供【工具调用简报】(列出用过哪些工具、用途和结论)。
缩进根据当前文件编码风格决定使用 1 tab 还是用 4 个空格,默认使用 4 个空格。