Xu Kang Blog

Codex App 客户端使用指南：把 AI 编程助手放进本地工作流

Fri, 19 Jun 2026 00:00:00 GMT

Codex App 不是一个单纯的聊天窗口，而是面向开发工作的桌面客户端。它把项目、终端、Git、浏览器预览、自动化和多线程任务放在同一个工作环境里，让 AI 编程助手更接近一个可以持续协作的本地开发伙伴。

Codex App 是什么？

Codex App 是 OpenAI Codex 的桌面客户端，适合在本地项目里做代码阅读、功能开发、Bug 修复、代码审查、文档整理和上线验证。

和普通网页聊天不同，Codex App 更强调“围绕项目工作”：

可以绑定本地项目目录
可以在项目里读取文件、修改代码、运行命令
可以查看 Git diff、提交、推送和创建 PR
可以通过内置终端验证构建、测试和部署命令
可以使用独立 worktree 并行处理多个任务
可以用内置浏览器检查本地页面和线上页面
可以把长期任务做成自动化或线程唤醒

简单说，它更像一个带 UI 的 AI 开发工作台，而不是只负责回答问题的聊天工具。

适合哪些场景？

我认为 Codex App 最适合这几类工作。

1. 代码库理解

当你接手一个项目，或者隔一段时间回来维护旧项目，可以直接让 Codex 帮你梳理：

这个项目的入口在哪里？
博客文章是怎么生成的？
部署脚本在哪？
当前还有哪些明显的技术债？

它会结合项目文件、终端输出和 Git 状态给出结论，比单纯复制几段代码去问 AI 更高效。

2. 小步迭代开发

Codex App 适合做边改边验证的任务，比如：

新增一篇博客文章
给页面补 SEO meta
调整 Nginx 或部署脚本
修复构建错误
改一个组件并用浏览器检查效果

它可以先读代码，再改文件，再跑 npm run build、pnpm test 或其他验证命令，最后把结果整理给你。

3. 本地和远程运维

如果你给它明确的服务器信息和权限范围，它也可以帮你做一些运维动作，例如：

检查服务是否存活
查看 Nginx 配置
调整 webhook 部署脚本
验证 HTTPS、301 跳转和 sitemap
排查 GitHub webhook 是否触发

这类任务最重要的是不要只听“理论建议”，而是让它实际检查命令输出和线上响应。

4. 多线程并行工作

Codex App 支持不同线程，并且可以使用 Git worktree 隔离改动。比如一个线程修 Bug，另一个线程写文档，第三个线程做页面改版。这样可以减少互相污染，也更容易回滚。

Local、Worktree、Cloud 怎么选？

创建线程时通常会看到不同工作模式。我的理解是：

模式	适合场景	特点
Local	小改动、直接操作当前项目	改动发生在当前目录，最快最直接
Worktree	并行任务、实验性改造	独立 Git worktree，隔离性更好
Cloud	需要远程环境或后台执行	任务在云环境中运行，适合离线并行

日常小任务用 Local 就够。如果你担心影响当前工作区，或者想让 Codex 同时做几条线，优先用 Worktree。

我常用的工作方式

先让它读项目，不要直接改

比较稳的开局是：

先读一下项目结构和部署方式，不要修改文件。告诉我你理解到的入口、构建命令和上线流程。

这样可以避免它一上来就按错误假设动手。

让它实际验证

如果是构建、部署、页面效果这类任务，我会明确要求：

改完以后跑 build，并用浏览器验证页面和控制台错误。

这比只让它“写完代码”可靠很多。

用 Git diff 控制范围

Codex App 里可以看到 diff。每次任务完成后，我都会看它到底改了哪些文件。只要发现无关改动，就让它解释或者拆出去。

复杂任务用 checklist

比如迁移技术栈、改部署链路、上线 HTTPS 这类任务，适合让它维护一个任务列表：

先列 checklist，然后每完成一步更新状态。

这样你可以清楚知道它做到哪一步、卡在哪里。

权限和安全边界

Codex App 能运行命令、读写文件、访问网络，所以权限边界很重要。

我的建议：

不要随便给全盘写权限
删除、重置、覆盖文件前要让它说明影响范围
生产服务器操作前先备份或确认当前服务状态
不要把私钥、Token、Cookie 写进文章或代码仓库
让它做运维时，要求它报告具体命令和结果

AI 开发助手越强，越需要把边界说清楚。好的使用方式不是“完全放手”，而是让它负责执行，你负责判断方向和验收结果。

和 CLI、IDE 插件有什么区别？

如果你喜欢终端，Codex CLI 很直接；如果你主要在编辑器里写代码，IDE 插件更贴近文件编辑；Codex App 则更适合把项目、线程、终端、浏览器、Git 和自动化集中起来管理。

我的使用感受是：

CLI：适合命令行重度用户
IDE 插件：适合围绕当前文件快速改代码
Codex App：适合完整任务流、并行线程、部署检查和可视化协作

它们不是互相替代，而是不同入口。真正重要的是选择最贴合当前任务的界面。

下载地址

我整理了一个 Codex App 客户端下载入口：

点击下载 Codex App 客户端

如果链接失效，可以回到我的博客或联系我更新。

写在最后

Codex App 最有价值的地方，不是“让 AI 帮你写几段代码”，而是把 AI 放进真实开发流程里：读项目、改代码、跑命令、看日志、查页面、提交 Git、处理部署。

当你把任务描述清楚，把权限边界设好，再要求它做真实验证，它就会从一个问答工具变成一个真正能协作的工程助手。

Claude Code 速记表：从入门到精通的完整命令指南

Tue, 31 Mar 2026 00:00:00 GMT

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，可以直接在终端中理解你的代码库、编辑文件、运行命令。本文系统整理了所有命令、快捷键和配置技巧，收藏备用。

安装与更新

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

# 更新到最新版本
claude update

# 检查当前版本
claude --version

安装完成后，在项目目录下运行 claude 即可启动交互式会话。

启动与会话管理

Claude Code 的第一步是掌握如何启动和管理会话。

基础启动命令

命令	说明	适用场景
`claude`	启动交互式 REPL	日常开发，多轮对话
`claude "提示词"`	带初始提示启动会话	快速开始特定任务
`claude -p "提示词"`	单次执行模式（Print Mode）	脚本调用、管道操作
`claude -c`	继续最近一次会话	恢复中断的工作
`claude -r <session-id>`	恢复指定会话	回到特定历史对话

常用启动参数

# 指定模型启动
claude --model claude-sonnet-4

# 单次执行模式，输出 JSON
claude -p "分析这个项目的结构" --output-format json

# 单次执行并输出流式 JSON
claude -p "生成 API 文档" --output-format stream-json

# 使用 JSON Schema 强制结构化输出
claude -p "列出所有 API 端点" --json-schema '{"type":"object","properties":{"endpoints":{"type":"array"}}}'

# 管道操作：将文件内容传给 Claude
cat error.log | claude -p "分析这个错误日志"

# 组合使用：git diff 传给 Claude 审查
git diff | claude -p "请审查这段代码改动"

交互式斜杠命令

在 Claude Code 会话中，输入 / 即可查看所有可用命令。以下是完整列表：

会话控制

命令	别名	说明
`/help`	-	显示所有可用命令
`/clear`	`/reset`, `/new`	清除当前对话历史，开始新对话
`/exit`	`/quit`	退出当前会话
`/compact`	-	压缩对话历史，释放上下文空间
`/context`	-	可视化当前上下文使用情况
`/cost`	-	显示当前会话的 Token 使用量和费用
`/branch <name>`	-	将当前对话分支为新会话

模型与能力

命令	说明
`/model <name>`	切换 AI 模型（如 sonnet, haiku, opus）
`/effort <level>`	调整推理深度：`low`、`medium`、`high`
`/plan [描述]`	进入规划模式（只读探索，不执行操作）

项目与配置

命令	说明
`/init`	初始化项目的 CLAUDE.md 文件
`/memory`	管理 CLAUDE.md 记忆文件
`/permissions`	查看或修改工具权限设置
`/config`	打开配置管理界面
`/status`	检查安装状态、连接和版本信息
`/logout`	登出 Anthropic 账户

工具与集成

命令	说明
`/mcp`	管理 MCP（Model Context Protocol）服务器连接
`/hooks`	查看和管理生命周期钩子
`/agents`	列出已配置的子代理
`/pr-comments`	获取并显示 GitHub PR 评论
`/remote-control`	启用从 claude.ai 的远程控制

快捷键速记表

这些快捷键可以大幅提升你的操作效率：

输入增强

快捷键	功能	说明
`@文件路径`	文件引用	输入 `@` 后自动补全，引导 Claude 关注指定文件
`!命令`	直接执行 Shell	绕过 Claude 直接运行 bash/shell 命令
`Ctrl + V`	粘贴图片	将剪贴板中的图片直接粘贴到终端供分析

操作控制

快捷键	功能	说明
`Esc`	中断	停止当前输出或操作
`Esc + Esc`	回退菜单	撤销最近的更改或对话轮次
`Ctrl + R`	命令搜索	搜索历史命令记录
`Shift + Tab`	切换权限模式	在自动确认/手动确认之间切换
`Ctrl + C`	取消输入	取消当前正在输入的内容

CLAUDE.md — 项目上下文配置

CLAUDE.md 是 Claude Code 中最重要的配置文件之一。它相当于给 AI 的"项目说明书"，帮助 Claude 理解你的项目约定和偏好。

快速初始化

# 在项目根目录自动生成 CLAUDE.md
claude /init

最佳实践

控制长度：保持 50-100 行，最多不超过 300 行
使用导入：用 @path/to/details.md 引用详细文档
负面指令更有效：NEVER use var 比 always use const/let 效果更好
持续迭代：Claude 犯错的地方，就加对应的规范

权限管理系统

Claude Code 有三级权限控制，确保操作安全：

权限类型

权限	行为	适用场景
Allow	自动执行，无需确认	受信任的安全操作
Ask	弹出确认对话框	需要人工审核的操作
Deny	完全禁止	危险操作或受限环境

配置方式

# 在会话中管理权限
/permissions

# 或直接编辑配置文件
# 全局：~/.claude/settings.json
# 项目：.claude/settings.json
# 本地：.claude/settings.local.json（Git 忽略）

settings.json 示例

{
  "permissions": {
    "allow": [
      "Read",
      "Grep",
      "Glob",
      "LS"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(sudo *)"
    ]
  },
  "env": {
    "CLAUDE_MODEL": "claude-sonnet-4"
  }
}

安全提示：Deny 规则优先级最高。在团队项目中，使用项目级 settings.json 统一安全策略。

Hooks — 生命周期钩子

Hooks 允许你在 Claude 执行特定操作前后自动运行脚本，实现自动化工作流。

钩子类型

钩子事件	触发时机	常见用途
`PreToolUse`	工具执行前	拦截危险操作、参数校验
`PostToolUse`	工具执行后	自动格式化、运行 Lint
`Notification`	发送通知时	自定义通知渠道

配置示例

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "npx prettier --write $CLAUDE_FILE_PATH"
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "echo $CLAUDE_TOOL_INPUT | jq -r '.command' | grep -q 'rm -rf' && exit 1 || exit 0"
      }
    ]
  }
}

安全注意事项

Hooks 以当前用户的完整权限运行，没有沙箱
务必对 Claude 的 JSON 输入进行验证和清理
Shell 变量必须加引号防止注入
使用绝对路径，如 $CLAUDE_PROJECT_DIR

MCP 服务器配置

MCP（Model Context Protocol）让 Claude Code 可以连接外部工具和数据源。

添加 MCP 服务器

# 添加到项目级配置
claude mcp add-json my-server '{"command":"npx","args":["-y","@my/mcp-server"]}' --scope project

# 添加到用户级配置
claude mcp add-json my-server '{"command":"npx","args":["-y","@my/mcp-server"]}' --scope user

# 列出已配置的 MCP 服务器
claude mcp list

常用 MCP 服务器推荐

服务器	用途
`@anthropic-ai/mcp-server-filesystem`	文件系统操作
`@anthropic-ai/mcp-server-github`	GitHub API 交互
`@anthropic-ai/mcp-server-postgres`	PostgreSQL 查询
`@anthropic-ai/mcp-server-fetch`	HTTP 请求
`context7`	实时库文档查询

配置文件位置

作用域	路径	说明
User	`~/.claude/mcp.json`	个人常用工具
Project	`.mcp.json`（项目根目录）	团队共享配置

Skills 自定义技能

Skills 允许你创建可复用的指令集，就像给 Claude 定义"技能"。

创建 Skill

<!-- .claude/skills/deploy/SKILL.md -->
---
name: deploy
description: 部署项目到生产环境
---

## 部署步骤

1. 运行测试：`npm run test`
2. 构建项目：`npm run build`
3. 检查构建产物
4. 部署到服务器：`rsync -avz dist/ user@server:/var/www/`
5. 验证部署状态

使用方式

在对话中引用 Skill 文件路径，Claude 会自动读取并执行其中的步骤。

实用工作流示例

1. 代码审查工作流

# 审查最近的提交
git diff HEAD~1 | claude -p "审查这次提交的代码改动，关注安全性和性能问题"

# 审查 PR
claude -p "查看并审查当前分支与 main 的差异"

2. Debug 工作流

# 传入错误日志
cat app.log | claude -p "分析最近的错误，找出根本原因"

# 直接在会话中 Debug
claude "项目运行报错 TypeError: Cannot read property 'map' of undefined，帮我排查"

3. 文档生成工作流

# 生成 API 文档
claude -p "为 src/api/ 目录下的所有接口生成 Markdown 文档"

# 生成 README
claude -p "基于项目结构和 package.json 生成 README.md"

4. 重构工作流

# 启动会话进行重构
claude "我想将 src/utils.js 拆分为多个模块文件，每个功能独立"

# 批量重命名
claude "将项目中所有使用 camelCase 的 CSS 类名改为 kebab-case"

环境变量参考

变量	说明	示例
`ANTHROPIC_API_KEY`	API 密钥	`sk-ant-...`
`CLAUDE_MODEL`	默认模型	`claude-sonnet-4`
`CLAUDE_CODE_USE_BEDROCK`	使用 AWS Bedrock	`1`
`CLAUDE_CODE_USE_VERTEX`	使用 Google Vertex AI	`1`
`CLAUDE_PROJECT_DIR`	当前项目目录（Hooks 中使用）	-
`CLAUDE_FILE_PATH`	当前操作的文件路径（Hooks 中使用）	-

常见问题排查

1. "上下文太长"怎么办？

# 使用 /compact 压缩对话
/compact

# 查看上下文使用情况
/context

# 或直接清除开始新对话
/clear

2. 如何在企业环境中使用？

Claude Code 支持通过 AWS Bedrock 或 Google Vertex AI 访问，无需直接连接 Anthropic API：

# 配置 AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

# 配置 Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5

3. Claude 不遵守我的 CLAUDE.md？

检查文件位置是否在项目根目录
使用 /memory 命令确认是否正确加载
精简内容，超过 300 行效果会下降
用更明确的否定指令（NEVER、DO NOT）

4. 权限经常弹窗确认太烦？

# 在会话中切换到自动模式
Shift + Tab

# 或在 settings.json 中预设 Allow 列表

一图速记

┌─────────────────── Claude Code 速记 ───────────────────┐
│                                                         │
│  启动      claude / claude "任务" / claude -p "查询"      │
│  继续      claude -c（最近）/ claude -r <id>（指定）       │
│                                                         │
│  会话      /clear  /compact  /cost  /context  /exit      │
│  模型      /model  /effort  /plan                        │
│  配置      /init  /memory  /permissions  /config         │
│  工具      /mcp  /hooks  /agents  /pr-comments           │
│                                                         │
│  快捷键    @文件  !命令  Esc中断  Esc×2回退               │
│           Ctrl+R搜索  Ctrl+V图片  Shift+Tab权限          │
│                                                         │
│  配置文件  CLAUDE.md       → 项目上下文/规范              │
│           settings.json   → 权限和环境配置               │
│           .mcp.json       → MCP 服务器配置               │
│           hooks/          → 生命周期自动化               │
│           skills/         → 自定义技能指令               │
│                                                         │
└─────────────────────────────────────────────────────────┘

总结

Claude Code 不只是一个"AI 聊天框"，它是一个完整的开发环境增强工具。掌握以上命令和配置后，你可以：

提升效率：用斜杠命令快速控制会话
保障安全：通过权限系统和 Hooks 防护危险操作
团队协作：用 CLAUDE.md 和项目配置统一开发规范
无限拓展：通过 MCP 和 Skills 连接任何外部工具

建议把本文收藏为书签，在日常使用中随时查阅。也可以打印出来贴在显示器旁边 📌

提示：Claude Code 更新频率很高，建议定期运行 claude update 保持最新版本，使用 /help 查看最新命令列表。

Golang 交叉编译完全指南：一次编写，多平台运行

Tue, 31 Mar 2026 00:00:00 GMT

Go 语言天生支持交叉编译，只需设置几个环境变量，就能在一台机器上构建出多个平台的可执行文件。本文将系统梳理交叉编译的完整用法，包括常见场景、参数详解和实战技巧。

什么是交叉编译？

交叉编译（Cross Compilation）是指在一个平台上编译生成另一个平台的可执行程序。例如：

在 macOS 上编译出 Linux 服务器可运行的二进制文件
在 Windows 开发机上编译出 Linux Docker 容器可运行的程序
在 Linux CI/CD 环境中同时构建 macOS 和 Windows 的发行版

Go 语言的编译器原生支持交叉编译，不需要安装任何第三方工具，这是 Go 相比许多其他语言的巨大优势。

核心环境变量

交叉编译的关键在于三个环境变量：

变量	说明	常用值
`CGO_ENABLED`	是否启用 CGO	`0`（禁用，交叉编译时必须）
`GOOS`	目标操作系统	`linux`, `darwin`, `windows`
`GOARCH`	目标 CPU 架构	`amd64`, `arm64`, `386`

CGO_ENABLED 为什么要设为 0？

交叉编译时必须禁用 CGO（CGO_ENABLED=0），因为 CGO 需要目标平台的 C 编译器和链接库，而这些在当前平台上通常不可用。禁用 CGO 后，Go 会使用纯 Go 实现的标准库，确保编译产物的可移植性。

GOOS 平台对照表

GOOS 值	对应平台
`linux`	Linux
`darwin`	macOS
`windows`	Windows
`freebsd`	FreeBSD
`android`	Android
`ios`	iOS

GOARCH 架构对照表

GOARCH 值	说明	典型设备
`amd64`	64 位 x86	大多数 PC 和服务器
`386`	32 位 x86	老旧 PC
`arm64`	64 位 ARM	Apple M 系列、树莓派 4、AWS Graviton
`arm`	32 位 ARM	树莓派 3、嵌入式设备

各平台交叉编译命令

在 macOS 上编译

# 编译 Linux amd64 版本（最常见：部署到服务器）
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp-linux main.go

# 编译 Linux arm64 版本（部署到 ARM 服务器，如 AWS Graviton）
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o myapp-linux-arm64 main.go

# 编译 Windows 版本
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go

在 Linux 上编译

# 编译 macOS 版本（Intel Mac）
CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o myapp-darwin main.go

# 编译 macOS 版本（Apple Silicon M1/M2/M3/M4）
CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o myapp-darwin-arm64 main.go

# 编译 Windows 版本
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go

在 Windows 上编译

Windows 的 CMD 和 PowerShell 设置环境变量的方式不同：

CMD（命令提示符）：

SET CGO_ENABLED=0
SET GOOS=linux
SET GOARCH=amd64
go build -o myapp main.go

PowerShell：

$env:CGO_ENABLED="0"
$env:GOOS="linux"
$env:GOARCH="amd64"
go build -o myapp main.go

PowerShell 一行写法：

$env:CGO_ENABLED="0"; $env:GOOS="linux"; $env:GOARCH="amd64"; go build -o myapp main.go

实战：一键构建多平台版本

在项目根目录创建一个构建脚本，一次性编译所有平台的版本：

build.sh（macOS / Linux）

#!/bin/bash
APP_NAME="myapp"
VERSION="1.0.0"
BUILD_DIR="build"

# 清理
rm -rf $BUILD_DIR
mkdir -p $BUILD_DIR

# 定义目标平台
PLATFORMS=(
    "linux/amd64"
    "linux/arm64"
    "darwin/amd64"
    "darwin/arm64"
    "windows/amd64"
)

for PLATFORM in "${PLATFORMS[@]}"; do
    GOOS=${PLATFORM%/*}
    GOARCH=${PLATFORM#*/}
    OUTPUT="$BUILD_DIR/${APP_NAME}-${GOOS}-${GOARCH}"

    # Windows 需要 .exe 后缀
    if [ "$GOOS" = "windows" ]; then
        OUTPUT="${OUTPUT}.exe"
    fi

    echo "Building $OUTPUT..."
    CGO_ENABLED=0 GOOS=$GOOS GOARCH=$GOARCH go build \
        -ldflags="-s -w -X main.Version=$VERSION" \
        -o $OUTPUT main.go
done

echo "✅ Build complete!"
ls -lh $BUILD_DIR/

编译参数说明

上面脚本中使用的 -ldflags 参数也值得了解：

参数	说明
`-s`	去掉符号表，减小体积
`-w`	去掉 DWARF 调试信息，进一步减小体积
`-X main.Version=$VERSION`	编译时注入版本号变量

使用 -ldflags="-s -w" 通常可以减少 20%-30% 的二进制体积。

查看支持的平台列表

想知道 Go 支持编译哪些平台？运行：

go tool dist list

输出会列出所有支持的 GOOS/GOARCH 组合，截至 Go 1.22+，已支持超过 40 种组合。

常见问题

1. 编译报错：`xxx requires cgo`

某些包（如 github.com/mattn/go-sqlite3）依赖 CGO，无法直接交叉编译。解决方案：

寻找纯 Go 替代库（如用 modernc.org/sqlite 替代 go-sqlite3）
使用 Docker 进行交叉编译
安装目标平台的交叉编译工具链

2. 编译出的文件无法执行

检查文件权限（Linux/macOS 需要添加执行权限）：

chmod +x myapp-linux

3. Windows 编译的文件没有 .exe 后缀

当 GOOS=windows 时，Go 会自动添加 .exe 后缀，但如果你用 -o 手动指定了输出文件名，需要自己加上 .exe。

在 CI/CD 中的应用

在 GitHub Actions 中利用交叉编译自动构建多平台发行版：

# .github/workflows/release.yml
name: Release
on:
  push:
    tags: ['v*']

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        include:
          - goos: linux
            goarch: amd64
          - goos: linux
            goarch: arm64
          - goos: darwin
            goarch: amd64
          - goos: darwin
            goarch: arm64
          - goos: windows
            goarch: amd64
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-go@v5
        with:
          go-version: '1.22'
      - name: Build
        env:
          CGO_ENABLED: 0
          GOOS: ${{ matrix.goos }}
          GOARCH: ${{ matrix.goarch }}
        run: |
          EXT=""
          if [ "$GOOS" = "windows" ]; then EXT=".exe"; fi
          go build -ldflags="-s -w" -o myapp-$GOOS-$GOARCH$EXT main.go
      - uses: softprops/action-gh-release@v1
        with:
          files: myapp-*

总结

场景	命令
Mac → Linux 服务器	`CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build`
Mac → Windows	`CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build`
Linux → Mac (M芯片)	`CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build`
Win → Linux	`$env:CGO_ENABLED="0"; $env:GOOS="linux"; $env:GOARCH="amd64"; go build`

Go 的交叉编译是其工具链中最实用的特性之一。掌握了这几个环境变量，你就能轻松实现"一次编写，到处运行"——而且不需要 JVM 😄

Hello World - 我的第一篇博客

Tue, 31 Mar 2026 00:00:00 GMT

万事开头难，但最重要的是迈出第一步。

为什么要写博客？

作为一名全栈开发工程师，我一直相信「输出是最好的学习方式」。通过写博客，我可以：

系统化知识：将碎片化的经验整理成完整的知识体系
回顾与反思：记录踩过的坑，避免重复犯错
分享与交流：与社区中的开发者们互相学习

技术选型

这个博客系统采用了极简的技术方案：

Blog System
├── Markdown       # 文章编写格式
├── marked.js      # Markdown 渲染引擎
├── Vanilla JS     # 零依赖前端逻辑
└── GitHub Pages   # 静态托管

为什么选择纯静态方案？

零服务器成本 — 完全托管在 GitHub Pages 上
极快的加载速度 — 没有服务端渲染延迟
Markdown 友好 — 专注于内容创作
AI 友好 — Claude Code 可以直接写 Markdown 并发布

未来的计划

接下来我会在这里分享：

💻 技术教程 — Web 开发、云原生、AI 应用
🛠 项目实战 — 真实项目的架构设计与踩坑记录
🤔 技术思考 — 对行业趋势和技术选型的思考
📚 学习笔记 — 阅读和学习的心得体会

写在最后

感谢你来到这里！如果你对我的文章感兴趣，欢迎关注我的 GitHub，也可以通过邮件与我交流。

让我们一起在技术的海洋里探索吧 🚀

发布于 2026年3月31日

Xu Kang Blog

Codex App 客户端使用指南：把 AI 编程助手放进本地工作流

Codex App 是什么？

适合哪些场景？

1. 代码库理解

2. 小步迭代开发

3. 本地和远程运维

4. 多线程并行工作

Local、Worktree、Cloud 怎么选？

我常用的工作方式

先让它读项目，不要直接改

让它实际验证

用 Git diff 控制范围

复杂任务用 checklist

权限和安全边界

和 CLI、IDE 插件有什么区别？

下载地址

写在最后

Claude Code 速记表：从入门到精通的完整命令指南

安装与更新

启动与会话管理

基础启动命令

常用启动参数

交互式斜杠命令

会话控制

模型与能力

项目与配置

工具与集成

快捷键速记表

输入增强

操作控制

CLAUDE.md — 项目上下文配置

快速初始化

推荐内容结构

最佳实践

权限管理系统

权限类型

配置方式

settings.json 示例

Hooks — 生命周期钩子

钩子类型

配置示例

安全注意事项

MCP 服务器配置

添加 MCP 服务器

常用 MCP 服务器推荐

配置文件位置

Skills 自定义技能

创建 Skill

使用方式

实用工作流示例

1. 代码审查工作流

2. Debug 工作流

3. 文档生成工作流

4. 重构工作流

环境变量参考

常见问题排查

1. "上下文太长"怎么办？

2. 如何在企业环境中使用？

3. Claude 不遵守我的 CLAUDE.md？

4. 权限经常弹窗确认太烦？

一图速记

总结

Golang 交叉编译完全指南：一次编写，多平台运行

什么是交叉编译？

核心环境变量

CGO_ENABLED 为什么要设为 0？

GOOS 平台对照表

GOARCH 架构对照表

各平台交叉编译命令

在 macOS 上编译

在 Linux 上编译

在 Windows 上编译

实战：一键构建多平台版本

build.sh（macOS / Linux）

编译参数说明

查看支持的平台列表

常见问题

1. 编译报错：xxx requires cgo

2. 编译出的文件无法执行

1. 编译报错：`xxx requires cgo`